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.
|
|
|
|
|---|---|---|
|
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. |
|
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 :
-
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_kcalsde l’aliment de base ne provient ni depercentage_kcalsde la Production végétale de cette culture, ni depercentage_kcalsde 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. -
Autres aliments de base –
percentage_kcals×percentage_allocation_to_basket -
Dépenses non alimentaires de survie –
expenditure×percentage_allocation_to_basket, converti en kcal à l’aide deannual_kcals_cost -
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 |
|---|---|
|
|
Utilisez un code de Zone de moyens d’existence, comme ML12. |
|
|
Utilisez un code de Ligne de base, comme 1233. |
|
|
Utilisez un nom, un alias ou un code de produit, comme R01122. |
|
|
|
|
|
|
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 |
|---|---|
|
|
Identifie l’origine de l’affectation de la composante du seuil. Si une composante a été héritée ( Ces champs ne sont renvoyés que par le point de terminaison |
|
|
Renvoie Ce champ n’est renvoyé que par le point de terminaison |
|
|
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. |
|
|
Pourcentage de 2 100 kcal par personne et par jour pour l’Activité de moyens d’existence de référence |
|
|
Dépenses totales pour l’Activité de moyens d’existence de référence, en monnaie locale |
|
|
Part des totaux affectée au panier, p. ex. |
|
|
Part des totaux affectée au panier, p. ex. |
|
|
Dépenses affectées, converties en kcal à l’aide de |
|
|
Contribution au Seuil, en pourcentage de 2 100 kcal/personne/jour. Elle est égale, pour chaque panier, à :
|
Autres champs :
-
id(Le champlivelihood_product_categoryde chaque composante du seuil est l’idde 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