Skip Navigation

Migration Guide - Geo Search v1 to v4

Why are we sunsetting?

As part of the feature roadmap for Sabre Geographical Services applications, we are requesting all users to migrate to our NGGP (Next Generation) Services API Geo Search V4, which supports all functionalities of the existing NGGP Geo Search V1 API and will help deliver better quality of data and results in the near future. Many backend enhancements are in progress to improve the quality of data served by the GEO API and are in our API's latest version (V4).

What's New

Using a radius search, the Geo Search V4 API identifies airports, hotels, rail stations, and car rental locations that fall within a given geographic search location. For more details can be found at Geo Search.

The New Search Features Introduced are:

Comparison Criteria Geo Search V1Geo Search V4
Categories supportedHOTEL, CAR, AIRHOTEL, CAR, AIR, RAIL
Search Criteria for Hotels
  • Search by Geo Code
  • Search by Airport Code
  • Search by Place Name 
  • Search by Point of Interest (POI)
  • Search by Hotel Code (by Sabre ID's)
  • Search by Address
  • Search by Rail
  • Search by Geo Code
  • Search by Airport Code
  • Search by Place Name
  • Search by Point of Interest (POI)
  • Search by Hotel Code (by Sabre and Global Hotel ID's)
  • Search by Address
  • Search by Rail
  • Search by Polygon ID
Types of Hotels Available
  • SABRE
  • GLOBAL (Default)
  • SABRE
Search Criteria for Rail Stations
  • Not Supported
  • Search by Address
  • Search by Airport Code
  • Search by Point of Interest (POI)
  • Search by Latitude and Longitude
  • Search by Rail Station name
  • Search by Hotel Codes (By Sabre and Global Hotel ID's)
  • Search By Polygon ID's
Search Filters
  • Radius
  • UOM
  • Radius
  • UOM
  • Direction

What's Changing

As part of this migration, we can see the following breaking changes:

  1. MOM Connectivity: Customers using direct MOM queues to invoke the Geo Search V1 API will need to start using gateway solutions, i.e., USG/2SG, to invoke the Geo Search v4 API. The Geo team has plans to discontinue direct MOM calls due to planned infrastructural changes; hence, customers are advised to move to gateways for a seamless migration.

  2. REST Response: The Geo Search V1 REST responses contained additional fields, such as links and reference URLs. The data is of no use to the customers and was being added by an intermediary system that is no longer needed and is on its sunset path; hence, in the V4 version of the API, we will now have much cleaner responses, which are like some child objects in Geo Search V1. Refer to the REST migration section for more details.

  3. Client ID is recommended for use: In the Geo Search V4 API, passing the client ID while invoking through session/token to create APIs is recommended. For more details, see Authentication Requirements.

Important Note for SOAP Users

Geo Search V4 APIs support SOAP request formats. However, SOAP formats will be discontinued from future versions of this API. We recommend customers migrate from the Geo Search V1 (SOAP) version to the Geo Search V4 (REST) version where possible to have a seamless migration when moving to future API versions when they become available.

URL Endpoints for use

  • External Users External users can continue using the existing endpoint host, which is in use, and update the path to match the new API version during migration.

    Example:

  • webservices.platform.sabre.com/v1/geo/search

  • webservices.platform.sabre.com/v4/geo/search

    For more details & options refer to Endpoints

  • Internal Users: Users within the Sabre network can use the USG/2SG endpoints based on their deployment networks by referring to the following documentation: API Gateways.

    Note: Internal users must use the internal URL's only from the given list for better connectivity.

Authentication Requirements

  • It's recommended to pass the client ID while making requests to Geo Search V4. See How to Pass Client ID for more details.

REST Version:

The Geo Search V4 REST API supports sessionless token authentication (ATK), For more details on how to generate the tokens, see:

SOAP Version:

The Geo Search V4 SOAP API supports both session tokens (ATH) and session-less tokens (ATK) for authentication. However, this API does not require any session-related information. Customers are advised to use the session-less tokens (ATK) where possible.

Refer to the options for sessionless token creation:

How to Pass Client ID

  • Users need to get the client ID and password from their respective account manager by following the Dev Studio documentation.

  • After getting the client ID and password, this needs to be passed in a token create API's security header:

  • For SOAP (ATK): Create Access Token

<wsse:Security xmlns:wsse="http://schemas.xmlsoap.org/ws/2002/12/secext">
    <wsse:UsernameToken>
        <wsse:Username>USER</wsse:Username>
        <wsse:Password>PASSWORD</wsse:Password>
        <Organization>PCC</Organization>
        <Domain>DOMAIN</Domain>
        <ClientId>YOUR_CLIENT_ID_HERE</ClientId>
        <ClientSecret>YOUR_CLIENT_SECRET_HERE</ClientSecret>
    </wsse:UsernameToken>
</wsse:Security>
<wsse:Security xmlns:wsse="http://schemas.xmlsoap.org/ws/2002/12/secext">
    <wsse:UsernameToken>
        <wsse:Username>773400</wsse:Username>
        <wsse:Password>PASSWORD_GOES_HERE</wsse:Password>
        <Organization>7TZA</Organization>
        <Domain>AA</Domain>
        <ClientId>YOUR_CLIENT_ID_HERE</ClientId>
        <ClientSecret>YOUR_CLIENT_SECRET_HERE</ClientSecret>
    </wsse:UsernameToken>
</wsse:Security>

How to migrate to the REST version?

SOAP to REST Conversion (Geo Search V1 to Geo Search V4)

Search By GeoCode

Geo Search V1

<soap:Body>
    <GeoSearchRQ xmlns="http://services.sabre.com/util/geo/v1" 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/XMLSchemainstance" version="1" xsi:schemaLocation="http://services.sabre.com/util/geo/v1/GeoSearchRQ.xsd ">
        <GeoRef Radius="5" UOM="MI"MaxResults="300" OffSet="1" Category="HOTEL">
        <GeoCode Latitude="12.8213" Longitude="77.6561"/>
        </GeoRef>
        <GeoAttributes>
        </GeoAttributes>
    </GeoSearchRQ>
</soap:Body>

Geo Search V4

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "GeoCode": {
        "Latitude": 12.8213,
        "Longitude": 77.6561
      }
    },
    "GeoAttributes": {}
  }
}

