Obtenez gratuitement le géocodage au niveau de lentreprise avec lAPI Positionstack (REVIEW)

Vous n'avez pas besoin d'être Google Maps pour tirer profit du géocodage. Et, grâce à Positionstack, vous n'avez pas non plus besoin du budget technologique du Big G pour le faire. Aujourd'hui, nous passons en revue l'API robuste de Positionstack, qui vise à rendre le géocodage avant et arrière au niveau de l'entreprise à la fois très abordable et utilisable.

Pile de positions 101

Alors, pourquoi devriez-vous vous embêter à lire une critique de plus de 2 000 mots sur Positionstack , et qu'est-ce que vous y gagnez ? La réponse semble mignonne, mais elle est exacte : le monde entier .

Considérez un instant combien il y a d'endroits sur la carte du monde. Maintenant, multipliez ce nombre dans votre tête par chaque élément de métadonnées que votre entreprise a besoin de connaître sur ces lieux. C'est ce que propose Positionstack, et plus encore.

Regardons quelques statistiques rapides sur Positionstack :

• Des milliards réels de demandes de recherche de géocodage traitées chaque heure, chaque jour ; avec 100% de disponibilité et < 100ms="" response="">
• Infrastructure cloud hautement évolutive
• Des données en temps réel sur tous les pays du monde, compilées dans un ensemble de données caverneux qui est mis à jour toutes les quelques heures
• Plans d'abonnement généreusement répartis et à prix compétitifs ; plus un quota mensuel inégalé de 10 000 demandes pour les utilisateurs gratuits
• Prise en charge de l'intégration pour tous les principaux langages de programmation
• Documentation complète et facile à lire avec des extraits de code
• Une équipe de satisfaction client de classe mondiale avec une expérience au service de clients comme Zendesk, Slack, LinkedIn, Lyft, Apple et Amazon

Positionstack a certainement son pedigree sous contrôle, mais au cas où vous ne seriez pas convaincu par une poignée de puces, examinons en profondeur ce que c'est que d'utiliser l'API.

Guide de démarrage rapide en 3 étapes de Positionstack

Si vous passez du temps sur leur site Web, vous verrez que Positionstack met vraiment l'accent sur la facilité d'utilisation comme principal argument de vente de leur API. Au cours du processus d'inscription, vous verrez immédiatement que c'est tout à fait vrai. En fait, la première chose que vous voyez après avoir saisi les informations d'identification de votre compte est une feuille de route rapide de ce qu'il faut pour être opérationnel avec Positionstack en trois étapes simples. Nous allons jeter un coup d'oeil:

1. Définissez votre clé d'accès API - Par défaut, vous recevez une clé d'accès prête à l'emploi. Cependant, vous pouvez facilement le réinitialiser en fonction de vos besoins.
2. Choisissez les points de terminaison d'API - Nous couvrons les points de terminaison d'API plus en détail dans la section suivante, mais pour l'instant, comprenez simplement que cette étape fait référence à la configuration du type de données renvoyées lorsque votre application fait une demande à Positionstack. C'est ici que vous verrez d'abord l'URL de base, qui est l'endroit où vous ciblez vos demandes, mais elle apparaît également dans la documentation. Enfin, nous voyons un exemple de requête API, qui se compose de quelques lignes de code simples.
3. Intégration de l'application – La dernière étape fait référence à l'intégration finale de l'API de Positionstack dans votre application. Il y a pas mal de choses à savoir sur ce processus, et la majeure partie est couverte dans la documentation. L'important ici est que l'équipe d'assistance de Positionstack vous soutient et vous offrira autant ou aussi peu d'aide dont vous avez besoin pour configurer et intégrer leur API dans votre application.

Assez facile non? Les API peuvent sembler intimidantes pour les personnes sans connaissances informatiques approfondies au début. Mais dès le départ, Positionstack vous réconforte en sachant que non seulement c'est facile, mais ils vous aideront tout au long du processus avec une documentation incroyable de leur conception intelligente. Cela les aide à avoir une équipe d'experts passionnés prêts à vous aider également.

Votre tableau de bord Positionstack

En doublant leur valeur fondamentale de convivialité, Positionstack propose un tableau de bord rationalisé et épuré à partir duquel vous pouvez accéder à tout ce que vous devez savoir sur votre API. Jetons un coup d'œil aux options de la barre latérale :

