VIAMICHELIN REST API


pixelstoxy

Description

Converts pixel coordinates into geographic coordinates for a given map.

URL

http://apir.viamichelin.com/apir/1/pixelsToXY.{output}/{mapid}/{size}?coords={coords}&authkey={authkey}&charset={charset}&ie={ie}&callback={callback}&signature={signature}

Format

xml, json

Billing

A processed request = charged request (whatever the number of converted coordinates)

Changelog

VersionDescription
1.0 Added to REST API

 

Input settings

NameMandatory?Data typeDescriptionDefault
mapid yes string Unique identifier of a map. N/A
size yes positive int:positive int Map dimensions as width:height. N/A
Coords yes float:float Pixel coordinates as x:y to convert into geographic coordinates of the map longitude:latitude. Origin point is in the top left corner of the map. Multiple coordinates are accepted. N/A
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'

 

Constraints

  • Only WGS84 coordinates are accepted as parameters.
  • No more than 1000 coordinates can be requested at once.
  • mapid> can only be those returned by other ViaMichelin services.
  • Image width and height cannot exceed 1.500px.

 

Request samples

 

Response structure

  • A structure of geocoordList 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