Skip to main content

Geo Code

4.0.0
Geographic
Utility
SOAP API
Travel Agency
Airline Carrier

The Geo Code (GeoCodeRQ) API is used to locate hotel associates, car associates, and other points of interest through geo-coding within a user-defined area.

Not Signed In.

Looks like you may not have access to all of the resources and documentation for this page.
Please log-in or contact your support desk team if you believe you should have access.

Target Audience
Travel Agency
Airline Carrier
API Version
4.0.0
Authentication
Session Token
Service Action Code
GeoCodeRQ

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?

  • Locate hotel associates, car associates, and other points of interest through geo-coding within a user-defined area.
  • Retrieve routing or driving directions, along with the ability to convert a physical address into a geo-code
  • Convert addresses into geo-coded values. Convert a point of interest location or an address into a geo-code value.

How it works

Use Geo Code to retrieve geographic details (like geographical coordinates) to plot locations on a graphical map.

Geo Code supports four (4) PlaceByType requests:

  • Geocode by PlaceById
  • Geocode by PlaceByFreeText 
  • Geocode by PlaceByName
  • Geocode by PlaceByAddress

Geo Code can enclose multiple GeoCodeRQ Objects as part of the GeoCodeRequest when needed, and can similarly retrieve multiple GeoCodeRS objects sequentially as part of the GeoCodeResponse.

Sample Request
Get the geocode values when place ID and Category type is given in request.

<GeoCodeRequest xmlns="http://services.sabre.com/util/geo/v5" xmlns:p1="http://services.sabre.com/STL_Payload/v02_02" xmlns:p2="http://services.sabre.com/STL_MessageCommon/v02_02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4" xsi:schemaLocation="http://services.sabre.com/util/geo/v4/GeoCodeRQ.xsd">
      <GeoCodeRQ>
        <PlaceByAddress>
          <City>New York</City>
          <Region>New York County</Region>
          <State>NY</State>
          <Country>US</Country>
        </PlaceByAddress>
         </GeoCodeRQ>
</GeoCodeRequest>

Get the geocode values when any free text like place name ,city name ,point of interest is given in request.

<GeoCodeRequest xmlns="http://services.sabre.com/util/geo/v5" xmlns:p1="http://services.sabre.com/STL_Payload/v02_02" xmlns:p2="http://services.sabre.com/STL_MessageCommon/v02_02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4" xsi:schemaLocation="http://services.sabre.com/util/geo/v4/GeoCodeRQ.xsd">
      <GeoCodeRQ>
        <PlaceByFreeText>
            <FreeText>Chicago, IL</FreeText>
        </PlaceByFreeText>
        <ResultSetConfig maxResults="10"/>
    </GeoCodeRQ>
</GeoCodeRequest>

Get the geocode values when place name and appropriate categories are given in request.

<GeoCodeRequest xmlns="http://services.sabre.com/util/geo/v5" xmlns:p1="http://services.sabre.com/STL_Payload/v02_02" xmlns:p2="http://services.sabre.com/STL_MessageCommon/v02_02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4" xsi:schemaLocation="http://services.sabre.com/util/geo/v4/GeoCodeRQ.xsd">
      <GeoCodeRQ>
       <PlaceById>
            <Id>21788</Id>
            <BrowseCategory name="Rail"/>
        </PlaceById>
        <ResultSetConfig maxResults="10"/>
    </GeoCodeRQ>
</GeoCodeRequest>

Get the geocode values when complete address like street name, city name ,country code, postal code is given in request.

<GeoCodeRequest xmlns="http://services.sabre.com/util/geo/v5" xmlns:p1="http://services.sabre.com/STL_Payload/v02_02" xmlns:p2="http://services.sabre.com/STL_MessageCommon/v02_02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4" xsi:schemaLocation="http://services.sabre.com/util/geo/v4/GeoCodeRQ.xsd">
      <GeoCodeRQ>
       <PlaceByName>
            <Name>Times Square</Name>
            <BrowseCategory name="Navteq:Tourist Attraction"/>
            <NarrowDownResultsBy>
                <City>New York</City>
                <State>New York</State>
                <Country>US</Country>
            </NarrowDownResultsBy>
        </PlaceByName>

        <ResultSetConfig maxResults="30"/>
    </GeoCodeRQ>
