Amadeus · JSON Structure

Airport City Search Location Structure

Location structure from Airport & City Search

Type: object Properties: 16
TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Airport City Search Location Structure is a JSON Structure definition published by Amadeus, describing 16 properties. It conforms to the https://json-structure.org/draft/v0/schema meta-schema.

Properties

id self type subType name detailedName timeZoneOffset iataCode geoCode address distance analytics relevance category tags rank

Meta-schema: https://json-structure.org/draft/v0/schema

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/draft/v0/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/airport-city-search-location-structure.json",
  "title": "Location",
  "description": "Location structure from Airport & City Search",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "id of the ressource"
    },
    "self": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "description": "the resource name"
    },
    "subType": {
      "type": "string",
      "description": "location sub type"
    },
    "name": {
      "type": "string",
      "description": "short name of the location"
    },
    "detailedName": {
      "type": "string",
      "description": "detailed name of the location. For a city location it contains city name and country code. For an airport location it contains city name; country code and airport full name"
    },
    "timeZoneOffset": {
      "type": "string",
      "description": "timezone offset of the location at the date of the API call (including daylight saving time)"
    },
    "iataCode": {
      "type": "string",
      "description": "IATA code of the location. ([IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx) here)"
    },
    "geoCode": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "distance": {
      "type": "string"
    },
    "analytics": {
      "type": "string"
    },
    "relevance": {
      "type": "number",
      "format": "double",
      "description": "score value calculated based on distance and analytics"
    },
    "category": {
      "type": "string",
      "description": "category of the location"
    },
    "tags": {
      "type": "array",
      "description": "list of tags related to the location"
    },
    "rank": {
      "type": "string",
      "description": "the rank is the position compared to other locations based on how famous is a place. 1 being the highest."
    }
  }
}