Search
Returns points of interest for a given area
get/reference-data/locations/pois/by-square
Request
- Base URLhttps://test.api.amadeus.com/v1
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
northnumber double required
Latitude north of bounding box (decimal coordinates)
westnumber double required
Longitude west of bounding box (decimal coordinates)
southnumber double required
Latitude south of bounding box (decimal coordinates)
eastnumber double required
Longitude east of bounding box (decimal coordinates)
page[limit]integer
maximum items in one page
page[offset]integer
start index of the requested page
categoriesstring[]
category of the location.
Multiple value can be selected using a comma i.e. SIGHTS, SHOPPING
Response
Successful Operation
Example response
{
"data": [
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "9CB40CB5D0",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/9CB40CB5D0",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.39165,
"longitude": 2.164772
},
"name": "Casa Batlló",
"category": "SIGHTS",
"rank": 5,
"tags": [
"sightseeing",
"sights",
"museum",
"landmark",
"tourguide",
"restaurant",
"attraction",
"activities",
"commercialplace",
"shopping",
"souvenir"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "4690B83DCA",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/4690B83DCA",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.397987,
"longitude": 2.161159
},
"name": "La Pepita",
"category": "RESTAURANT",
"rank": 30,
"tags": [
"restaurant",
"tapas",
"pub",
"bar",
"sightseeing",
"commercialplace"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "3EF139D861",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/3EF139D861",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.38827,
"longitude": 2.161604
},
"name": "Brunch & Cake",
"category": "RESTAURANT",
"rank": 30,
"tags": [
"vegetarian",
"restaurant",
"breakfast",
"shopping",
"bakery",
"transport",
"patio",
"garden"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "AB3F122E3E",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/AB3F122E3E",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.392376,
"longitude": 2.160919
},
"name": "Cervecería Catalana",
"category": "RESTAURANT",
"rank": 30,
"tags": [
"restaurant",
"tapas",
"sightseeing",
"traditionalcuisine",
"bar",
"activities",
"commercialplace"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "752402FCA2",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/752402FCA2",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.40043,
"longitude": 2.15463
},
"name": "Botafumeiro",
"category": "RESTAURANT",
"rank": 30,
"tags": [
"restaurant",
"seafood",
"sightseeing",
"professionalservices",
"transport",
"commercialplace"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "5F1CED3994",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/5F1CED3994",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.39148,
"longitude": 2.164981
},
"name": "Casa Amatller",
"category": "SIGHTS",
"rank": 100,
"tags": [
"sightseeing",
"sights",
"museum",
"landmark",
"restaurant",
"tourguide",
"historicplace",
"historic",
"attraction",
"commercialplace",
"activities",
"shopping",
"events"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "30601A1A90",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/30601A1A90",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.390785,
"longitude": 2.167414
},
"name": "Tapas 24",
"category": "RESTAURANT",
"rank": 100,
"tags": [
"restaurant",
"tapas",
"traditionalcuisine",
"sightseeing",
"commercialplace",
"transport",
"patio",
"garden",
"activities",
"bar"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "15C8B8148C",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/15C8B8148C",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.392677,
"longitude": 2.153942
},
"name": "Dry Martini",
"category": "NIGHTLIFE",
"rank": 100,
"tags": [
"bar",
"restaurant",
"nightlife",
"club",
"sightseeing",
"attraction",
"activities"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "BD29CF2CCD",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/BD29CF2CCD",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.399193,
"longitude": 2.159853
},
"name": "Con Gracia",
"category": "RESTAURANT",
"rank": 100,
"tags": [
"restaurant",
"sightseeing",
"commercialplace",
"professionalservices",
"activities"
]
},
{
"type": "location",
"subType": "POINT_OF_INTEREST",
"id": "24DE6CE737",
"self": {
"href": "https://test.api.amadeus.com/v1/reference-data/locations/pois/24DE6CE737",
"methods": [
"GET"
]
},
"geoCode": {
"latitude": 41.390198,
"longitude": 2.156974
},
"name": "Osmosis",
"category": "RESTAURANT",
"rank": 100,
"tags": [
"restaurant",
"shopping",
"transport",
"professionalservices"
]
}
],
"meta": {
"count": 120,
"links": {
"self": "https://test.api.amadeus.com/v1/reference-data/locations/pois?latitude=41.397158&longitude=2.160873",
"next": "https://test.api.amadeus.com/v1/reference-data/locations/pois?latitude=41.397158&longitude=2.160873&page[offset]=10&page[limit]=10",
"last": "https://test.api.amadeus.com/v1/reference-data/locations/pois?latitude=41.397158&longitude=2.160873&page[offset]=120&page[limit]=10",
"first": "https://test.api.amadeus.com/v1/reference-data/locations/pois?latitude=41.397158&longitude=2.160873&page[offset]=0&page[limit]=10",
"up": "https://test.api.amadeus.com/v1/reference-data/locations/pois?latitude=41.397158&longitude=2.160873"
}
}
}Changes
No recorded changes to this operation across all 2 revisions of this API.