</GeoCodeRequest>
Sample Response
<ns12:GeoCodeResponse xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0">
      <ns6:ApplicationResults xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0" status="Complete">
        <ns6:Success timeStamp="2021-03-18T07:05:21.214-05:00"/>
      </ns6:ApplicationResults>
      <ns12:Results>
        <ns12:GeoCodeRS status="ONE_PLACE_FOUND">
          <ns12:Place latitude="40.713054" confidenceFactor="CITY_QUALITY" longitude="-74.007228">
            <ns12:Name>New York</ns12:Name>
            <ns12:Category>ADDRESS</ns12:Category>
            <ns12:City>New York</ns12:City>
            <ns12:Region>New York County</ns12:Region>
            <ns12:State>NY</ns12:State>
            <ns12:Country>US</ns12:Country>
          </ns12:Place>
        </ns12:GeoCodeRS>
      </ns12:Results>
    </ns12:GeoCodeResponse>

<ns12:GeoCodeResponse xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0">
      <ns6:ApplicationResults xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0" status="Complete">
        <ns6:Success timeStamp="2021-03-18T07:06:06.776-05:00"/>
      </ns6:ApplicationResults>
      <ns12:Results>
        <ns12:GeoCodeRS status="ONE_PLACE_FOUND">
          <ns12:Place latitude="41.883229" confidenceFactor="ADDRESS_QUALITY" longitude="-87.632398">
            <ns12:Name>Chicago</ns12:Name>
            <ns12:Category>CITY</ns12:Category>
            <ns12:City>Chicago</ns12:City>
            <ns12:Region>Cook County</ns12:Region>
            <ns12:State>IL</ns12:State>
            <ns12:Country>US</ns12:Country>
          </ns12:Place>
        </ns12:GeoCodeRS>
      </ns12:Results>
    </ns12:GeoCodeResponse>
   
 <ns12:GeoCodeResponse xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0">
      <ns6:ApplicationResults xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0" status="Complete">
        <ns6:Success timeStamp="2021-03-18T07:07:16.732-05:00"/>
      </ns6:ApplicationResults>
      <ns12:Results>
        <ns12:GeoCodeRS status="ONE_PLACE_FOUND">
          <ns12:Place latitude="-31.941389" confidenceFactor="ADDRESS_QUALITY" longitude="115.965278">
            <ns12:Name>Perth, Western</ns12:Name>
            <ns12:Category>AIR</ns12:Category>
            <ns12:Id>PER</ns12:Id>
            <ns12:City>Perth</ns12:City>
            <ns12:State>WA</ns12:State>
            <ns12:Country>AU</ns12:Country>
          </ns12:Place>
        </ns12:GeoCodeRS>
      </ns12:Results>
    </ns12:GeoCodeResponse>
   
  <ns12:GeoCodeResponse xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0">
      <ns6:ApplicationResults xmlns="http://services.sabre.com/STL_Payload/v02_01" xmlns:ns2="http://services.sabre.com/essm/diagnostic/v1" xmlns:ns3="http://services.sabre.com/essm/core/v1" xmlns:ns4="http://opentravel.org/common/message/v02" xmlns:ns5="http://opentravel.org/common/v02" xmlns:ns6="http://services.sabre.com/STL_Payload/v02_02" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/geo/geocode/v4" xmlns:ns9="http://services.sabre.com/STL_Header/v02_02" xmlns:ns10="http://services.sabre.com/STL_Header/v120" xmlns:ns11="http://services.sabre.com/STL_Header/v02_01" xmlns:ns12="http://services.sabre.com/util/geo/v5" xmlns:ns13="http://services.sabre.com/util/geo/v1" xmlns:ns14="http://services.sabre.com/util/geo/v2" xmlns:ns15="http://www.OpenTravel.org/ns/OTA2/AppInfo_v01_00" xmlns:ns16="http://geoservices.sabre.com/ws/common/v3" xmlns:ns17="http://services.sabre.com/geo/geosearch/v4" xmlns:ns18="http://services.sabre.com/STL/v01" xmlns:ns19="http://services.sabre.com/ssse/trace/v01" xmlns:ns20="http://geoservices.sabre.com/ws/geocode/v3" xmlns:ns21="http://geoservices.sabre.com/ws/geosearch/v3" xmlns:ns22="http://services.sabre.com/sp/ssp/v1" xmlns:ns23="http://services.sabre.com/essm/session/v1" xmlns:ns24="http://webservices.sabre.com/servicesplatform/eiapi/1.0.0" status="Complete">
        <ns6:Success timeStamp="2021-03-18T07:09:01.396-05:00"/>
      </ns6:ApplicationResults>
      <ns12:Results>
        <ns12:GeoCodeRS status="PLACE_NOT_FOUND"/>
      </ns12:Results>
    </ns12:GeoCodeResponse>
   
   
Weight
0