Geo Search

The Geo Search API identifies airports or Sabre hotel(s) that fall within a given geographic search location using a radius search.

In detail: the API has three different types of location resolution: airport or multi-airport city (MAC) code, geo code (latitude and longitude) and place name, e.g., town or city name, with optional date and country code. Included in the request is also a parameter for defining the required radius search of up to 200 miles or kilometers along with the defined unit of measurement (miles or kilometers). The response will be the identified hotels (Sabre Property ID only) and the straight line distance between the resolved location and the designated Hotel.

API Information

Target Audience
Sabre Travel Network
Current Version
v1.0.0
Authentication
Sessionless Token
Method/Endpoint
POST /v1.0.0/lists/utilities/geosearch/locations?mode=geosearch HTTP/1.1 HTTP/1.1

Ready to try the APIs?

Ready to get your hands dirty?

 Register Try the APIs

Ready to launch?

Ready to step up to the production level service? We're standing by to fit you for your spacesuit.

Request Production Key

Resources

Example: request and response

Sample request

This example demonstrates a request for: a list of all hotels located within the specified radius and address.

POST https://api.sabre.com/v1.0.0/lists/utilities/geosearch/locations?mode=geosearch  HTTP/1.1
{
    "GeoSearchRQ": {
        "version": "1",
        "GeoRef": {
            "Category": "HOTEL",
            "Radius": 1.0,
            "UOM": "MI",
            "MaxResults": 300,
            "OffSet": 1,
            "AddressRef": {
                "Street": "Hidden Ridge",
                "City": "irving",
                "County": "Dallas",
                "PostalCode": "75038",
                "StateProv": "TX",
                "CountryCode": "US"
            }
        }
    }
}

Sample response

