Pelias version in API URL?


#1

Hi, I’m trying to implement an adapter for ORS in the famous geocoder-php library (https://github.com/geocoder-php/Geocoder). I see that the geocoding API endpoint does not use any version number in the URL, instead of what Pelias does (/v1/search/…). I guess your are using version 1, as it seems to be the only one available for now. If you switch to v2 in the future, what will happen to URL format?

Github pull request: https://github.com/geocoder-php/Geocoder/pull/1026#discussion_r336372967

Thank you in advance,


#3

Sorry @amandus, gotta correct you here:

We’ll then finally add a /v2 to the path. Otherwise it’ll break all existing clients who request the API. Since likely a v2 will introduce breaking changes or there’s little point to a version upgrade.

But no worries, it will be fine @gaelg:)