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 |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/airport-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",
"minimum": -3.402823669209384e+38,
"multipleOf": 3.402823669209384e+38
},
"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",
"minimum": -3.402823669209384e+38,
"multipleOf": 3.402823669209384e+38
}
}
},
"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": {
"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",
"type": "integer"
}
}
}
}
}