Livelihoods Explorer
English Spanish French
English Spanish French

LivelihoodProductCategory et ThresholdComponent

Les Seuils de survie et de protection des moyens d’existence d’une Ligne de base sont établis à partir de l’affectation des achats alimentaires et non alimentaires des Groupes de richesse aux quatre paniers (aliment de base, autres aliments de base, dépenses non alimentaires de survie et protection des moyens d’existence).

En savoir plus sur les Seuils et les paniers.

L’API fournit les informations sur les Seuils et les paniers au moyen de deux points de terminaison liés, mais distincts, qui reposent sur les catégories de produits de moyens d’existence (Livelihood Product Categories).

Une catégorie de produits de moyens d’existence est un enregistrement qui décrit comment un groupe de personnes précis achète et utilise un article donné pour couvrir ses besoins essentiels.

Au lieu de considérer seulement le total des dépenses ou de la consommation, elle indique :

  • Le produit ou le service : ce qui est acheté (p. ex. grains de maïs, médicaments, frais de scolarité ou outils agricoles).

  • L’activité de référence : le montant dépensé ou l’énergie alimentaire (en calories) fournie, en pourcentage de 2 100 kcal par personne et par jour.

  • Le panier : la place de cet achat dans les besoins du ménage, selon qu’il sert à l’aliment de base, à d’autres aliments essentiels à la survie, aux besoins non alimentaires de survie (comme le combustible de cuisson ou le savon) ou à la protection des moyens d’existence à long terme (comme l’alimentation du bétail ou les engrais).

  • L’affectation : la part des dépenses annuelles de l’Année de référence pour cet article qui est incluse dans le panier. Par exemple, l’achat (OtherPurchase) de pétrole lampant peut être affecté à 75 % au panier des achats non alimentaires de survie, car seuls 75 % du pétrole lampant utilisé pendant l’Année de référence seraient indispensables à la survie. Comme le LEX n’enregistre qu’une catégorie par produit, les 25 % restants relèvent implicitement d’un panier « autre » de dépenses non essentielles, rattaché ni au Seuil de survie ni au Seuil de protection des moyens d’existence, et ne sont pas renvoyés par ces points de terminaison.

Les deux points de terminaison qui utilisent les catégories de produits de moyens d’existence sont livelihoodproductcategory et thresholdcomponent.


livelihoodproductcategory

thresholdcomponent

Résumé

Une liste concise des articles inclus dans les paniers. Les articles identiques d’un Groupe de richesse à l’autre dans une Ligne de base ne sont pas répétés. Cela correspond aux données saisies dans la Ligne de base.

Une vue complète des articles qui composent les Seuils de chaque Groupe de richesse.

Utilisation

Vérifier (et corriger) les affectations saisies pour la Ligne de base

Expliquer le Seuil de chaque Groupe de richesse ou en faire un graphique

Renvoie une ligne de résultats par

Renvoie une ligne de résultats par catégorie de produits de moyens d’existence. Les articles des paniers 1 à 3 sont renvoyés pour le Groupe de richesse Pauvres uniquement. Les articles du panier 4 sont renvoyés pour chaque Groupe de richesse qui a sa propre affectation.

Renvoie une ligne de résultats par catégorie de produits de moyens d’existence pour chaque Groupe de richesse au Seuil duquel elle contribue, y compris les Groupes de richesse qui n’ont aucune catégorie de produits de moyens d’existence propre. is_inherited et source_wealth_group_category indiquent de quel Groupe de richesse provient chaque ligne.

Modifiable

Oui

Non, lecture seule

Exemple

Cette URL affiche la liste des catégories de produits de moyens d’existence de la Ligne de base 1233.

https://livelihoods.fews.net/api/livelihoodproductcategory.json?livelihood_zone_baseline=1233

Cette URL affiche la liste complète du contenu des paniers pour tous les Groupes de richesse de la Ligne de base 1223.

https://livelihoods.fews.net/api/thresholdcomponent.json?livelihood_zone_baseline=1233

Catégorie de produits de moyens d’existence

Le point de terminaison livelihoodproductcategory renvoie les catégories de produits de moyens d’existence enregistrées pour la Ligne de base.

Les catégories de produits de moyens d’existence ne sont enregistrées que lorsque le BSS contient une affectation :

  • Les paniers 1, 2 et 3 ne sont enregistrés que pour le Groupe de richesse Pauvres.

  • Le panier 4 n’est enregistré que pour les Groupes de richesse qui ont leurs propres affectations de protection des moyens d’existence.

  • Un Groupe de richesse peut n’avoir aucune catégorie de produits de moyens d’existence.

Chaque ligne contient la valeur saisie dans le BSS, ainsi que les montants de l’Activité de moyens d’existence de référence et la contribution calculée au panier.

Composante du seuil

Le point de terminaison thresholdcomponent applique des règles d’héritage aux catégories de produits de moyens d’existence pour produire la liste complète des articles du Seuil de chaque Groupe de richesse.

Composition du panier de protection des moyens d’existence

Le Seuil de protection des moyens d’existence de chaque Groupe de richesse est établi à partir des quatre paniers définis par les catégories de produits de moyens d’existence de la Ligne de base.

Les paniers 1, 2 et 3 constituent le Seuil de survie et sont définis pour le Groupe de richesse Pauvres. Tous les Groupes de richesse héritent de ces paniers du Groupe de richesse Pauvres.

Le panier 4 peut être défini séparément pour chaque Groupe de richesse. Chaque Groupe de richesse a ses propres catégories de produits de moyens d’existence pour le panier 4. Si un Groupe de richesse n’a pas sa propre affectation pour une Stratégie de moyens d’existence du panier 4, il hérite de la catégorie de produits correspondante du Groupe de richesse Pauvres. Une même catégorie de produits de moyens d’existence peut donc apparaître comme composante du Seuil de plusieurs Groupes de richesse.

