Amadeus · Schema

Location

Location schema from Points of Interest

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Properties

Name Type Description
id string id of the ressource
self object
type string the resource name
subType string location sub type
name string short name of the location
geoCode object
category string category of the location
tags array list of tags related to the location
rank string the rank is the position compared to other locations based on how famous is a place. 1 being the highest.
View JSON Schema on GitHub

JSON Schema

points-of-interest-location-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/points-of-interest-location-schema.json",
  "title": "Location",
  "description": "Location schema from Points of Interest",
  "properties": {
    "id": {
      "description": "id of the ressource",
      "type": "string",
      "example": "12345"
    },
    "self": {
      "properties": {
        "href": {
          "type": "string",
          "format": "uri",
          "example": "https://example.com/resource"
        },
        "methods": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "GET",
              "PUT",
              "DELETE",
              "POST",
              "PATCH"
            ]
          }
        }
      },
      "example": {
        "href": "string"
      }
    },
    "type": {
      "description": "the resource name",
      "type": "string",
      "example": "location"
    },
    "subType": {
      "description": "location sub type",
      "type": "string",
      "enum": [
        "AIRPORT",
        "CITY",
        "POINT_OF_INTEREST",
        "DISTRICT"
      ],
      "example": "AIRPORT"
    },
    "name": {
      "description": "short name of the location",
      "type": "string",
      "example": "Paris CDG"
    },
    "geoCode": {
      "properties": {
        "latitude": {
          "description": "latitude of the location",
          "type": "number",
          "format": "double",
          "example": 43.580418
        },
        "longitude": {
          "description": "longitude of the location",
          "type": "number",
          "format": "double",
          "example": 7.125102
        }
      }
    },
    "category": {
      "description": "category of the location",
      "type": "string",
      "enum": [
        "SIGHTS",
        "BEACH_PARK",
        "HISTORICAL",
        "NIGHTLIFE",
        "RESTAURANT",
        "SHOPPING"
      ],
      "example": "HISTORICAL"
    },
    "tags": {
      "description": "list of tags related to the location",
      "type": "array",
      "items": {
        "type": "string",
        "example": [
          "grocery",
          "japanese",
          "cafe"
        ]
      }
    },
    "rank": {
      "description": "the rank is the position compared to other locations based on how famous is a place. 1 being the highest.",
      "type": "string",
      "example": 1
    }
  },
  "type": "object"
}