Contacts map

Contacts → Map shows where your contacts are: a heat layer of contact density over a world map, countries shaded by their total, and ranked lists of countries and cities with counts and shares. Scroll or pinch to zoom, drag to move, click a country to fly to it and list its cities, click a city to fly to it.

The map uses the country, city, region, latitude and longitude fields of each contact. Contacts with only a country appear in the country shading; contacts with a city and coordinates also feed the heat layer. See Location for how those fields are filled.

GET /api/workspaces/{workspaceId}/contacts/geo

Auth: session or API key with contacts.read.

Counts known (non-anonymous) contacts per country and per city. Cities are capped at the 1,000 largest.

{
  "total": 41449,
  "withCountry": 7320,
  "withCity": 5100,
  "countries": [
    { "country": "IT", "count": 5200 },
    { "country": "BR", "count": 820 }
  ],
  "cities": [
    { "country": "IT", "region": "RM", "city": "Roma", "latitude": 41.9028, "longitude": 12.4964, "count": 1400 }
  ]
}

latitude and longitude are the average of the contacts in that city and are null when none of them has coordinates.