Skip to main content

Geo Search

4.0.0
Geographic
Utility
SOAP API
Travel Agency
Airline Carrier
Sabre Internal

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.

The Geo Search API (GeoSearchRQ) is used to retrieve a list of properties around a search location using a radius or a neighborhood search. It can also be used to locate car rental locations, airports, and hotels.

Target Audience
Travel Agency
Airline Carrier
Sabre Internal
API Version
4.0.0
Authentication
Session Token
Service Action Code
GeoSearchRQ

Overview

Geo Search enables you to define different types of location resolutions, including:

  • Search hotels
  • Car rental locations
  • Airports by geocode (latitude and longitude)
  • Polygon ID
  • Airport code
  • Point of interest (POI)
  • Hotel codes
  • Rail stations
  • Sabre ID
  • Global ID

Within the request is a parameter that allows you to define a required search radius of up to 200 miles, or 321 kilometers, along with the defined unit of measure (miles or kilometers).

Search details

Hotel Rail Polygon Geo Code
Address Address
Airport Code Airport Code
Geo Code
Hotel Code
Place Name
POI POI
Polygon ID
Latitude and Longitude
Rail Station Name Rail Station Name
Search in a predefined area or neighborhood (for example, downtown Dallas) to return concise search results.
CHAIN
LOCALAREA

The response will contain:

  • Property ID
  • Property name
  • Property address, including latitude and longitude
  • Chain information

The response includes identified Airports, Hotels, or Car Rental Locations and the straight line distance between these resolved locations. If the search is by polygon ID, the response will include the hotels that fall within the requested polygon.

Reference point types

Below are the ref point types and value context combinations Geo Search currently supports:

Search by Refpoint Type Value Context Description
Polygon 37 CODE Provide polygon ID in the value field
Airport Code 6 CODE Provide airport code
Hotel Code 11 CODE Provide hotel id
POI 16 NAME Provide POI name and country code
Rail 7 NAME Provide rail station name

Search by RefPoint example:

<RefPoint Value="DFW" ValueContext="CODE" RefPointType="6" StateProv="TX" CountryCode="US"/>

Note: In this example, we're searching for an airport using the three-letter IATA airport code as the Value.

Search by AddressRef example:

<AddressRef Street="Hidden Ridge" City="irving" Zip="75038" County="Dallas" State="TX" Country="USA"/>

Note: Country is mandatory.

Search by GeoCode example:

<GeoCode Latitude="0.0" Longitude="0.0"/>

Note: Latitude and Longitude are mandatory.

Samples

Sample Request
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <stlh:SabreHeader xmlns:stlh="http://services.sabre.com/STL_Header/v02_01">
      <stlh:Service version="4.0.0">GeoSearchRQ</stlh:Service>
      <stlh:Identification>
        <stlh:CustomerID>Sabre</stlh:CustomerID>
        <stlh:CustomerAppID>NGGP</stlh:CustomerAppID>
        <stlh:ConversationID>V3mP9V8FNMFnh4PmIXHDLSIUsKTEi45V</stlh:ConversationID>
        <stlh:MessageID>bibos6h5Vx01v7sciP1dOk</stlh:MessageID>
        <stlh:TimeStamp>2014-11-07T14:45:42.725-06:00</stlh:TimeStamp>
      </stlh:Identification>
    </stlh:SabreHeader>
    <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd oasis-200401-wss-wssecurity-secext-1.0.xsd">
      <wsse:BinarySecurityToken EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary" wsu:Id="athId">Shared/IDL:IceSess\/SessMgr:1\.0.IDL/Common/!ICESMS\/STSB!ICESMSLB\/STS.LB!1627893922010!3040!265</wsse:BinarySecurityToken>
    </wsse:Security>
  </soap:Header>
  <soap:Body>
    <GeoSearchRQ 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/v5/GeoSearchRQ.xsd">
          <GeoRef Radius="5" UOM="MI"  MaxResults="10" Offset="1" Category="HOTEL">        
        <AddressRef Street="Hidden Ridge" City="irving" PostalCode="75038" County="Dallas" StateProv="TX" CountryCode="US"/>
      </GeoRef>    
    </GeoSearchRQ>
  </soap:Body>