Search By AddressRef

Geo Search V1

<soap:Body>
    <GeoSearchRQ xmlns="http://services.sabre.com/util/geo/v1" xml
       ns: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/XMLSchemainstance" version="1"
       xsi:schemaLocation="http://services.sabre.com/util/geo/v1/GeoSearchRQ.xsd ">
        <GeoRef Radius="5" UOM="MI" MaxResults="300" OffSet="1" Category="HOTEL">
            <AddressRef Street="HiddenRidge" City="irving" PostalCode="75038" County="Dallas"
               StateProv="TX" CountryCode="US" />
        </GeoRef>
        <GeoAttributes>
        </GeoAttributes>
    </GeoSearchRQ>
</soap:Body>

Geo Search V4

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "AddressRef": {
        "Street": "Hidden Ridge",
        "City": "irving",
        "PostalCode": "PostalCode",
        "County": "Dallas",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    },
    "GeoAttributes": {}
  }
}

Search By RefPoint

Geo Search V1

<soap:Body>
    <GeoSearchRQ xmlns="http://services.sabre.com/util/geo/v1"
       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/XMLSchemainstance" version="1" xsi:schemaL
       ocation="http://services.sabre.com/util/geo/v1/GeoSearchRQ.xsd ">
        <GeoRef Radius="5" UOM="MI" MaxResults="300" OffSet="1" Category="HOTEL">
            <RefPoint Value="DFW" ValueContext="CODE" RefPointType="6"
               StateProv="TX" CountryCode="US" />
        </GeoRef>
        <GeoAttributes>
        </GeoAttributes>
    </GeoSearchRQ>
</soap:Body>

