Compare Areas

Compare multiple areas side-by-side.

Compare multiple areas side-by-side with detailed dimension breakdowns.

Compare Areas

Compare up to 5 areas side-by-side with full dimension breakdowns.

GET/v1/areas/compare
NameTypeRequiredDescription
idsstringrequiredComma-separated area IDs (2-5 areas)Example: sandton,rosebank,hyde-park
dimensionsstringoptionalSpecific dimensions to compareExample: safety,infrastructure

Example Request

cURL
curl -X GET "https://api.placeiq.co/v1/areas/compare?ids=sandton,rosebank,hyde-park" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "areas": [
    {
      "id": "sandton",
      "name": "Sandton",
      "truth_score": 8.4,
      "dimensions": { "safety": 7.2, "infrastructure": 9.1 }
    },
    {
      "id": "rosebank",
      "name": "Rosebank",
      "truth_score": 8.1,
      "dimensions": { "safety": 7.5, "infrastructure": 8.8 }
    },
    {
      "id": "hyde-park",
      "name": "Hyde Park",
      "truth_score": 8.6,
      "dimensions": { "safety": 8.1, "infrastructure": 8.9 }
    }
  ],
  "winner": {
    "overall": "hyde-park",
    "by_dimension": {
      "safety": "hyde-park",
      "infrastructure": "sandton"
    }
  }
}