Geographical Location Search

The Geography APIs provide you with access to geographic definitions and property mappings for over 600,000 regions and airports. Returns the geographic definition and property mappings of regions matching the specified parameters as a paginated response.

Parameters

Name

Description

Accept

string

( header )

Must be application/json

Accept - Encoding

string

( header )

Must be gzip

Authorization

string

( header )

Must be Your API Key

Customer-Ip

string

( header )

Must be IP address of the customer, as captured by your integration. Send IPV4 addresses only.

Ensure your integration passes the customer’s IP, not your own. This value helps determine their location and other settings.

Also used for fraud recovery and other important analytics.

term

string

( query )

Must be Relevent regions.

Specific information about the region e.g. whether it covers surrounding areas for a city. Only present when relevant for a region.

limit

number

( query )

Must be Page limit.

Limit the number of records returned.

REQUEST

API Endpoint: https://travelbeesapi.com/webServices/hotels/v2-sandbox/api.php

header: array(
'Content-Type:application/json',
'Accept-encoding: gzip',
'x-api-key:'ADD-YOUR-KEY'
);

GET: https://travelbeesapi.com/webServices/hotels/v2-sandbox/api.php?action=getLocations&requestBody={"term":"delhi"}
					 

Response

The API returns an HTTP response, which generally includes the result of the request invocation

