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
PlaceByIdId: 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
PlaceByFreeTextFreeText: Required field. Contains the parameters to get geo code values by free text.
- Geocode by
PlaceByNameName: Required field. The name of the place to search by.
- Geocode by
PlaceByAddressCountry: Required field. Country as a two-letter, ISO 3166 code.
With Geo Code, you can make a request that combines all four PlaceByTypes 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 PlaceByTypes 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.