Geo Search V4

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "RefPoint": {
        "Value": "DFW",
        "ValueContext": "CODE",
        "RefPointType": "6",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    },
    "GeoAttributes": {}
  }
}

REST to REST Conversion (Geo Search V1 to Geo Search V4)

Search By GeoCode

Geo Search V1

{
  "GeoSearchRQ": {
    "version": "1",
    "GeoRef": {
      "Radius": 5,
      "MaxResults": 300,
      "OffSet": 1,
      "Category": "HOTEL",
      "UOM": "MI",
      "GeoCode": {
        "Latitude": 32.877416,
        "Longitude": -96.9598
      }
    }
  }
}

Geo Search V4

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "GeoCode": {
        "Latitude": 32.877416,
        "Longitude": -96.9598
      }
    },
    "GeoAttributes": {}
  }
}

SearchBy AddressRef

Geo Search V1

{
  "GeoSearchRQ": {
    "version": "1",
    "GeoRef": {
      "Radius": 5,
      "MaxResults": 300,
      "OffSet": 1,
      "Category": "HOTEL",
      "UOM": "MI",
      "AddressRef": {
        "Street": "Hidden Ridge",
        "City": "irving",
        "County": "Dallas",
        "PostalCode": "75038",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}

Geo Search V4

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "AddressRef": {
        "Street": "Hidden Ridge",
        "City": "irving",
        "PostalCode": "75038",
        "County": "Dallas",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    },
    "GeoAttributes": {}
  }
}

SearchBy RefPoint

Geo Search V1

{
  "GeoSearchRQ": {
    "version": "1",
    "GeoRef": {
      "Radius": 5,
      "MaxResults": 300,
      "OffSet": 1,
      "Category": "HOTEL",
      "UOM": "MI",
      "RefPoint": {
        "StateProv": "KA",
        "Value": "BLR",
        "RefPointType": "6",
        "CountryCode": "IN",
        "ValueContext": "CODE"
      }
    }
  }
}

Geo Search V4

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "RefPoint": {
        "Value": "BLR",
        "ValueContext": "CODE",
        "RefPointType": "6",
        "StateProv": "KA",
        "CountryCode": "IN"
      }
    },
    "GeoAttributes": {}
  }
}

Change in the response structure

There is a minor change in response structure that we observe in Geo Search V4 when compared to Geo Search V1.

  1. Geo Search V4 no longer returns the Links object as part of the response.

  2. In Geo Search V1, the GeoSearchRS objects were enclosed inside a Response object. This is no longer the case in Geo Search V4, wherein the response directly contains the GeoSearchRS object.

How to migrate the SOAP version?

Field Mapper with additional fields in Geo Search V4

Tags

GeoCode

Geo Search V1

  • Latitude (mandatory)
  • Longitude (mandatory)

Geo Search V4

  • Latitude (mandatory)
  • Longitude (mandatory)

AddressRef

Geo Search V1

  • Street (optional)
  • City (optional)
  • PostalCode (optional)
  • County (optional)
  • StateProv (optional)
  • CountryCode (mandatory)

Geo Search V4

  • Street (optional)
  • City (optional)
  • PostalCode (optional)
  • County (optional)
  • StateProv (optional)
  • CountryCode (mandatory)

RefPoint

Geo Search V1

  • Value (mandatory)
  • ValueContext (mandatory)
  • RefPointType (mandatory)
  • StateProv (optional)
  • CountryCode (optional)

Geo Search V4

  • Value (mandatory)
  • ValueContext (mandatory)
  • RefPointType (mandatory)
  • StateProv (optional)
  • CountryCode (optional)
  • CodeContext (optional)

Description of new tags

For CodeContext when RefPoint is set to "GLOBAL" Geo Search API searches for desired locations referring to a GLOBAL property. When set to "SABRE" Geo Search API searches for desired locations referring to a SABRE property valid for RefPointType= 11 (HOTEL_CODE).

Note: The default value for CodeContext is set to GLOBAL if uninitialized.

