Geo Search
The Geo Search API identifies airports or Sabre hotel(s) that fall within a given geographic search location using a radius search.
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
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.
Ready to 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 KeyResources
- v1.0.0 Request Schema
- v1.0.0 Request Descriptions
- v1.0.0 Response Schema
- v1.0.0 Response Descriptions
Sample code
Request
This example demonstrates a request for: a list of all hotels located within the specified radius and address.
POST https://api.havail.sabre.com/v1.0.0/lists/utilities/geosearch/locations?mode=geosearch
{ "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" } } } }
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.havail.sabre.com/v1.0.0/lists/utilities/geosearch/locations?mode=geosearch" }, { "rel": "linkTemplate", "href": "https://api.havail.sabre.com/<version>/lists/utilities/geosearch/locations?mode=<mode>" } ] }
Download Examples
Errors
An HTTP status code is always returned. For information about the error response format, see the: Sabre APIs: errors page.
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
- APIs
- Workflows
- Air Extras Search and Book
- Auto Price Air Exchange
- Book Air Segment
- Book Hotel Reservation
- Car Reservation
- End-to-End Exchanges Workflow (Shop, Book, Price, Ticket)
- Issue Air Ticket
- Issue Electronic Miscellaneous Documents for Air Extras and Paid Seats
- Low Fare Search and Book
- Modify Passenger Name Record
- Post Booking Transaction
- Reserve Air Seats (including Paid Seats)
- Sessionless and Session Tokens
- API Roadmap
- 2017 API Roadmap
- Security
- REST APIs
- SOAP APIs
- Air
- Search
- Air Availability
- Air Schedules And Availability
- Bargain Finder Max
- Basic Fare Shop
- Calculate Air Mileage
- Flight Schedules
- Get Air Connection Points
- Get Air Connection Times
- Get Ancillary Offers (Travel Agency)
- Get Brand Marketing Text
- Get Flight Details
- Get Seat Map Counts
- Revalidate Itinerary
- Shop by Specific Fare
- Shop Exchange Options
- Book
- Air Fare by City Pairs
- Air Fare Rules
- Air Fare Rules from Price
- Book Air Segment
- Book from Air Availability
- Calculate Air Tax for Itinerary
- Cancel Air Seat
- Cancel Itinerary Segments
- Create Passenger Name Record
- Delete Price Quote
- Display Price Quote
- Fare Rules from Air Price
- Flight Details
- Orchestrated Air Booking
- Price Air Itinerary
- Price with Itinerary
- Price With Multiple Brands
- Price Without Itinerary
- Reserve Air Seat
- Seat Map
- Sell Miscellaneous Segments
- Fulfill
- Auto Price Air Exchanges
- Create Manual Price Quote Ticket Record
- Create PhaseIV Ticket Record
- Display Audit Trail
- Enhanced Air Ticket
- Exchange Booking
- Get Credit Card Approval
- Get EMD Documents
- Get EMD Transactions
- Get eTicket Details
- Get Refund Report
- Get Unused eTickets
- Issue Air Ticket
- Revalidate eTicket
- Void Air Ticket
- Travel
- Utility
- Search
- Cruise
- Ground transportation
- Hotel
- Profiles
- Session Management
- Trip Management
- Itinerary
- Itinerary Common Resources
- Add Arrival Unknown Segment
- Add Accounting Line
- Add Itinerary Info
- Add Itinerary Remark
- Add Special Service
- Build Invoice and Itinerary
- Build Profile from Itinerary
- Create Itinerary
- Delete Special Service
- Divide Itinerary
- End Transaction
- Get ERP TripData
- Get ERP TripLocator Data
- Get Itinerary
- Get Itinerary History
- Get Itinerary Reports
- Ignore Transaction
- Modify Itinerary
- Modify Itinerary Remark
- Passenger Details
- Reconfirm Reservation
- Retrieve Itinerary
- Search for Itineraries
- Update Itinerary
- Verify Itinerary Address
- Queues
- Trip Proposal
- Utility
- Itinerary
- Air
- Digital Connect Service Engine
- SabreSonic APIs
- SOAP APIs
- Check-In
- Add Bag Tag Printer
- Add Boarding Pass Printer
- Add to Standby List
- Check-in Passenger
- Get Ancillary Offers
- Get Bag Messages
- Get Flight Information
- Get Passenger Data
- Get Passenger List
- Get Seat Map
- Issue Bag Tag
- Reprint Boarding Pass
- Request Seat Change
- Return Seat to Inventory
- Search by Specific Airport
- Select or Change Seat
- Update Passenger Details
- Update Passenger Security Information
- Customer Insight
- Exchanges
- Inventory
- Loyalty
- Payments
- Select Shop
- Ticketing
- Utility
- Check-In
- SOAP APIs
- Travel Insight APIs