VIAMICHELIN REST API


Guide MICHELIN (Hôtels et Restaurants)

 

FindPoi Guide MICHELIN - Hôtels et Restaurants

Description : 

Cette fonction recherche les POI (Points Of Interest) de type Restaurants ou Hôtels à proximité d'un lieu déja géocodé. Elle retourne une liste de POIs statiques (POIs Guide MICHELIN "Hôtels et Restaurants"), ordonnée par distance croissante par rapport au centre de recherche. 

La recherche s'effectue à vol d'oiseau.

 

URL

http://apir.viamichelin.com/apir/2/findPOI.{format}/{type}/{lg}?center=<center>&authKey=<authKey>&[dist=<dist>]&[distRange=<distRange>]&[nb=<nb>]&[nbRange=<nbRange>]&[sidx=<sidx>]&[filter=<filter>]&[field=<field>]&[source=<source>]&[orderby=<orderby>]&[charset=<charset>]

 

Format de sortie

XML, JSON

NB: 

Pour les résultats en JSON, il faut utiliser findPOI.json2


Version du service

Version Libellé 
2.0 MICHELIN REST API

 

 Paramètres d'entrée

Nom Type Valeur Description

Obligatoire?

Défaut

Min/Max

 format   String  XML, JSON2   Format de retour   YES  N/A  N/A
 type  String  HOTEL / RESTAURANT 

 Préciser le type de  POI à rechercher :  Hôtels ou Restaurants

NB:

N'oubliez pas de changer les paramètres obligatoires "FILTER" & "SOURCE" selon votre recherche de POI

 YES  N/A  N/A
 lg  String

 fra, deu, spa, ita, eng, ces, dan, nld, fin, int, nor, pol, por, swe, ron, tur, rus, zho, zhn, jpn, prt

.../2/findPOI.xml/HOTEL/eng? 

 

 La langue du résultat

 YES  N/A  N/A
 center  float : float

 center= <longitude> : <Latitude> 

 center=2.35:48,85

 Centre de la recherche spécifié sous la forme longitude:latitude exprimé en degrés décimaux.

 YES  N/A  N/A
 authkey  String  &authkey=YourAuthKey

 

Clef d'authentification. Cela peut-être une clef JS, un token généré par la fonction token ou l'identifiant du client en cas de la signature de la requête.

 

 YES  N/A  N/A
dist  Positive integer

  dist = X

 dist = 15000

 

Rayon de recherche autour du centre en mètre (de 1000 à 200 000)

 

 NO  20000  1000 & 200 000
distRange

Positive integer : positive intéger 

 distRange=X:Y

distRange=10000:50000

X et Y sont en mètre

 

Si le paramètre dist est utilisé, distRange sera automatiquement ignoré.

 distRange indique si la recheche continue même si le minimum (nb param) n'est pas atteint. La recherche s'étendra jusqu'à ce que le rayon de recheche atteint la valeur Y.

 

 NO  N/A

 X : MIN = 1000

Y : MAX = 200000 

nb  Positive integer

 nb = X

 nb=50

 

Le nombre de POI attendus (de 1 à 100).

 

 NO

 N/A  20
 sidx   positive integer 

 sidx=X

 sidx=5

 

Ce paramètre permet la pagination en spécifiant l'index du premier POI retourné dans l'ensemble des POI retourné dans l'ensemble des POIs trouvés.

Par exemple, Si sidx=2 et nb=3, la réponse contient uniquement les POIs de rang 3 à 5.

 

 NO  N/A  N/A
 filter  String

 filter=(no_dog eq 1)

 

 filter=(no_smoke eq 1)

 

 filter = (categories_full_ranges in [3,4])

 

 filter = (michelin_stars ge 1)

 

filter=(cooking_type eq RST-CRE)

 Définir les critères de restriction de la recherche. 

Pour les Hôtels :

-> filter=AGG.provider eq HOTGR

Pour les restaurants :

-> filter = AGG.provider eq RESGR 

NB:

N'oubliez pas de changer les paramètres obligatoires "TYPE" & "SOURCE" selon votre recherche de POI

----

Permet de filtrer la liste des résultats selon des critères spécifiques.

----

Plusieurs critères peuvent être appliqués en utilisant un opérateur logique, comme AND ou OR

filter=<fieldName><operator><value>

fieldName spécifie quel champ sera utilisé pour filtrer.

<field_name>: disponible pour les filtres  voir la liste

<operator>: spécifier l'opérateur à utiliser :

- eq (equals)

- ne (not equal)

- gt (greater than)

- ge (greater than or equal)

- lt (less than)

- le (less than or equal)

- in (followed by list values between [X] and separed by ";" or ",")

- is null (equals zero)

- is not null (not equals zero)

 YES  N/A   N/A
field  String

 field=<description>,X, 

field=name,email, X

 Retourne uniquement les champs spécifiés.   NO  N/A  N/A
source  String 

 source = RESGR

 source = HOTGR

 Définit sur quelle base (hôtels ou restaurants) la recherche sera effectuée. 

NB:

N'oubliez pas de changer les paramètres obligatoires "FILTER" & "TYPE" selon votre recherche de POI

 YES  ALL  N/A
orderby  String

orderby=<source>.<fieldname>:<sortDirection>

orderby= HOTGR.categories_full_ranges:asc

or

orderby = HOTGR.categories_full_ranges:desc 

Définit les règles de tri qui seront appliquées à la liste des résultats.

<field_name> available for sorting :

hotels_stars / categories_full_ranges / price_classification / michelin_stars / rating 

<sortDirection> available : 

asc / desc

 

 NO  ASC  N/A
 chareset  String  charset=UTF-8 Encodage des caractères dans la réponse.  YES  UTF-8  N/A
 ie  String  ie=UTF-8 Encodage des caractères dans la requête.  YES  UTF-8  N/A

 

 

 

