Livelihoods Explorer
English Spanish French
English Spanish French

LivelihoodActivitySummary

Le point de terminaison LivelihoodActivitySummary permet de filtrer les Zones de moyens d’existence selon la contribution des activités de moyens d’existence au revenu total d’un groupe de richesse.

Exemple

Cette URL affiche la liste des Activités de moyens d’existence des Groupes de richesse pour lesquels la production de sorgho fournit au moins 20 % des calories.

http://livelihoods.fews.net/api/livelihoodactivitysummary/?language=en&slice_by_product=R0114&slice_by_strategy_type=CropProduction&min_kcals_consumed_percent=20

Filtres

Ce point de terminaison utilise deux catégories de filtres.

  • Filtres standard : ils filtrent les Lignes de base renvoyées. Les paramètres de
    filtre standard déterminent les Activités de moyens d’existence incluses dans les données à agréger.

  • Filtres de tranche : à eux seuls, ils ne retirent pas de Lignes de base des résultats ; ils filtrent seulement les statistiques. Les paramètres de tranche servent à calculer la part du revenu global, des dépenses, de kcals_consumed et de percentage_kcals qui provient de la tranche.

Chaque ligne de résultats contient le montant total de chaque indicateur (income, expenditure, kcals_consumed, percentage_kcals), le montant apporté par la tranche et le pourcentage du total apporté par la tranche.

Comme les résultats sont agrégés sur les champs demandés, il est très facile de compter les valeurs en double. Il est important de bien comprendre quelles données sont agrégées et de vérifier que les filtres appropriés sont appliqués. Par exemple, si une Ligne de base contient des données à la fois pour le scénario de référence et pour le scénario de réponse, et que vous ne précisez pas de filtre de scénario, les valeurs des indicateurs correspondront à la somme des deux scénarios.

Filtres standard

Plusieurs filtres standard sont disponibles pour ce point de terminaison.

Afficher la liste des filtres standard et de leurs valeurs acceptées.

Filtre

Valeurs acceptées

country

Utilisez le nom complet du pays (en anglais), comme Mali.

livelihood_zone

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

scenario

Baseline

Response

wealth_group_category

B/O (aisés)

M (moyens)

M-L (moyens inférieurs)

M-U (moyens supérieurs)

P (pauvres)

P-F (pauvres, ménages dirigés par une femme)

P-IDP (pauvres, personnes déplacées internes)

VP (très pauvres)

VP-IDP (très pauvres, personnes déplacées internes)

strategy_type

MilkProduction

ButterProduction

MeatProduction

LivestockSale

CropProduction

FoodPurchase

PaymentInKind

ReliefGiftOther

Hunting

Fishing

WildFoodGathering

OtherCashIncome

OtherPurchase

product

Utilisez un code de produit, comme R01122.

quantity_produced

Nombre décimal (valeur numérique pouvant comporter une virgule)

quantity_sold (quantité vendue et/ou échangée)

Nombre décimal

quantity_other_uses

Nombre décimal

quantity_consumed

Nombre décimal

price

Nombre décimal

income

Nombre décimal

expenditure

Nombre décimal

kcals_consumed

Nombre entier

percentage_kcals (pourcentage des kcal requises)

Nombre décimal

Filtres de tranche

Les paramètres de tranche sont les suivants :

  • slice_by_product : correspond à tout code CPC qui commence par la valeur indiquée. Pour en indiquer plusieurs, répétez le paramètre, p. ex. slice_by_product=R0&slice_by_product=B01. La hiérarchie des produits est disponible via le point de terminaison des produits classés, /api/classifiedproduct/.

  • slice_by_strategy_type : vous pouvez en indiquer plusieurs. Utilisez les codes strategy_type indiqués ci-dessus. Ils ne tiennent pas compte de la casse, mais doivent sinon correspondre exactement.

Pour le moment, l’API ne prend en charge qu’une seule tranche à la fois et crée une tranche unique en combinant tous les paramètres de tranche. Si le produit et le type de stratégie sont tous deux indiqués, la tranche sélectionne les Activités de moyens d’existence qui correspondent aux deux. Si vous indiquez un slice_by_product pour un produit sans rapport avec le slice_by_strategy_type sélectionné, aucune activité n’est sélectionnée et les valeurs de la tranche sont nulles.