GeoRef

Geo SearchV1

  • Radius (mandatory)
  • Category (mandatory)
  • UOM (mandatory)
  • MaxResults (optional)
  • OffSet (optional)

Geo Search V4

  • Radius (mandatory)
  • Category (mandatory)
  • UOM (mandatory)
  • Direction (optional)
  • MaxResults (optional)
  • OffSet (optional)
  • ReturnNonAggregatorPropertiesOnly (optional)

Description of new tags

For ReturnNonAggregatorPropertiesOnly when set to true, returns both AGGR and SABRE_GDS PROPERTIES. When set to false returns only SABRE_GDS PROPERTIES.

Note: MaxResults All results which suffice given conditions will be displayed. OffSet is set to the value of "1" by default if uninitialized.

SOAP to SOAP Conversion (Geo Search V1 to Geo Search V4)

Request Conversion Examples

Request Body

Geo Search V1

<soap:Body>
    <GeoSearchRQ xmlns="http://services.sabre.com/util/geo/v1" xml
       ns: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/XMLSchemainstance" version="1"
       xsi:schemaLocation="http://services.sabre.com/util/geo/v1/GeoSearchRQ.xsd ">
        <GeoRef Radius="5" UOM="MI" MaxResults="300" OffSet="1" Category="HOTEL">
            <GeoCode Latitude="0.0" Longitude="0.0" />
            <RefPoint Value="DFW" ValueContext="CODE" RefPointType="6"
               StateProv="TX" CountryCode="US" />
            <AddressRef Street="HiddenRidge" City="irving" PostalCode="75038" County="Dallas"
               StateProv="TX" CountryCode="US" />
        </GeoRef>
        <GeoAttributes>
            <Attributes Name="CHAIN" Value="HY" />
            <Attributes Name="LOCALAREA" Value="KRAKOW AREA" />
        </GeoAttributes>
    </GeoSearchRQ>
</soap:Body>

Geo Search V4

<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/XMLSchemainstance" version="4"
       xsi:schemaLocation="http://services.sabre.com/util/geo/v5/GeoSearchRQ.xsd">
        <GeoRef Radius="5" UOM="MI" MaxResults="300" OffSet="1" Category="HOTEL"
           ReturnNonAggregatorPropertiesOnly="false">
            <GeoCode Latitude="0.0" Longitude="0.0" />
            <RefPoint Value="DFW" ValueContext="CODE" RefPointType="6" StateProv="TX"
               CountryCode="US" />
            <AddressRef Street="HiddenRidge" City="irving" PostalCode="75038" County="Dallas"
               StateProv="TX" CountryCode="US" />
        </GeoRef>
        <GeoAttributes>
            <Attributes Name="CHAIN" Value="HY" />
            <Attributes Name="LOCALAREA" Value="KRAKOW AREA" />
        </GeoAttributes>
    </GeoSearchRQ>
</soap:Body>

GeoRef

Geo Search V1

<GeoRef Radius="5" UOM="MI" MaxResults="300" OffSet="1" Category="
HOTEL">

Geo Search V4

<GeoRef Radius="5" UOM="MI" MaxResults="300" OffSet="1" Category="HOTEL"
   ReturnNonAggregatorPropertiesOnly="false”>

Search By GeoCode

Geo Search V1

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

Geo Search V4

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

SearchBy AddressRef

Geo Search V1

<AddressRef Street="HiddenRidge" City="irving" PostalCode="75038" County="Dallas" StateProv="TX"
   CountryCode="US" />

Geo Search V4

<AddressRef Street="HiddenRidge" City="irving" PostalCode="75038" County="Dallas" StateProv="TX"
   CountryCode="US" />

SearchBy RefPoint

Geo Search V1

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

Geo Search V4

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

Note: For more examples on SOAP requests to be used refer to the GeoSearchV4SampleRQ_GeoSearchv4SampleRS.zip

Summary

As part of migration, find the section YAML, WSDL, XSD request and response schema for reference.

REST Resources: Geo Search

