What is it?
What is it?
The Geo Code API uses the description of a location to retrieve geographic details, like geographical coordinates. The location description can be a postal address, point of interest landmark (like Disneyland), or a place ID (such as an airport, multi-airport city (MAC) code, or Sabre ID) or free text.
There are four geo code types:
PlaceById
- Returns geo-coded values when a place ID and Category type is provided in the requestPlaceByFreeText
- Returns geo-coded values when any free text, like place name, city name, or point of interest, is provided in the requestPlaceByName
- Returns geo-coded values when a place name and appropriate categories are provided in the requestPlaceByAddress
- Returns geo-coded values when a complete address, like street name, city name, country code, and postal code are provided in the request
Why use it?
Convert a point of interest or an address into geocoded values:
- Locate hotel associates, car associates, and other points of interest through geo-coding within a user-defined area.
- While GeoCode V1 communicates with legacy geo applications, GeoCodeRQ V4 communicates with next generation geo platforms.
- GeoCode V1 is on the path to being sunsetted, so use of GeoCode V4 is recommended.
- Get geocode (latitude and longitude) values based on:
- Place ID (
DFW
) - Category type (
AIR
) - Free text, including place name, city name, and point of interest
- Complete address (street, city, country code, postal code)
- Place ID (
How it works
Use Geo Code to retrieve geographic details (like geographical coordinates) to plot locations on a graphical map.
This API supports four (4) PlaceByType
requests:
- Geocode by
PlaceById
Id
: Required field. The identifier of the place.BrowseCategory
: Required field. The type of category, such asAIR
,RAIL
,Sabre:CRL
,Sabre:HOT
, and global property.
- Geocode by
PlaceByFreeText
FreeText
: Required field. Contains the parameters to get geo code values by free text.
- Geocode by
PlaceByName
Name
: Required field. The name of the place to search by.
- Geocode by
PlaceByAddress
Country
: Required field. Country as a two-letter, ISO 3166 code.
With Geo Code, you can make a request that combines all four PlaceByType
s together. To do this, enclose multiple GeoCodeRQ
objects as part of the GeoCodeRequest
. This will result in the retrieval of multiple sequential GeoCodeRS
objects as part of the GeoCodeResponse
.
How to use
Use Geo Code to retrieve geographic details (like geographical coordinates) to plot locations on a graphical map.
This API supports four (4) PlaceByType
requests:
- Geocode by
PlaceById
- Geocode by
PlaceByFreeText
- Geocode by
PlaceByName
- Geocode by
PlaceByAddress
With Geo Code, you can make a request that combines all four PlaceByType
s together. To do this, enclose multiple GeoCodeRQ
objects as part of the GeoCodeRequest
. This will result in the retrieval of multiple sequential GeoCodeRS
objects as part of the GeoCodeResponse
.