• Tableau de bord – Vous trouverez ici des notifications (généralement vous alertant lorsque vous dépassez certains seuils d'utilisation), puis des liens vers le guide de démarrage rapide en 3 étapes et leur page de documentation. Il y a aussi un aperçu de votre clé API, de votre abonnement actuel, des détails du compte et du mode de paiement.
• Mise à niveau/abonnement – Vous pouvez modifier votre abonnement sur l'une de ces deux options. Mettez à niveau à tout moment, mais si vous souhaitez basculer entre un plan mensuel ou annuel dans les deux sens, vous devrez d'abord passer à un compte gratuit, puis choisir l'option souhaitée. Le support de Positionstack est prêt à vous aider si vous avez besoin d'aide pour le faire.
• Compte/Paiement - Ceux-ci sont explicites ; l'un ou l'autre onglet vous permettra de mettre à jour vos informations d'identification à tout moment. Il faut dire qu'on apprécie qu'ils n'enfouissent pas ces commandes basiques dans une interface trop design et flashy. WYSIWYG.
• Utilisation de l'API - Probablement l'onglet que vous revisiterez le plus souvent, vous pouvez trouver ici la part de votre quota de demandes mensuelles que vous avez consommée jusqu'à présent. Il existe également une section pratique affichant vos statistiques d'utilisation au fil du temps, afin que vous puissiez ajuster votre stratégie en conséquence.

Documentation API

Passons maintenant au cœur et à l'âme de l'offre de Positionstack : la documentation de l' API . Considérez cette page comme votre manuel d'utilisation de référence, qui détaille chaque point de terminaison d'API, leurs paramètres et le type d'informations qu'ils renvoient.

Cette page est divisée en cinq sections différentes. Nous passerons en revue chacun d'eux, en consacrant un peu de temps et de verbiage pour vous fournir un contexte afin de mieux comprendre ce que vous trouverez.

Commencer

Ici, vous trouverez des fonctions de base qui s'appliquent à chaque demande que vous faites avec Positionstack. Ceux-ci sont:

• Clé API – Votre clé API est comme un passeport numérique que vous utiliserez pour accéder à l'ensemble de données de Positionstack. Sans elle, l'API vous est inutile. Si vous pensez qu'elle a été compromise, vous pouvez facilement remplacer votre ancienne clé par une nouvelle.
• Cryptage – Le cryptage SSL 256 bits est utilisé partout sur Internet et constitue la norme de l'industrie en matière de sécurité pour une bonne raison. Bien que vous ayez besoin d'un plan de base ou mieux pour crypter les communications de votre application avec les serveurs de Positionstack, cela vaut bien l'investissement à lui seul. Afin d'évoquer le cryptage, changez simplement HTTP en HTTPS dans l'URL de base de l'API. Simple!
• Rappels JSON - Nous n'entrerons pas dans trop de détails techniques sur la façon dont cela fonctionne, mais si vos demandes d'API sont bloquées par des politiques de même origine, vous utilisez des rappels JSON pour affecter une solution de contournement. Essentiellement, vous demandez des données à un script externe, qui ne s'enlise pas avec des problèmes inter-domaines.
• Erreurs d'API - Comme pour tout, vos demandes d'API se heurtent parfois à des erreurs. Positionstack le comprend et a intégré à son application une fonctionnalité de rapport d'erreurs pour vous aider à identifier ce qui n'a pas fonctionné. Les échecs de demande d'API renvoient automatiquement un objet d'erreur au format JSON, ainsi que des sous-objets de code, de message et de contexte pour fournir le contexte de l'erreur.

Points de terminaison d'API

Cette section documente la fonctionnalité viande et pommes de terre de Positionstack, c'est-à-dire le géocodage avant et arrière. Si vous n'êtes pas sûr à 100% de la différence, considérez le géocodage comme une rue à double sens où vous pouvez traduire des lieux et des adresses écrits en anglais simple en données de localisation telles que des coordonnées et des adresses IP, et vice-versa.

Ainsi, vous utiliseriez le géocodage avancé pour convertir l'emplacement de la tour Eiffel en coordonnées. De même, vous pouvez connaître l'adresse postale associée à une adresse IP en utilisant le géocodage inversé. Assez simple, après tout!

Requêtes de géocodage avant/arrière

Afin de faire une demande de base pour l'un ou l'autre type de géocodage, vous devrez ajouter le point de terminaison approprié ( /forward  ou /reverse ) à l'URL de base de l'API. Ensuite, vous fournirez votre clé d'accès, puis effectuerez une requête à l' aide d'une adresse de localisation en anglais simple ou de ses données de localisation correspondantes – et le tour est joué ! Cela ressemblera à quelque chose comme ceci :

https://api.positionstack.com/v1/forward
    ? access_key = YOUR_ACCESS_KEY
    & requête = 1600 Pennsylvania Ave NW, Washington DC

ou

https://api.positionstack.com/v1/reverse
    ? access_key = YOUR_ACCESS_KEY
    & requête = 40.7638435,-73.9729691

Bien sûr, l'ensemble de données de Positionstack contient bien plus que des adresses et des coordonnées. Vous pouvez analyser ces autres catégorisations à l'aide de divers paramètres. Voici un exemple de ce à quoi ressemble une requête de géocodage avancé , interrogeant la Maison Blanche :

{
   "Les données": {
      "résultats": [
         {
            "latitude": 38.897675,
            "longitude": -77,036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, États-Unis",
            "nom": "1600 Pennsylvania Avenue NW",
            "type": "adresse",
            "nombre": "1600",
            "street": "Pennsylvania Avenue NW",
            "code_postal": "20500",
            "confiance": 1,
            "région": "District de Columbia",
            "region_code": "DC",
            "administrative_area": ​​null,
            "quartier": "White House Grounds",
            "pays": "États-Unis",
            "country_code": "US",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

Fait intéressant, si vous deviez faire une demande de géocodage inversé en utilisant les coordonnées approximatives de la Maison Blanche, les résultats renvoyés seraient presque identiques, sauf que vous verriez également la différence de distance entre vos coordonnées et les coordonnées officielles de la Maison Blanche telles qu'elles apparaissent dans Positionstack base de données.

La raison de cette similitude est que les deux points de terminaison utilisent le même tableau de paramètres GET et sont donc capables de renvoyer (presque) les mêmes objets de réponse. Cela signifie que quelles que soient les données de départ que vous devez utiliser, vous pouvez obtenir en retour un complément complet de données de localisation. (Il est possible d'affiner ces résultats à l'aide du paramètre de champs de  l'API , mais nous y reviendrons plus tard.)

Remarque : La page de documentation de Positionstack détaille en détail chaque paramètre et objet de réponse, alors assurez-vous de le vérifier !

Demandes par lots

Le dernier titre majeur de ce paramètre de documentation traite des demandes par lots . Tout ce que vous avez à faire est d'appeler le paramètre batch  , puis d'imbriquer plusieurs instances de requête (avec vos paramètres souhaités) en dessous dans une seule requête, et l'API de Positionstack s'occupe du reste. C'est très simple, et ça ressemble à ça :

{
   "grouper":[
      {
         "query": "rue principale",
         "pays": "US",
         "région": "Minnesota"
      },
      {
         "query": "rue principale",
         "pays": "US",
         "région": "Illinois"
      },
      {
         "query": "rue principale",
         "pays": "US",
         "région": "Missouri"
      }
   ]
}

Données avancées

In addition to the basic location parameters, you can further tailor your API requests to return more advanced data. These include:

• Embeddable Maps – Returns a map_url object linked to your geocoding result, which you can use to create an attractive visual map representation on your website or app.
• Country Module – Unlike other parameters which return up to a few response objects, country_module returns an incredible array of data about your queried country. It’s not just coordinates and addresses, either; it’s the capital, flag, official name, status as a landlocked (or not) country, currencies used, languages spoken, calling codes, and more.
• Sun Module – Humorously, Positionstack’s documentation describes this as “Astrological” data. You won’t be getting your horoscope with this parameter, but you will see data about when the sun rises and sets, according to astronomical, civil, and nautical chronology.
• Timezone Module – Append timezone_module to return a location’s GMT offset in either seconds or as a natural language string.
• Bounding Box Module ­­– If a single x/y pair of coordinates isn’t right for your task, try a bounding box, which encloses an area with minimum and maximum values for longitude and latitude.

Additional Options

The Positionstack API has a ton of data to throw at you, but luckily it provides you with additional tools to manage this trove of information.

• Specify Response Fields – We’ve covered in depth how much data Positionstack can return, but keep in mind that all that data comes at a cost. If you want to limit your monthly requests, you can do that with the fields Appending fields = results.flag, for example, will cause the API to output only your queried country’s flag. You can invoke fields as many times as you need to get the specific dataset you require.
• Specify Output Format – Free subscribers are limited to the JSON format for their returned geocoding results. Paying customers, however, can append output on their requests to specify JSON, XML, or GeoJSON as necessary. 

Code Examples 

When Positionstack says they’re here to help you, they mean it. We’ve already seen how thorough their documentation is, but they top it off with handy code examples in all the languages their API supports. We’re not going to copy/paste that code here, but for quick reference, those languages are:

• Python
• Nodejs
• jQuery
• Go
• Ruby

Proof and performance

At this point, it should be clear that Positionstack is capable of doing quite a lot. But, how well does it do these things?

First, let’s consider some context. Positionstack is one of 20+ API microservices in Apilayer’s cloud-based ecosystem. Together, these APIs serve over a million B2B clients from startups all the way up to enterprise. Some of their most notable customers include Amazon, Apple, Slack, LinkedIn, and many more household names. Clearly, they’ve got some robust infrastructure to handle this scale of demand.

On its own merits, Positionstack lives up to its pedigree, with an incredible 100% uptime throughout 2020 at the time of writing. This is even more impressive when you consider the API routinely processes over a billion geocode lookups per day per whale client, not to mention the dizzying array of simultaneous requests coming from their stable of SMB customers. What’s more, these requests typically garner responses between 10 and 100 ms.

In our book, that’s something of a technological marvel, especially considering how aggressively priced this SaaS offering is.

And it’s not just raw power that makes Positionstack so appealing. Their dataset is truly sophisticated, sourced from reliable names like Nominatim, GeoNames, Pelias, and OpenStreetMap. Positionstack cross-checks, filters and recombines this wealth of data multiple times a day, pushing regular updates via smart algorithms that ensure you always have highly accurate location data, anywhere in the world, and in real time.

We hate to spoil our final verdict, but if you’re looking for a robust, scalable geocoding solution, Positionstack’s resume demands a closer look.

Pricing 

Apilayer set out to provide an affordable alternative to highly expensive enterprise-level geocoding software, and towards that end they have succeeded.

Positionstack comes in five pricing tiers, and supports monthly billing, or yearly subscriptions at a 20% discount. Those tiers are:

• Free – Rated for personal use, you’re still getting a good bit of mileage with 25,000 monthly requests for forward and reverse geocoding, outputted in the JSON format. You don’t get a lot of advanced features or customer support, but we’ve already shown you what a valuable resource their Documentation page is. This tier is free of charge, and free of obligation–you don’t even have to provide credit card details to get started.
• Basic – The entry-level commercial package. Basic subscribers quadruple their monthly quota to 100,000 geocoding requests, plus get access to advanced features like HTTPS encryption, multiple output options (JSON, XML, GeoJSON), embeddable maps, multiple languages, and more. Get a commercial Positionstack license for just $9.99 per month.
• Professional – Positionstack’s most popular offering, the Professional tier offers a tenfold increase in geocoding requests–up to 1,000,000 per month. All the goodies from the Basic tier are present and then some, notably including batch requests for heavy-duty applications. This tier clocks in at $49.99 per month.
• Business – Moving into enterprise-scale performance, the Business tier balloons the monthly quota to a whopping 3,000,000 requests. Once again, every advanced feature is fully available, backed by Positionstack’s passionate customer support team to help you get the most out of them. $99.99 per month.
• Enterprise – This is the tier in which standard offers go out the window, and the customer is king. You have precise needs that demand custom solutions, and Positionstack is at the ready to achieve your goals. You dictate your monthly volume requests, even (especially) if they’re variable. Need more horsepower from the API? Reach out to support for custom-built solutions. Contact Positionstack for a quote.

Verdict

Positionstack does precisely what it set out to do: bring enterprise-level geocoding down from price points otherwise out of budget to most SMBs, without sacrificing performance. Their API is well-documented and easy to use, but features robust integration across all major programming languages for maximum utility. The number of requests Positionstack routinely handles is staggering, while their dataset is smartly maintained for truly global reach in real-time geocoding. If you’re in the market for this type of product, don’t sleep on Positionstack.

What sort of integration do you have planned? How will you make use of geocoding in your business? Do you have any questions or comments on Positionstack? Leave us a note in the comments below.