{
    "cities":[ {
        "countryCode":"IN",
        "country":"India",
        "latinFullName":"Delhi City, India",
        "fullname":"Delhi City, India",
        "clar":"India",
        "latinClar":"India",
        "location": {
            "lat": 28.632558, "lon": 77.220036
        }
        ,
        "hotelsCount":1872,
        "iata":["DEL"],
        "city":"Delhi City",
        "latinCity":"Delhi City",
        "timezone":"Asia\/Kolkata",
        "timezonesec":19800,
        "latinCountry":"India",
        "id":24077,
        "countryId":77,
        "_score":1872,
        "state":null
    }
    ,
    {
        "countryCode":"CN",
        "country":"China",
        "latinFullName":"Delhi, China",
        "fullname":"Delhi, China",
        "clar":"China",
        "latinClar":"China",
        "location": {
            "lat": 37.376, "lon": 97.37457
        }
        ,
        "hotelsCount":4,
        "iata":[],
        "city":"Delhi",
        "latinCity":"Delhi",
        "timezone":"Asia\/Urumqi",
        "timezonesec":28800,
        "latinCountry":"China",
        "id":1526217,
        "countryId":73,
        "_score":4,
        "state":null
    }
    ,
    {
        "countryCode":"US",
        "country":"United States",
        "latinFullName":"Delhi, Louisiana, United States",
        "fullname":"Delhi, Louisiana, United States",
        "clar":"Louisiana, United States",
        "latinClar":"Louisiana, United States",
        "location": {
            "lat": 32.457642, "lon": -91.493174
        }
        ,
        "hotelsCount":4,
        "iata":[],
        "city":"Delhi",
        "latinCity":"Delhi",
        "timezone":"America\/Chicago",
        "timezonesec":-18000,
        "latinCountry":"United States",
        "id":18925,
        "countryId":148,
        "_score":4,
        "state":"Louisiana"
    }
    ,
    {
        "countryCode":"DK",
        "country":"Denmark",
        "latinFullName":"Copenhagen, Denmark",
        "fullname":"Copenhagen, Denmark",
        "clar":"Denmark",
        "latinClar":"Denmark",
        "location": {
            "lat": 55.67594, "lon": 12.56553
        }
        ,
        "hotelsCount":1326,
        "iata":["CPH",
        "CPH",
        "RKE"],
        "city":"Copenhagen",
        "latinCity":"Copenhagen",
        "timezone":"Europe\/Copenhagen",
        "timezonesec":7200,
        "latinCountry":"Denmark",
        "id":1410,
        "countryId":161,
        "_score":1326,
        "state":null
    }
    ,
    {
        "countryCode":"VN",
        "country":"Vietnam",
        "latinFullName":"Dalat, Vietnam",
        "fullname":"Dalat, Vietnam",
        "clar":"Vietnam",
        "latinClar":"Vietnam",
        "location": {
            "lat": 11.94646, "lon": 108.44193
        }
        ,
        "hotelsCount":941,
        "iata":["DLI",
        "DLI"],
        "city":"Dalat",
        "latinCity":"Dalat",
        "timezone":"Asia\/Ho_Chi_Minh",
        "timezonesec":25200,
        "latinCountry":"Vietnam",
        "id":14093,
        "countryId":113,
        "_score":941,
        "state":null
    }
    ],
    "hotels":[ {
        "state":null,
        "stars":1,
        "locationFullName":"Delhi City, India",
        "latinLocationFullName":"Delhi City, India",
        "hotelFullName":"Hotel Bed and Breakfast, Delhi City, India",
        "location": {
            "lat": 28.5714, "lon": 77.26005
        }
        ,
        "timezone":"Asia\/Kolkata",
        "timezonesec":19800,
        "id":2430114,
        "locationId":24077,
        "photoCount":18,
        "city":"Delhi City",
        "latinCity":"Delhi City",
        "clar":"India",
        "latinClar":"India",
        "latinCountry":"India",
        "locationHotelsCount":null,
        "rating":84,
        "country":"India",
        "distance":7.9,
        "_score":244206.0,
        "name":"Hotel Bed and Breakfast",
        "latinName":"Hotel Bed and Breakfast",
        "address":"A-6 Friends Colony East",
        "photos":[6323360354,
        6323360355,
        6323360359,
        6323360362,
        6657356385,
        6657356386,
        6657356387,
        6657356388,
        6657356390,
        6657356392,
        6807762130,
        6807762131,
        7331120796,
        7331120797,
        7331120798,
        7331120799,
        7331120800,
        8071511766,
        639104011,
        639104012,
        639104013,
        639104014,
        639104015,
        639104016],
        "countryId":77
    }
    ,
    {
        "state":null,
        "stars":0,
        "locationFullName":"Samalka, India",
        "latinLocationFullName":"Samalka, India",
        "hotelFullName":"Hotel Delhi Aerocity, Samalka, India",
        "location": {
            "lat": 28.54214, "lon": 77.11848
        }
        ,
        "timezone":"Asia\/Kolkata",
        "timezonesec":19800,
        "id":94225,
        "locationId":1513683,
        "photoCount":10,
        "city":"Samalka",
        "latinCity":"Samalka",
        "clar":"India",
        "latinClar":"India",
        "latinCountry":"India",
        "locationHotelsCount":null,
        "rating":72,
        "country":"India",
        "distance":2.8,
        "_score":106391.0,
        "name":"Hotel Delhi Aerocity",
        "latinName":"Hotel Delhi Aerocity",
        "address":"104\/2\/2, M. R. Complex, Rangpuri, National Highway 8, Near IGI Airport",
        "photos":[8336934958,
        8361948883,
        7331111400,
        8467806496,
        8467806513,
        8467806514,
        8467806500,
        8467806509,
        6322278060,
        6322278050,
        6322278056,
        6322278057,
        6322278058,
        8467806512,
        8013419086,
        8269879801,
        6523629859,
        8467806506,
        7742414255,
        7742414256,
        8258962217,
        8467806497,
        8467806498,
        8467806499],
        "countryId":77
    }
    ,
    {
        "state":null,
        "stars":3,
        "locationFullName":"Delhi City, India",
        "latinLocationFullName":"Delhi City, India",
        "hotelFullName":"HOTEL DELHI 55 @ NEW DELHI RAILWAY STATION, Delhi City, India",
        "location": {
            "lat": 28.64526, "lon": 77.21183
        }
        ,
        "timezone":"Asia\/Kolkata",
        "timezonesec":19800,
        "id":2419890,
        "locationId":24077,
        "photoCount":50,
        "city":"Delhi City",
        "latinCity":"Delhi City",
        "clar":"India",
        "latinClar":"India",
        "latinCountry":"India",
        "locationHotelsCount":null,
        "rating":73,
        "country":"India",
        "distance":1.6,
        "_score":101930.0,
        "name":"HOTEL DELHI 55 @ NEW DELHI RAILWAY STATION",
        "latinName":"HOTEL DELHI 55 @ NEW DELHI RAILWAY STATION",
        "address":"8703-06 Desh Bandhu Gupta Road Paharganj",
        "photos":[8544726977,
        8544726978,
        8544726974,
        8404950172,
        8340079212,
        8089476519,
        8089476520,
        8089476537,
        8467699417,
        8467699403,
        8089476521,
        6344294902,
        6344294908,
        6344294911,
        6344294912,
        6344294910,
        8467699405,
        6524623086,
        8002588409,
        8259078306,
        8336948078,
        7742715730,
        7742715731,
        7678261539],
        "countryId":77
    }
    ,
    {
        "state":null,
        "stars":0,
        "locationFullName":"Delhi City, India",
        "latinLocationFullName":"Delhi City, India",
        "hotelFullName":"Delhi Heart Dx Hotel, Delhi City, India",
        "location": {
            "lat": 28.6438, "lon": 77.21721
        }
        ,
        "timezone":"Asia\/Kolkata",
        "timezonesec":19800,
        "id":92200,
        "locationId":24077,
        "photoCount":13,
        "city":"Delhi City",
        "latinCity":"Delhi City",
        "clar":"India",
        "latinClar":"India",
        "latinCountry":"India",
        "locationHotelsCount":null,
        "rating":69,
        "country":"India",
        "distance":1.3,
        "_score":98541.0,
        "name":"Delhi Heart Dx Hotel",
        "latinName":"Delhi Heart Dx Hotel",
        "address":"3738, Opposite Shiela Cinema ,New Delhi Station , New Delhi",
        "photos":[7331109579,
        7331109577,
        7331109578,
        7331109575,
        6329283556,
        6329283557,
        6329283567,
        6329283569,
        6329283571,
        6329283573,
        8456713648,
        8456713649,
        8456713650,
        8456713647,
        7713932160,
        7713932169,
        7713932171,
        7713932194,
        7713932197,
        7713932211,
        7713932214,
        8086946082,
        8086946107,
        8467714190],
        "countryId":77
    }
    ,
    {
        "state":null,
        "stars":0,
        "locationFullName":"Samalka, India",
        "latinLocationFullName":"Samalka, India",
        "hotelFullName":"Hotel Delhi 37, Samalka, India",
        "location": {
            "lat": 28.550025, "lon": 77.128735
        }
        ,
        "timezone":"Asia\/Kolkata",
        "timezonesec":19800,
        "id":94074,
        "locationId":1513683,
        "photoCount":24,
        "city":"Samalka",
        "latinCity":"Samalka",
        "clar":"India",
        "latinClar":"India",
        "latinCountry":"India",
        "locationHotelsCount":null,
        "rating":72,
        "country":"India",
        "distance":4.1,
        "_score":96665.0,
        "name":"Hotel Delhi 37",
        "latinName":"Hotel Delhi 37",
        "address":"A-147, National Highway No. 8, Mahipalpur",
        "photos":[8544725544,
        8302908325,
        8336930406,
        8361919058,
        8544725547,
        8544725546,
        4586814419,
        4586814422,
        4586814423,
        6328895600,
        8069836624,
        8461167287,
        8069836596,
        8069836609,
        8069836616,
        4586814417,
        6328895587,
        6328895593,
        6328895597,
        4586814420,
        8461167288,
        6328895595,
        6328895589,
        6328895592],
        "countryId":77
    }
    ]
}