SOAP Resources: Resources

Annexure

Sample Requests for Geo Search V4 API

RAIL

Request Type

Search for Rail Station Using Latitude Longitude

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "MaxResults": 300,
      "Category": "RAIL",
      "Radius": 10,
      "UOM": "MI",
      "GeoCode": {
        "Latitude": 45.73333333,
        "Longitude": 4.936111111
      }
    }
  }
}

Request Type

Search For Rail Station Using the Address

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "MaxResults": 300,
      "Category": "RAIL",
      "Radius": 200,
      "UOM": "MI",
      "AddressRef": {
        "Street": "Hidden Ridge",
        "City": "irving",
        "PostalCode": "75038",
        "County": "Dallas",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}

Request Type

Search for Rail Station Using the Airport Code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "RAIL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "CDG",
        "ValueContext": "CODE",
        "RefPointType": "6"
      }
    }
  }
}

Request Type

Search for Rail Station Using Sabre Hotel Code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "RAIL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "32632",
        "ValueContext": "CODE",
        "RefPointType": "11",
        "CodeContext": "SABRE"
      }
    }
  }
}

Request Type

Search for Rail Station Using Global Hotel Code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "RAIL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "100175712",
        "ValueContext": "CODE",
        "RefPointType": "11",
        "CodeContext": "GLOBAL"
      }
    }
  }
}

Request Type

Search for Rail Station Using Polygon ID

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "RAIL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "200005318",
        "ValueContext": "CODE",
        "RefPointType": "37"
      }
    }
  }
}

Request Type

Search for Rail Station Using POI Names

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "RAIL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "park",
        "ValueContext": "NAME",
        "RefPointType": "16",
        "CountryCode": "US"
      }
    }
  }
}

AIRPORT

Request Type

Search for Airport Using Latitude Longitude

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 100,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "GeoCode": {
        "Latitude": 12.821453330102875,
        "Longitude": 77.65606842325907
      }
    }
  }
}

Request Type

Search for Airport Using Addresses

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "AddressRef": {
        "Street": "Hidden Ridge",
        "City": "irving",
        "PostalCode": "75038",
        "County": "Dallas",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}

Request Type

Search for Airport Using Airport Code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "BLR",
        "ValueContext": "CODE",
        "RefPointType": "6"
      }
    }
  }
}

Request Type

Search for Airport Using Hotel Code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "RefPoint": {
        "Value": "100075140",
        "ValueContext": "CODE",
        "RefPointType": "11",
        "CodeContext": "GLOBAL"
      }
    }
  }
}

Request Type

Search for Airport Using Rail Station

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 10,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "RefPoint": {
        "Value": "HAMILTON CENTRAL",
        "ValueContext": "NAME",
        "RefPointType": "7"
      }
    }
  }
}

Request Type

Search for Airport Using Polygon ID

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "200010660",
        "ValueContext": "CODE",
        "RefPointType": "37"
      }
    }
  }
}

Request Type

Search for Airport Using POI Names

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 100,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Mustang Park",
        "ValueContext": "NAME",
        "RefPointType": "16",
        "CountryCode": "US"
      }
    }
  }
}

Request Type

Search for Airport Using City Names

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "AIR",
      "Radius": 100,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Dallas",
        "ValueContext": "NAME",
        "RefPointType": "5",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}

CAR

Request Type

Search for Car Station Using Latitude Longitude

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "CAR",
      "Radius": 100,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "Direction": "N",
      "GeoCode": {
        "Latitude": 59.60196,
        "Longitude": 16.62837
      }
    }
  }
}

Request Type

Search for Car Station Using Addresses

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "CAR",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "AddressRef": {
        "Street": "Hidden Ridge",
        "City": "irving",
        "PostalCode": "75038",
        "County": "Dallas",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}

Request Type

Search for Car Station using Airport code

Request Body