Le point de terminaison thresholdcomponent renvoie chaque composante ; son champ basket_percentage_kcals correspond à la contribution de la composante, en pourcentage de 2 100 kcal/personne/jour. Les contributions à chaque panier se calculent comme suit :

  1. Aliment de base – le reste des 100 % de kcal requises après le panier 2 (autres aliments de base). Notez que la valeur basket_percentage_kcals de l’aliment de base ne provient ni de percentage_kcals de la Production végétale de cette culture, ni de percentage_kcals de l’Achat de nourriture de cette culture. Les Seuils supposent que les ménages achèteront l’aliment de base principal pour atteindre 100 % des kcal requises après avoir consommé les kcal du panier Autres aliments de base.

  2. Autres aliments de base – percentage_kcals × percentage_allocation_to_basket

  3. Dépenses non alimentaires de survie – expenditure × percentage_allocation_to_basket, converti en kcal à l’aide de annual_kcals_cost

  4. Protection des moyens d’existence – expenditure × percentage_allocation_to_basket, converti en kcal. Conformément aux calculs utilisés dans les Lignes de base, le pourcentage de kcal fourni par le produit est retiré.

Le point de terminaison renvoie une ligne pour chaque Groupe de richesse auquel contribue chaque catégorie de produits de moyens d’existence ; un seul appel à l’API renvoie donc toutes les composantes de tous les Groupes de richesse de la Ligne de base.

Filtres

Voici quelques filtres utiles pour ces points de terminaison :

Filtre

Valeurs acceptées

livelihood_zone

Utilisez un code de Zone de moyens d’existence, comme ML12.

livelihood_zone_baseline

Utilisez un code de Ligne de base, comme 1233.

product

Utilisez un nom, un alias ou un code de produit, comme R01122.

basket

1 (Aliment de base)

2 (Autres aliments de base)

3 (Dépenses non alimentaires de survie)

4 (Protection des moyens d’existence)

basket=1&basket=2&basket=3 renvoie uniquement les composantes du Seuil de survie

strategy_type

FoodPurchase renvoie les articles alimentaires des paniers 1, 2 et 4.

OtherPurchase renvoie les articles non alimentaires des paniers 3 et 4.

Exemple

Obtenir la liste des Lignes de base de zone de moyens d’existence dont l’aliment de base est le maïs en grains (panier 1) :

https://livelihoods.fews.net/api/livelihoodproductcategory.html?product=R01122&basket=1

Champs

Pour choisir les champs à afficher, utilisez le paramètre fields de la manière habituelle.

Voici les principaux champs de ces points de terminaison :

Nom du champ

Définition

source_wealth_group, source_wealth_group_category, source_wealth_group_category_name et source_wealth_group_category_short_name

Identifie l’origine de l’affectation de la composante du seuil. Si une composante a été héritée (is_inherited = True), ce champ est égal à Poor. Sinon, il est égal au Groupe de richesse représenté par la ligne.

Ces champs ne sont renvoyés que par le point de terminaison thresholdcomponent.

is_inherited

Renvoie True si la composante du seuil a été héritée du Groupe de richesse Pauvres.

Ce champ n’est renvoyé que par le point de terminaison thresholdcomponent.

percentage_allocation_to_
basket

Part de l’activité affectée au panier, telle que saisie dans le BSS. Pour chaque produit du panier 4, ce point de terminaison indique quels Groupes de richesse ont leur propre affectation. Une cellule vide signifie que le Groupe de richesse n’a pas sa propre catégorie de produits de moyens d’existence pour ce produit : le Seuil de ce Groupe de richesse utilise donc l’affectation du Groupe de richesse Pauvres.

activity_percentage_kcals

Pourcentage de 2 100 kcal par personne et par jour pour l’Activité de moyens d’existence de référence

activity_expenditure

Dépenses totales pour l’Activité de moyens d’existence de référence, en monnaie locale

allocated_percentage_kcals

Part des totaux affectée au panier, p. ex. percentage_allocation_to_basket × activity_percentage_kcals

allocated_expenditure

Part des totaux affectée au panier, p. ex. percentage_allocation_to_basket × activity_expenditure

allocated_expenditure_as_
percentage_kcals

Dépenses affectées, converties en kcal à l’aide de annual_kcals_cost

basket_percentage_kcals

Contribution au Seuil, en pourcentage de 2 100 kcal/personne/jour. Elle est égale, pour chaque panier, à :

  • Panier 1 : 2100 - somme de allocated_percentage_kcals pour toutes les Activités de moyens d’existence du panier 2.

  • Panier 2 : allocated_percentage_kcals

  • Panier 3 : allocated_expenditure_as_percentage_kcals

  • Panier 4 : allocated_expenditure_as_percentage_kcals - allocated_percentage_kcals

Autres champs :

  • id (Le champ livelihood_product_category de chaque composante du seuil est l’id de la catégorie de produits de moyens d’existence.)

  • livelihood_product_category

  • source_organization

  • source_organization_name

  • baseline_livelihood_activity

  • livelihood_zone

  • livelihood_zone_baseline

  • livelihood_zone_baseline_label

  • livelihood_zone_name

  • livelihood_zone_country

  • livelihood_zone_country_name

  • wealth_group

  • wealth_group_category

  • wealth_group_category_name

  • wealth_group_category_short_name

  • basline_livelihood_activity

  • baseline_strategy

  • strategy_type

  • basket

  • basket_name

  • product

  • product_common_name

  • product_description

  • season

  • season_name

  • additional_identifier

  • livelihood_strategy