Skip Navigation

Geo Code

Geographic
Utility
REST API
Airline Carrier
Travel Agency
Try Now

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 request.
  • PlaceByFreeText - Returns geo-coded values when any free text, like place name, city name, or point of interest, is provided in the request.
  • PlaceByName - Returns geo-coded values when a place name and appropriate categories are provided in the request.
  • PlaceByAddress - Returns geo-coded values when a complete address, like street name, city name, country code, and postal code are provided in the request.

Note: If the geo-coded location lies in a geographically disputed region, the Country Code returned in the response will be "XY".

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)

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 as AIR,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 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.