Les agrégats produits sont les suivants :

  • income_sum_row

  • expenditure_sum_row

  • kcals_consumed_sum_row

  • percentage_kcals_sum_row

  • total_income_as_percentage_kcals_row

Si une tranche est indiquée, les agrégats supplémentaires suivants sont produits :

  • income_sum_slice

  • income_sum_slice_percentage_of_row

  • expenditure_sum_slice

  • expenditure_sum_slice_percentage_of_row

  • kcals_consumed_sum_slice

  • kcals_consumed_sum_slice_percentage_of_row

  • percentage_kcals_sum_slice

  • percentage_kcals_sum_slice_percentage_of_row

  • total_income_as_percentage_kcals_slice

  • total_income_as_percentage_kcals_slice_percentage_of_row

Notez que le revenu total correspond au revenu en kcal plus le revenu en espèces.

Vous pouvez filtrer sur n’importe quel agrégat calculé de tranche ou de ligne en ajoutant le préfixe min_ ou max_ à son nom. Par exemple, &min_income_sum_slice_percentage_of_row=52.

Champs

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

Si vous omettez le paramètre fields, tous les champs sont renvoyés. Avec fields=simple, ce point de terminaison ne renvoie que les champs agrégés.

Afficher la liste des champs disponibles.
  • Les agrégats indiqués ci-dessus

  • country

  • source_organization_name

  • livelihood_zone

  • livelihood_zone_baseline_name

  • reference_year_start_date

  • reference_year_end_date

  • valid_from_date

  • valid_to_date

  • main_livelihood_category

  • livelihood_zone_baseline_description

  • wealth_group_category

  • wealth_group_category_name

  • wealth_group_category_ordering

  • percentage_of_households

  • average_household_size

  • currency

  • population_source

  • population_estimate

  • product

  • product_common_name

  • season_name

  • season_ordering

  • additional_identifier

  • strategy_type

  • scenario

  • id

  • season

  • livelihood_strategy

  • wealth_group

  • livelihood_zone_baseline

  • source_organization

  • iso3166a2 (code pays à deux lettres)

Le paramètre fields détermine la façon dont les données sont agrégées et présentées dans les résultats. Si un champ est inclus, les lignes sont désagrégées pour afficher les chiffres ventilés selon ce champ. Tous les champs non inclus sont agrégés ensemble.

Comme slice_percentage_of_row indique le pourcentage de la valeur totale de la ligne apporté par la tranche, si le champ de la tranche (produit et/ou type de stratégie) figure aussi dans le paramètre &fields, les valeurs de slice_percentage_of_row sont soit 0, soit 100 %, selon que la valeur du champ de la ligne correspond ou non à la tranche.

Exemple

L’exemple ci-dessus comprend un filtre slice_by_product.

Dans le premier jeu de résultats, où product n’est pas inclus comme champ, les valeurs de kcals_consumed_sum_slice_percentage_of_row comprennent 88 et 15.

Dans le second jeu de résultats, où product est inclus comme champ, les valeurs de kcals_consumed_sum_slice_percentage_of_row sont toutes égales à 100 ou à 0.

Tri

Ce point de terminaison utilise le paramètre standard ordering. Si aucun n’est indiqué, les résultats sont triés par ordre décroissant des agrégats (c.-à-d. le pourcentage le plus élevé en premier).

Afficher la liste des options de tri.
  • country

  • source_organization_name

  • livelihood_zone

  • liveihood_zone_baseline_name

  • reference_year_start_date

  • reference_year_end_date

  • valid_from_date

  • valid_to_date

  • main_livelihood_category

  • livelihood_zone_baseline_description

  • wealth_group_category

  • wealth_group_category_name

  • wealth_group_category_ordering

  • percentage_of_households

  • average_household_size

  • currency

  • population_source

  • population_estimate

  • product

  • product_common_name

  • strategy_type

  • scenario

  • id

  • livelihood_strategy

  • wealth_group

  • livelihood_zone_baseline

  • source_organization

  • iso3166a2