Enrichment Fields

Map Zena can enrich geocoding and reverse-geocoding responses with demographic, economic, and country metadata.

Enrichment Fields

Add enrich=1 to geocoding and reverse-geocoding calls to include country_data and optional admin-level metadata.

Top-level enrichment groups

GroupDescription
country_dataCountry profile and macro indicators.
admin_dataAdmin-level names/codes where available.
climateMonthly temperature and precipitation normals.

Common fields

  • population, population_urban, population_rural
  • gdp_bn_usd, gdp_per_capita, gdp_ppp_bn
  • currency, currency_name
  • languages, calling_code, tld
  • hdi, life_expect, median_age
  • climate.jan_avg_c through climate.dec_avg_c
  • climate.jan_rain_mm through climate.dec_rain_mm

Example response object

json
{
  "country_data": {
    "iso2": "FR",
    "population": 67750000,
    "gdp_bn_usd": 2780.1,
    "currency": "EUR"
  },
  "climate": {
    "jan_avg_c": 5.5,
    "jul_avg_c": 25.2,
    "ann_rain_mm": 637
  }
}

Billing note

Enrichment requests count toward usage. The first 500 requests/day are free in anonymous mode; additional usage is billed from account credit. See Rate Limits.