Amadeus · Schema

locations

Description of a particular point or place in physical space

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Properties

Name Type Description
type string type of API result "location"
subtype string Location sub-type (e.g. airport, port, rail-station, restaurant, atm...)
name string Label associated to the location (e.g. Eiffel Tower, Madison Square)
iataCode string IATA location code
geoCode object Geographic coordinates describing the position of any location on the surface of Earth
address object
timeZone object
metrics object
View JSON Schema on GitHub

JSON Schema

airline-routes-locations-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/airline-routes-locations-schema.json",
  "title": "locations",
  "description": "Description of a particular point or place in physical space",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "type of API result \"location\"",
      "example": "string-value"
    },
    "subtype": {
      "type": "string",
      "description": "Location sub-type (e.g. airport, port, rail-station, restaurant, atm...)",
      "example": "string-value"
    },
    "name": {
      "type": "string",
      "description": "Label associated to the location (e.g. Eiffel Tower, Madison Square)",
      "example": "\"Eiffel Tower\""
    },
    "iataCode": {
      "type": "string",
      "description": "IATA location code",
      "example": "\"PAR\""
    },
    "geoCode": {
      "type": "object",
      "description": "Geographic coordinates describing the position of any location on the surface of Earth",
      "properties": {
        "latitude": {
          "type": "number",
          "description": "Latitude of the position expressed in decimal degrees (WSG 84), e.g. 6.244203. A positive value denotes northern hemisphere or the equator, and a negative value denotes southern hemisphere. The number of digits to represent the precision of the coordinate.",
          "example": "48.85837"
        },
        "longitude": {
          "type": "number",
          "description": "Longitude of the position expressed in decimal degrees (WSG 84), e.g. -75.581211. A positive value denotes east longitude or the prime meridian, and a negative value denotes west longitude. The number of digits to represent the precision of the coordinate.",
          "example": "2.294481"
        }
      }
    },
    "address": {
      "type": "object",
      "properties": {
        "countryName": {
          "type": "string",
          "description": "Name of the country of the location",
          "example": "France"
        },
        "countryCode": {
          "type": "string",
          "description": "Code of the country of the location in ISO standard",
          "example": "FR"
        },
        "stateCode": {
          "type": "string",
          "description": "Code of the state of the location (if any)",
          "example": "FR-13"
        },
        "regionCode": {
          "type": "string",
          "description": "Code of the region of the location in ISO standard",
          "example": "EUROP"
        }
      }
    },
    "timeZone": {
      "type": "object",
      "properties": {
        "offSet": {
          "type": "string",
          "description": "'Total offset from UTC including the Daylight Saving Time (DST) following ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601) standard'",
          "example": "+01:00"
        },
        "referenceLocalDateTime": {
          "type": "string",
          "description": "Date and time used as reference to determine the time zone name, code, offset, and dstOffset following ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601) standard.",
          "example": "2022-09-28T19:20:30"
        }
      }
    },
    "metrics": {
      "type": "object",
      "properties": {
        "relevance": {
          "type": "integer",
          "description": "Score value based on the number of travelers per year and per destination. Score is between 0 and 100, 100 being the value for the destination city with the highest value of travelers for the origin airport",
          "example": "100"
        }
      }
    }
  }
}