Skip to main content

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

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.
  • 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.