{
    "GeoSearchRQ": {
       "GeoRef": {
           "Category": "CAR",
            "Radius": 200,
           "UOM": "MI",
           "MaxResults": 300,
           "OffSet": 1,
           "RefPoint": {
           "Value": "DFW",
           "ValueContext": "CODE"
           "RefPointType": "6"
         }
       }
     }
   }

Request Type

Search for Car Station using Hotel code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "CAR",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "RefPoint": {
        "Value": "100114896",
        "ValueContext": "CODE",
        "RefPointType": "11",
        "CodeContext": "GLOBAL"
      }
    }
  }
}

Request Type

Search for Car Station using Rail Station

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "CAR",
      "Radius": 10,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "RefPoint": {
        "Value": "HAMILTON CENTRAL",
        "ValueContext": "NAME",
        "RefPointType": "7"
      }
    }
  }
}

Request Type

Search for Car Station using Polygon ID

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "CAR",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "RefPoint": {
        "Value": "200010660",
        "ValueContext": "CODE",
        "RefPointType": "37"
      }
    }
  }
}

Request Type

Search for Car Station using POI Names

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "CAR",
      "Radius": 100,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Mustang Park",
        "ValueContext": "NAME",
        "RefPointType": "16",
        "CountryCode": "US"
      }
    }
  }
}

Request Type

Search for Car Station using City Names

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "CAR",
      "Radius": 100,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Dallas",
        "ValueContext": "NAME",
        "RefPointType": "5",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}

HOTEL

Request Type

Search for Hotel using Global IDs

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "100113322",
        "ValueContext": "CODE",
        "RefPointType": "11",
        "CodeContext": "GLOBAL"
      }
    }
  }
}

Request Type

Search for Hotel using SABRE Hotel IDs

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "100831965",
        "ValueContext": "CODE",
        "RefPointType": "11",
        "CodeContext": "SABRE"
      }
    }
  }
}

Request Type

Search for Hotel using Polygon ID

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "200004616",
        "ValueContext": "CODE",
        "RefPointType": "37"
      }
    }
  }
}

Request Type

Search for Hotel using Airport code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "DFW",
        "ValueContext": "CODE",
        "RefPointType": "6"
      }
    }
  }
}

Request Type

Search for Hotel using City Name

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Dallas",
        "ValueContext": "NAME",
        "RefPointType": "5",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}

Request Type

Search for Hotel using POI (Postal Code)

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Washington Monument",
        "ValueContext": "NAME",
        "RefPointType": "16",
        "PostalCode": "20024"
      }
    }
  }
}

Request Type

Search for Hotel using POI and City Name

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 200,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Washington Monument",
        "ValueContext": "NAME",
        "RefPointType": "16",
        "CityName": "Washington"
      }
    }
  }
}

Request Type

Search for Hotel using Rail

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "HAMILTON CENTRAL",
        "ValueContext": "NAME",
        "RefPointType": "7"
      }
    }
  }
}

Request Type

Search for Hotel using Rail (City Name)

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 5,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "LenientSearch": false,
      "MaxSearchResults": 5000,
      "RefPoint": {
        "Value": "Gare du Nord",
        "ValueContext": "NAME",
        "RefPointType": "7",
        "CityName": "Paris"
      }
    }
  }
}

Request Type

Search for Hotel using Geo Code

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "Category": "HOTEL",
      "Radius": 100,
      "UOM": "MI",
      "MaxResults": 300,
      "OffSet": 1,
      "ReturnNonAggregatorPropertiesOnly": false,
      "Direction": "N",
      "GeoCode": {
        "Latitude": 37.77882,
        "Longitude": -5.38888
      }
    }
  }
}

Request Type

Search for Hotel using Address

Request Body

{
  "GeoSearchRQ": {
    "GeoRef": {
      "MaxResults": 300,
      "Category": "HOTEL",
      "Radius": 200,
      "UOM": "MI",
      "AddressRef": {
        "Street": "Hidden Ridge",
        "City": "irving",
        "PostalCode": "75038",
        "County": "Dallas",
        "StateProv": "TX",
        "CountryCode": "US"
      }
    }
  }
}