Searches static POI matching criteria given as parameters. POI are hosted at ViaMichelin in a database.



xml, json


A proximity search = Charged request (whetever the number of results)


1.0 Added to REST API


Input settings

NameMandatory?Data typeDescriptionDefault
db yes string Database unique identifier (given by ViaMichelin) N/A
lg yes string Language code (fra, deu, spa, ita, eng, ces, dan, nld, fin, int, nor, pol, por, swe) N/A
c[i] no integer Filter on the result dataset according to the value of the numeric metadata [i]. This parameter can be multi-valued. The semantics of the metadata is specific to each database of POIs.
For example if you want to get POIs with metanum 1 set to 1 and metanum 2 set to 1 or 2, you write ...&c1=1&c2=1; 2&....
name no string Filter on POIs name. Several words are seperated by '+' in URL.
See also textMode parameter.
text no string Filter on a string (full text search). Several words are seperated by '+' in URL.
See also textMode parameter.
nb no positive integer Number of returned POI (from 1 to 100). 20
sidx no positive integer Allows pagination by specifying index of the first returned POI in the dataset.
For example, if sidx=2 and nb=3, answer contains only the sub POI list from the 3rd to the 5th rank.
-1 (no pagination)
geobounds no float;float;float;float Filter on geographic emprise as minLon:minLat:maxLon:maxLat. empty
countryLst no string Filter on country of POIs. This parameter can be multi-valued. empty
zipLst no string Filter on postal codes of POIs. This parameter can be multi-valued. empty
textMode non 0: OR | 1: AND Search mode applied to multi-valued name and text parameterss.
OR: only POIs containing at least one of the words are returned.
AND: only POIs containing all words are returned.
orderBy no c[1-50] Identifier of the metanum used to sort POIs.
See also orderDir parameter.
orderDir no asc | desc Sort ordering (ascending or descending) for metanum set in orderBy parameter. asc
authkey yes string Authentication key. This could be a JS key, a token generated by the token function, or the client's id if request is signed (see signature parameter). N/A
signature no string Request signed with the HMAC-SHA1 method where client's password is the secret key. If request signed, authKey must be valued with client's id, and expires must also be valued. URL strings must be URL-encoded before signing. empty
expires no except if signature valued date Expiration GMT date in yyyy-MM-dd'T'HH:mm:ss.SSS`'Z format. vide
callback yes if json string Callback function name (applied only if output is json) empty
charset no string Response encoding charset 'ISO-8859-1'
ie no string Request encoding charset 'ISO-8859-1'



  • Max POIs returned by request is limited at 100 POIs per request. 

Request samples


Response structure

  • A structure of poiList open in new tab

Please note that unexplained data fields are intended for internal ViaMichelin use only. These can change at any moment and should not be considered for use. Their existence highlights the fact that ViaMichelin uses the same services and technical infrastructure internally as its business clients.

Retour haut de page