destinations-matching v9.2.1

About

This service provides the sub-string and fuzzy matching all the destinations where hotels can be booked. A destination is either a city, a region, or just a single hotel. Cities and regions are translated into 6 different locales: en_US, de_CH, es_ES, fr_FR, it_IT, nl_NL.

Resources

/doc

You're reading it.

/find

Gives suggestions based on the query string in the passed locale.

Examples:

• AJAX : /destinations-matching/find?locale=de_CH&query=bern
• JSONP: /destinations-matching/find?locale=de_CH&query=bern&callback=SOME_FUNCTION_NAME

Returns an array of suggestions. Each can be either a region, or a city, or a hotel.

Suggested region example:

{
    hotelsCount: 202
    id: "1007"
    name: "Region Berner Oberland"
    type: "region"
}

Suggested city example:

{
    hotelsCount: 29
    id: "Bern"
    name: "Bern"
    region: { id: "1007" }
    type: "city"
}

Suggested hotel example:

{
    city: "Samedan"
    id: "11283"
    name: "Hotel Bernina 1865"
    ratingStars: 4
    type: "hotel"
}

Constrained /find

It's possible to limit suggestions to results from a region, a city, or a group. For example:

• location=Ascona
• location=1001 -- that's Zurich Region
• location=group-engadin

Or to several regions, cities, or groups:

• location=Ascona&location=Locarno
• location=1001location=1005 -- those are the regions of Zurich and Basel
• location=group-rigi&location=group-wvrt

You can even go really creative and mix regions, cities, and groups together:

• location=group-sh&location=Winterthur&location=1003

Hotels, cities, and regions matching ANY of those location constraints (and the query, of course) will be returned.

City ID-s

Here's the comnplete list of cities as a JSON array.

Region ID-s

1006 - Grisons
1256 - Valais
1007 - Bernese Oberland
1001 - Zurich Region
1004 - Central Switzerland
1002 - Eastern Switzerland
1257 - Ticino
1255 - Lake Geneva Region
1258 - Berne Region
1005 - Basel Region
1259 - Geneva Region
1008 - Fribourg Region
1003 - Jura / Three-Lakes Region

Getting reconline-only results

Parameter inReconline limits suggestions to those which can be booked with reconline booking

• inReconline=true