</soap:Envelope>
Sample Response
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
  <soap-env:Header>
    <stlh2:SabreHeader xmlns:stlh2="http://services.sabre.com/STL_Header/v02_01">
      <stlh2:Service version="4.0.0">GeoSearchRQ</stlh2:Service>
      <stlh2:Identification>
        <stlh2:CustomerID>Sabre</stlh2:CustomerID>
        <stlh2:CustomerAppID>NGGP</stlh2:CustomerAppID>
        <stlh2:ConversationID>V3mP9V8FNMFnh4PmIXHDLSIUsKTEi45V</stlh2:ConversationID>
        <stlh2:MessageID>zbqdyv1w2</stlh2:MessageID>
        <stlh2:TimeStamp>2014-11-07T14:45:42.725-06:00</stlh2:TimeStamp>
      </stlh2:Identification>
      <ns11:ResultSummary xmlns:ns11="http://services.sabre.com/STL_Header/v02_01">
        <ns11:Success/>
      </ns11:ResultSummary>
    </stlh2:SabreHeader>
  </soap-env:Header>
  <soap-env:Body>
    <ns12:GeoSearchRS 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/geo/geocode/v4" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/STL_Payload/v02_02" 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://services.sabre.com/geo/geosearch/v4" xmlns:ns17="http://geoservices.sabre.com/ws/common/v3" 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">
      <ns8: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/geo/geocode/v4" xmlns:ns7="http://services.sabre.com/geo/common/v4" xmlns:ns8="http://services.sabre.com/STL_Payload/v02_02" 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://services.sabre.com/geo/geosearch/v4" xmlns:ns17="http://geoservices.sabre.com/ws/common/v3" 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">
        <ns8:Success timeStamp="2021-08-02T04:17:00.346-05:00"/>
      </ns8:ApplicationResults>
      <ns12:GeoSearchResults Radius="5.0" MaxSearchResults="109" UOM="MI" Category="HOTEL" OffSet="1" Latitude="32.877416" Longitude="-96.959879">
        <ns12:GeoSearchResult Latitude="32.88162" Direction="N" Longitude="-96.96151" Distance="0.31">
          <ns12:Name>Extended Stay America - Dallas - Las Colinas - Carnaby Street</ns12:Name>
          <ns12:Id>100128624</ns12:Id>
          <ns12:Street>5315 Carnaby St.</ns12:Street>
          <ns12:Zip>75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.88272" Direction="NE" Longitude="-96.95476" Distance="0.47">
          <ns12:Name>Extended Stay America - Dallas - Las Colinas - Meadow Creek Dr.</ns12:Name>
          <ns12:Id>100113322</ns12:Id>
          <ns12:Street>605 Meadow Creek Drive</ns12:Street>
          <ns12:Zip>TX 75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.88422" Direction="N" Longitude="-96.96112" Distance="0.48">
          <ns12:Name>TownePlace Suites Dallas Las Colinas</ns12:Name>
          <ns12:Id>100052176</ns12:Id>
          <ns12:Street>900 West Walnut Hill Lane</ns12:Street>
          <ns12:Zip>TX 75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.884876" Direction="N" Longitude="-96.959822" Distance="0.52">
          <ns12:Name>Wingate By Wyndham Las Colinas Irving</ns12:Name>
          <ns12:Id>100014860</ns12:Id>
          <ns12:Street>850 West Walnut Hill Lane</ns12:Street>
          <ns12:Zip>75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:State>TX</ns12:State>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="WG" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.884869" Direction="N" Longitude="-96.959301" Distance="0.52">
          <ns12:Name>Hampton Inn Dallas Las Colinas</ns12:Name>
          <ns12:Id>100022348</ns12:Id>
          <ns12:Street>820 Walnut Hill Lane</ns12:Street>
          <ns12:Zip>75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:State>TX</ns12:State>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="HX" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.88348" Direction="NE" Longitude="-96.95435" Distance="0.53">
          <ns12:Name>Extended Stay America - Dallas - Las Colinas - Green Park Dr.</ns12:Name>
          <ns12:Id>100119942</ns12:Id>
          <ns12:Street>5401 Green Park Drive</ns12:Street>
          <ns12:Zip>TX 75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.88483" Direction="N" Longitude="-96.96212" Distance="0.53">
          <ns12:Name>Residence Inn Dallas Las Colinas</ns12:Name>
          <ns12:Id>100086988</ns12:Id>
          <ns12:Street>950 Walnut Hill Lane</ns12:Street>
          <ns12:Zip>TX 75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.88414" Direction="NE" Longitude="-96.95528" Distance="0.54">
          <ns12:Name>Hyatt Place Dallas Las Colinas</ns12:Name>
          <ns12:Id>100093826</ns12:Id>
          <ns12:Street>5455 Green Park Drive</ns12:Street>
          <ns12:Zip>TX 75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.88316" Direction="NE" Longitude="-96.95315" Distance="0.56">
          <ns12:Name>Candlewood Suites Dallas-Las Colinas</ns12:Name>
          <ns12:Id>100051904</ns12:Id>
          <ns12:Street>5300 Green Park Drive</ns12:Street>
          <ns12:Zip>TX 75038</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
        <ns12:GeoSearchResult Latitude="32.8843" Direction="NE" Longitude="-96.95361" Distance="0.6">
          <ns12:Name>Fairfield Inn by Marriott Las Colinas</ns12:Name>
          <ns12:Id>100078316</ns12:Id>
          <ns12:Street>630 West John Carpenter Freeway</ns12:Street>
          <ns12:Zip>TX 75039</ns12:Zip>
          <ns12:City>Irving</ns12:City>
          <ns12:Country>US</ns12:Country>
          <ns12:ConfidenceFactor>1</ns12:ConfidenceFactor>
          <ns12:Attributes>
            <ns12:Attribute Value="7B" Name="CHAIN"/>
          </ns12:Attributes>
        </ns12:GeoSearchResult>
      </ns12:GeoSearchResults>
    </ns12:GeoSearchRS>
  </soap-env:Body>
</soap-env:Envelope>