One of the aspects users of our API like most is that we supply a
formatted response (see the docs). Open data sources like OpenStreetMap are a phenomenal resource, but precisely because people all over the world are adding all sorts of things all the time, it can be a bit of a burden for a developer to try to sift through everything and figure out how best to display a result to an end user. The problem grows in complexity as you start to consider multiple countries - the format that seems intuitive in country A is wrong in country B. Should that address contain the state or province? Does the postal code come before or after the city? If you want to provide a smooth service for your users these details need to be correct, but spending valuable developer time on them is very expensive. We solve it by using our open-sourced address-formatting templates.
As an example when you send us a query like
41.40139,2.12870 our response contains a
formatted value of
Carrer de Calatrava, 68, 08017 Barcelona, Spain.
This works well, but recently one of our clients asked if we could also abbreviate the response to make it easier to display in situations where screen space is limited, for example on a mobile device. We agreed - it makes more sense to solve this on our side than have each user reinvent the wheel. Last week we added support for a new optional parameter:
abbrv. When set, ie add
abbrv=1 to your query we attempt to abbreviate the formatted result.
The query above then returns:
C Calatrava, 68, 08017 Barcelona, Spain.
abbrv=1 added returns
5838 Ramsey St, Fayetteville, NC 28311, USA instead of the lengthier
5838 Ramsey Street, Fayetteville, NC 28311, United States of America.
For now, we only have abbreviations for a few languages. We’ll be adding more over time, but we obviously don’t speak every in the world. If you’d like your language please contribute.
We hope this new feature helps you save time and effort. Learn more about the various optional parameters you can send our API.
written from C Calatrava, 68, 08017 Barcelona, Spain