Filtres Hôtels et Restaurants

<Tag_name>   Description
 Meaning / Values  
<cooking_type>  Types de cuisines disponibles

 

 Chinois : WLD-ASI-CHN
 Moderne/ Creatif : RST-CRE
 Italien : WLD-EUR-ITA
 Classique / Traditionnel : RST-TRD
 Brasserie, Bistrot, Bar à vin en France : WLD-EUR-FRA-LYO 
 Viande, Grillades : RST-MEA
 Japonais : WLD-ASI-JPN
 Espagnol : WLD-EUR-ESP
 Allemand : WLD-EUR-GER
 Français : WLD-EUR-FRA 
 Méditerranéen : WLD-EUR-ITA-MED
 Anglais : WLD-EUR-GBR-ENG
 Poissons, Fruits de mer : RST-FSH
 Indien : WLD-ASI-IND
 International : RST-GSTC

 

 MG: fra? / GG : lg=fra  Langues disponibles

fra (Français)
deu (Allemand)
eng (Anglais)
ita (Italien)
nld (Néerlandais)
pol (Polonais)
por (Portugais)
spa (Espagnol)
ces (Tchèque)
dan (Danois)
fin (Finnois)
int (English international)
nor (Norvégien)
swe (Suédois)
tur (Turque)
ron (Roumain)
zho (Chinese)
zhn (Chinese Nong zhuang)
jpn (japonais)
prt (Brazilian Portuguese )
rus (Russian)

<name> Restaurant - place - Hotel - Chef  Chaine de caractères 
<price_classification>   Prix

 1/ Moins de 50 EUR
 2/ Entre 50 et 70 EUR
 3/ Entre 70 et 90 EUR
 4/ Entre 90 et 130 EUR
 5/ Supérieur à 130 EUR

<categorie_full_ranges>  Confort 

 2/Assez confortable (1 fourchette)
 3/Confortable (2 fourchettes)
 4/Très confortable (3 fourchettes)
 5/Grand confort (4 fourchettes)
 6/Grand luxe et tradition (5fourchettes)

<michelin_stars>  Restaurants étoilés dans le guide MICHELIN  [0 ; 1 ; 2 ; 3]
<breakfast>  Possibilité de servir le petit déjeuner  0 (NO) / 1 (YES)
<breakfast_price_included>  Le prix du petit déjeuner est inclus dans le prix de la chambre  0 (NO) / 1 (YES)
<brunch>  Brunch   0 (NO) / 1 (YES)
<air_conditioning>   Climatisation  0 (NO) / 1 (YES)
<aquatic>  Piscine  0 (NO) / 1 (YES)
<bib_gourmand>  Bonne table à prix modéré   0 (NO) / 1 (YES)
<cocktail>  Possibilité de servir les cocktails  0 (NO) / 1 (YES)
<conférence_hall>  Salle de conférence disponible  0 (NO) / 1 (YES)
<disabled_room>  Chambre pour handicapés  0 (NO) / 1 (YES)
<eat_late>  Manger tard  0 (NO) / 1 (YES)
<for_children>  Espace dédié aux enfants  0 (NO) / 1 (YES)
<garden>  Espace jardin  0 (NO) / 1 (YES)
<good_value_menu>  Menu à moins de 20 EUR   0 (NO) / 1 (YES)
<hydrotherapy>  Service de thérapie  0 (NO) / 1 (YES)
<interesting_wine_list>  Avec une cartes des vins offrant un choix particulièrement attractif  0 (NO) / 1 (YES)
<michelin_guide_selection>  Hôtel / Restaurant séléctionné par le Guide MICHELIN  0 (NO) / 1 (YES)
<parking>  Présence de parking  0 (NO) / 1 (YES)
<pleasant>  Réstaurant agréable  0 (NO) / 1 (YES)
<quiet>  Hôtel tranquille  0 (NO) / 1 (YES)
<sake>  Disponibilité du saké  0 (NO) / 1 (YES)
<sport>  Disponibilité des infrastructures sportives
 0 (NO) / 1 (YES)
<valet>  Disponibilité de service valet  0 (NO) / 1 (YES)
<no_dog>  Accès interdit aux chiens  0 (NO) / 1 (YES)
<no_smoke>  Interdit de fumer  0 (NO) / 1 (YES)

 

Règles éditoriales et icones 

Pour accéder aux régles éditoriales du guide MICHELIN (Hôtels et Restaurants) et au téléchargement des icones, merci d'utiliser les identifiants qui vous sont fournis par SUPPORT MICHELIN (login: XXXX_001 / password: XXXX) et aller sur la section Documentation:

http://www.admin.viamichelin.com/ 

 

Exemples

Scénario 1:

Rechercher 30 hôtels du Guide MICHELIN sur un rayon de 1.5 km autour du centre X,Y représtant Paris 75000. Langue souhaitée : l'anglais. 

http://apir.viamichelin.com/apir/2/findPoi.xml/HOTEL/eng?center=2.35:48.85&nb=30&dist=1500&source=HOTGR&filter=AGG.provider%20eq%20HOTGR&charset=UTF-8&ie=UTF-8&authKey=YourAuthKey 

 

Scénario 2 :

Rechercher 10 restaurants du Guide MICHELIN sur un rayon de 1 km autour du centre X, Y représentant Paris 75000. Langue souhaité : l'anglais.

http://apir.viamichelin.com/apir/2/findPoi.xml/RESTAURANT/eng?center=2.35:48.85&nb=10&dist=1000&source=RESGR&filter=AGG.provider%20eq%20RESGR&charset=UTF-8&ie=UTF-8&authKey=YourAuthKey