{
    "GeoSearchRS": {
        "ApplicationResults": {
            "Success": [
                {
                    "timeStamp": "2016-10-03T03:35:09.473-05:00"
                }
            ]
        }, 
        "GeoSearchResults": {
            "Radius": 1.0, 
            "UOM": "MI", 
            "Category": "HOTEL", 
            "Latitude": 32.877416, 
            "Longitude": -96.959879, 
            "MaxSearchResults": 18, 
            "OffSet": 1, 
            "GeoSearchResult": [
                {
                    "Distance": 0.24, 
                    "Latitude": 32.880778, 
                    "Longitude": -96.961008, 
                    "Name": "MARRIOTT EXECUSTAY BEAVER CREEK", 
                    "Id": "86034", 
                    "Street": "1000 Meadow Creek Drive", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "EE"
                    }
                }, 
                {
                    "Distance": 0.28, 
                    "Latitude": 32.881352, 
                    "Longitude": -96.961089, 
                    "Name": "HOMESTEAD DALLAS-LAS COLINAS", 
                    "Id": "42006", 
                    "Street": "5315 CARNABY STREET", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "EA"
                    }
                }, 
                {
                    "Distance": 0.45, 
                    "Latitude": 32.88242, 
                    "Longitude": -96.95483, 
                    "Name": "EXTENDEDSTAYDELUXE MEADOW CRK", 
                    "Id": "42911", 
                    "Street": "605 MEADOW CREEK DR", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "EA"
                    }
                }, 
                {
                    "Distance": 0.46, 
                    "Latitude": 32.879841, 
                    "Longitude": -96.952458, 
                    "Name": "CANDLEWOOD SUITES DALLAS", 
                    "Id": "52286", 
                    "Street": "5300 GREEN PARK DRIVE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "YO"
                    }
                }, 
                {
                    "Distance": 0.52, 
                    "Latitude": 32.88486, 
                    "Longitude": -96.96088, 
                    "Name": "TOWNEPLACE SUITES LAS COLINAS", 
                    "Id": "44599", 
                    "Street": "900 W WALNUT HILL LANE", 
                    "Zip": "75038-2613", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "TO"
                    }
                }, 
                {
                    "Distance": 0.52, 
                    "Latitude": 32.88486, 
                    "Longitude": -96.961448, 
                    "Name": "HAMPTON INN DALLAS LAS COLINAS", 
                    "Id": "37676", 
                    "Street": "820 WALNUT HILL LANE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "HX"
                    }
                }, 
                {
                    "Distance": 0.52, 
                    "Latitude": 32.88486, 
                    "Longitude": -96.961693, 
                    "Name": "WINGATE BY WYNDHAM LAS COLINAS", 
                    "Id": "30960", 
                    "Street": "850 W WALNUT HILL LANE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "WG"
                    }
                }, 
                {
                    "Distance": 0.54, 
                    "Latitude": 32.88486, 
                    "Longitude": -96.962509, 
                    "Name": "RESIDENCE INN LAS COLINAS", 
                    "Id": "21274", 
                    "Street": "950 WALNUT HILL LANE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "RC"
                    }
                }, 
                {
                    "Distance": 0.55, 
                    "Latitude": 32.883969, 
                    "Longitude": -96.95447, 
                    "Name": "EXTENDEDSTAYDELUXE LAS COLINAS", 
                    "Id": "43307", 
                    "Street": "5401 GREEN PARK DRIVE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "EA"
                    }
                }, 
                {
                    "Distance": 0.56, 
                    "Latitude": 32.884349, 
                    "Longitude": -96.95487, 
                    "Name": "HYATT PLACE DALLA LAS COLINAS", 
                    "Id": "43702", 
                    "Street": "5455 GREEN PARK DR", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "HY"
                    }
                }, 
                {
                    "Distance": 0.64, 
                    "Latitude": 32.884293, 
                    "Longitude": -96.952418, 
                    "Name": "FAIRFIELD INN LAS COLINAS", 
                    "Id": "41741", 
                    "Street": "630 W JOHN CARPENTER FREEWAY", 
                    "Zip": "75039", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "FN"
                    }
                }, 
                {
                    "Distance": 0.65, 
                    "Latitude": 32.88505, 
                    "Longitude": -96.96631, 
                    "Name": "COURTYARD LAS COLINAS", 
                    "Id": "17064", 
                    "Street": "1151 W WALNUT HILL LANE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "CY"
                    }
                }, 
                {
                    "Distance": 0.71, 
                    "Latitude": 32.88565, 
                    "Longitude": -96.96716, 
                    "Name": "STAYBRIDGE SUITES LA COLINAS", 
                    "Id": "48961", 
                    "Street": "1201 EXECUTIVE CIRCLE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "YZ"
                    }
                }, 
                {
                    "Distance": 0.8, 
                    "Latitude": 32.879112, 
                    "Longitude": -96.946169, 
                    "Name": "HOLIDAY INN EXP STES LAS COLI", 
                    "Id": "41673", 
                    "Street": "333 W JOHN CARPENTER FREEWAY", 
                    "Zip": "75039", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "HI"
                    }
                }, 
                {
                    "Distance": 0.85, 
                    "Latitude": 32.865174, 
                    "Longitude": -96.959835, 
                    "Name": "LA QUINTA IS LAS COLINAS", 
                    "Id": "4665", 
                    "Street": "4225 MACARTHUR BLVD", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "LQ"
                    }
                }, 
                {
                    "Distance": 0.86, 
                    "Latitude": 32.888959, 
                    "Longitude": -96.954356, 
                    "Name": "OAKWOOD AT GRAND VENETIAN", 
                    "Id": "56851", 
                    "Street": "6225 LOVE DRIVE", 
                    "Zip": "75039", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "IP"
                    }
                }, 
                {
                    "Distance": 0.95, 
                    "Latitude": 32.890227, 
                    "Longitude": -96.965772, 
                    "Name": "COMFORT SUITES LAS COLINAS", 
                    "Id": "2238", 
                    "Street": "1223 GREENWAY CIRCLE", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "CZ"
                    }
                }, 
                {
                    "Distance": 0.99, 
                    "Latitude": 32.863111, 
                    "Longitude": -96.960096, 
                    "Name": "FOUR SEASONS DALLAS", 
                    "Id": "12132", 
                    "Street": "4150 N MACARTHUR BLVD", 
                    "Zip": "75038", 
                    "City": "Irving", 
                    "State": "TX", 
                    "Country": "US", 
                    "Attribute": {
                        "name": "chain", 
                        "value": "FS"
                    }
                }
            ]
        }
    }, 
    "Links": [
        {
            "rel": "self", 
            "href": "https://api.sabre.com/v1.0.0/lists/utilities/geosearch/locations?mode=geosearch"
        }, 
        {
            "rel": "linkTemplate", 
            "href": "https://api.sabre.com/<version>/lists/utilities/geosearch/locations?mode=<mode>"
        }
    ]
}

Download Examples

Errors

A general HTTP status code is always returned. See the status codes and errors page for other common status codes and errors.

404 NOT_FOUND

No results were found.
The service cannot find data to fulfill the parameters in the request. For example, there is no data available for the dates specified.

400 BAD REQUEST

The request was not valid.
The service does not support the data used in the request. For example, origin or destination in the request is not a valid IATA airport code.

If you receive this error:

{
          status: "NotProcessed"
          type: "Validation"
          errorCode: "ERR.2SG.CLIENT.INVALID_REQUEST"
          timeStamp: "2016-05-20T11:43:34.599-05:00"
          message: "Request is invalid: Request payload is missing or it is not supported by the requested service"
        }
      

Ensure you:

  • have specified a content type header with a value of 'application/json'
  • are sending a JSON document in the HTTP POST's request body

Docs Navigation