PlacesSearchResponse

places object[]

Array [

placeIdstring<uuid>

Canonical place ID (use as canonicalCityId for hotels/by-destination)

canonicalCityIdstring<uuid>

Same as placeId; use for hotels/by-destination

typestring

COUNTRY, REGION, CITY, ZONE, AIRPORT

namestring

countryCodestring

ISO 3166-1 alpha-2

pathstring

Full breadcrumb path (e.g. "Madrid, Spain")

populationinteger<int64>

GeoNames population (touristic relevance proxy)

]

errors object[]

Array [

codestring

typestring

Possible values: [CLIENT, SERVER]

descriptionstring

]

warnings object[]

Array [

codestring

typestring

descriptionstring

]

PlacesSearchResponse

{
  "places": [
    {
      "placeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "canonicalCityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "string",
      "name": "string",
      "countryCode": "string",
      "path": "string",
      "population": 0
    }
  ],
  "errors": [
    {
      "code": "string",
      "type": "CLIENT",
      "description": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "type": "string",
      "description": "string"
    }
  ]
}