GetLocations

Travolutionary provides you with auto-complete Locations Service, which allows you to populate location names based on a short string as a parameter (3 letters minimum).

Request Field	Definition
Request	The location's name, it is recommended to enter the full city name, the minimum is 3 characters.
Type	Hotels / Flights / Cars / etc.
Limit	Limit number of results, the maximum value is 30
IncludeGeoDataInfo	Boolean, decides whether the location's geolocation will be provided as well.

Response Field	Definition
Code	The location's ISO2 Country code
ID	The location's Travolutionary ID
Name	Location's full name
Latitude	Applicable only for flights, and if IncludeGeoDataInfo was set to true, the location's latitude
Longitude	Applicable only for flights, and if IncludeGeoDataInfo was set to true, the location's longitude

Send the POST request to the following endpoint:
http://services.carsolize.com/BookingServices/LocationsService.svc

With the following headers:
Content-Type: text/xml
SOAPAction: "http://tempuri.org/ILocationsServiceContract/GetLocations"

Example Airport Request

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
 <GetLocations xmlns="http://tempuri.org/">
 <request>JFK</request>
 <type>Flights</type>
 <limit>99</limit>
 <includeGeoDataInfo>true</includeGeoDataInfo>
 </GetLocations>
</s:Body>
</s:Envelope>

Example Airport Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
 <s:Body>
 <GetLocationsResponse xmlns="http://tempuri.org/">
 <GetLocationsResult>
 <a:LocationView>
 <a:Code>US</a:Code>
 <a:ID>JFK1</a:ID>
 <a:Lat>40.63980103</a:Lat>
 <a:Lng>-73.77890015</a:Lng>
 <a:Name>New York, NY, United States - john f kennedy (JFK)</a:Name>
 </a:LocationView>
 </GetLocationsResult>
 </GetLocationsResponse>
 </s:Body>
</s:Envelope>

Example Hotels Request

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
 <GetLocations xmlns="http://tempuri.org/">
 <request>new york</request>
 <type>Hotels</type>
 <limit>99</limit>
 <includeGeoDataInfo>true</includeGeoDataInfo>
 </GetLocations>
</s:Body>
</s:Envelope>

Example Airport Response

<a:LocationView>
 <a:Code>US</a:Code>
 <a:ID>644158</a:ID>
 <a:Lat>40.75668</a:Lat>
 <a:Lng>-73.98647</a:Lng>
 <a:Name>New York, NY, United States</a:Name>
</a:LocationView>