Bénéficiez gratuitement d’un géocodage de niveau entreprise avec l’API Positionstack (FIX)

0 468 8 minutes de lecture

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

Pile de positions 101

Alors, pourquoi devriez-vous vous donner la peine de lire une critique de plus de 2000 mots sur Positionstack , et que pouvez-vous gagner? La réponse semble bien, mais elle est exacte: le monde entier .

Considérez un instant le nombre de lieux 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 de demandes de recherche de géocodage traitées chaque heure, chaque jour; avec un temps de disponibilité de 100% et des temps de réponse <100 ms
Infrastructure cloud hautement évolutive
Données en temps réel de tous les pays du monde, collectées dans un vaste ensemble de données mis à jour toutes les quelques heures.
Plans d’abonnement généreusement distribués et à des prix compétitifs; plus un tarif mensuel imbattable de 10000 demandes d’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 tels que 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 balles, plongeons-nous dans ce que c’est vraiment d’utiliser l’API.

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

Si vous passez du temps sur votre site Web, vous verrez que Positionstack met vraiment l’accent sur la facilité d’utilisation en tant que principal argument de vente de son API. Pendant le 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 entré les informations d’identification de votre compte est une feuille de route rapide de ce qu’il faut pour démarrer avec Positionstack en trois étapes faciles. Nous allons voir:

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 ultérieurement si nécessaire.
Choisissez les points de terminaison d’API – Nous abordons plus en détail les points de terminaison d’ API dans la section suivante, mais pour l’instant, comprenez simplement que cette étape se réfère à la configuration du type de données renvoyées lorsque votre application fait une demande à Positionstack. C’est là que vous verrez d’abord l’URL de base, c’est là que vous dirigez vos demandes, mais elle apparaît également dans la documentation. Enfin, nous voyons un exemple de requête d’API, composé de quelques lignes de code.
Intégration d’application – La dernière étape concerne l’intégration finale de l’API Positionstack dans votre application. Il y a beaucoup à savoir sur ce processus, et la majeure partie est couverte dans la documentation. L’essentiel ici est le suivant: l’équipe de support de Positionstack est derrière vous et vous offrira autant ou peu d’aide que vous en avez besoin pour configurer et intégrer leur API dans votre application.

Assez facile, non? Les API peuvent sembler intimidantes aux personnes sans connaissances informatiques approfondies au début. Mais dès le début, Positionstack vous rassure en sachant que ce n’est pas seulement facile, 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ête à vous aider également.

Votre panneau Positionstack

Doublant sa valeur fondamentale de facilité d’utilisation, Positionstack propose un tableau de bord simplifié et épuré à partir duquel vous pouvez accéder à tout ce que vous devez savoir sur son API. Jetons un coup d’œil aux options de la barre latérale:

Tableau de bord – Vous trouverez ici des notifications (qui vous alertent généralement lorsque vous dépassez certains seuils d’utilisation), puis des liens vers le Guide de démarrage rapide en 3 étapes et sa page de documentation. Il existe également un aperçu de votre clé API, de votre abonnement actuel, des détails du compte et du mode de paiement.
Surclassement / abonnement: vous pouvez modifier votre abonnement dans l’une de ces deux options. Mettez à niveau à tout moment, mais si vous souhaitez basculer entre un forfait 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 cela.
Facture / Paiement: explicite; l’un des onglets vous permettra de mettre à jour vos informations d’identification à tout moment. Il faut dire que l’on apprécie qu’ils ne cachent pas ces contrôles basiques dans une interface flashy et sur-conçue. WYSIWYG.
Utilisation de l’API – Probablement l’onglet que vous reviendrez le plus souvent, vous trouverez ici le montant de vos frais de dossier mensuels que vous avez consommés jusqu’à présent. Il existe également une section utile qui affiche vos statistiques d’utilisation au fil du temps, afin que vous puissiez ajuster votre stratégie en conséquence.

Documentation API

Nous arrivons maintenant au cœur et à l’âme de l’offre Positionstack: la documentation de l’ API . Considérez cette page comme votre manuel utilisateur de référence, détaillant chaque point de terminaison d’API, ses paramètres et le type d’informations qu’ils renverront.

Cette page est divisée en cinq sections différentes. Nous allons passer en revue chacun d’entre eux, passer du temps et du verbiage pour vous fournir un contexte afin de mieux comprendre ce que vous trouverez.

Départ

Vous trouverez ici les 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 Positionstack. Sans cela, l’API est inutile pour vous. Si vous pensez qu’elle a été compromise, vous pouvez facilement faire pivoter votre ancienne clé vers une nouvelle.
Cryptage: le cryptage SSL 256 bits est utilisé partout sur Internet et constitue la norme de sécurité de l’industrie pour une bonne raison. Bien que vous ayez besoin d’un plan de base ou supérieur pour crypter les communications de vos applications avec les serveurs Positionstack, cet investissement en vaut la peine. Pour évoquer le chiffrement, changez simplement HTTP en HTTPS dans l’URL de base de l’API. Facile!
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, utilisez les rappels JSON pour affecter une solution de contournement. Essentiellement, il demande des données à un script externe, qui ne s’enlise pas dans des problèmes interdomaines.
Erreurs d’API – Comme pour tout, vos demandes d’API rencontreront parfois des erreurs. Positionstack comprend cela et a intégré une fonction de rapport de bogue pour vous aider à identifier ce qui ne va pas. Les erreurs de demande d’API renverront automatiquement un objet d’erreur au format JSON, ainsi que des sous-objets code, message et contexte pour fournir le contexte de l’erreur.

Points de terminaison API

Cette section décrit la fonctionnalité viande et pommes de terre de Positionstack, c’est-à-dire le géocodage direct et inversé. 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 clair en données de localisation telles que des coordonnées et des adresses IP, et vice versa.

Vous utiliseriez donc le géocodage direct pour convertir l’emplacement de la tour Eiffel en coordonnées. De même, vous pouvez trouver l’adresse postale associée à une adresse IP en utilisant le géocodage inversé. Assez simple, après tout!

Demandes de géocodage directes / inversées

Pour effectuer une demande de base pour tout type de géocodage, vous devrez ajouter le point de terminaison approprié ( / en avant ou en arrière ) à l’URL de l’API de base. Vous fournirez ensuite votre mot de passe, puis ferez une demande en utilisant une adresse de localisation en anglais simple ou les détails de votre emplacement correspondant, et le tour est joué! Cela ressemblera à quelque chose comme ceci:

https://api.positionstack.com/v1/forward
    ? access_key = VOTRE_ACCESS_KEY
    & query = 1600 Pennsylvania Ave NW, Washington DC

https://api.positionstack.com/v1/reverse
    ? access_key = VOTRE_ACCESS_KEY
    & query = 40.7638435, -73.9729691

Bien sûr, le jeu de données 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 que une géocodage directe demande ressemble , vu par la Maison Blanche:

{
   "Les données": {
      "résultats": [
         {
            "latitude": 38,897675,
            "longueur": -77,036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA",
            "nom": "1600 Pennsylvania Avenue NW",
            "type": "adresse",
            "nombre": "1600",
            "rue": "Pennsylvania Avenue NW",
            "code_postal": "20500",
            "confiance": 1,
            "region": "District de Columbia",
            "region_code": "DC",
            "area_administrativa": nul,
            "quartier": "terrain de la Maison Blanche",
            "Pays: États-Unis",
            "country_code": "USA",
            "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 sembleraient 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 extrémités 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 initiales que vous devez utiliser, vous pouvez obtenir un complément complet de données de localisation en retour. (Il est possible d’affiner ces résultats à l’ aide du paramètre de champs API , mais nous y reviendrons plus tard.)

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

Demandes par lots

Le dernier titre principal de cette configuration 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 les paramètres souhaités) en dessous dans une seule requête, et l’API Positionstack se charge du reste. C’est très simple et ressemble à ceci:

{
   "lot":[
      {
         "query": "Main street",
         "country": "USA",
         "region": "Minnesota"
      },
      {
         "query": "Main street",
         "country": "USA",
         "region": "Illinois"
      },
      {
         "query": "Main street",
         "country": "USA",
         "région": "Missouri"
      }
   ]
}

Données avancées

En plus des paramètres de localisation de base, vous pouvez personnaliser davantage vos demandes d’API pour renvoyer des données plus avancées . Ceux-ci inclus:

Cartes intégrables – Renvoie un objet map_url lié à votre résultat de géocodage, que vous pouvez utiliser pour créer une représentation cartographique visuelle attrayante sur votre site Web ou votre application.
Module de pays: contrairement à d’autres paramètres renvoyés par certains objets de réponse, country_module renvoie une incroyable variété de données sur le pays interrogé. Ce n’est pas seulement une question de coordonnées et de directions; C’est la capitale, le drapeau, le nom officiel, l’état du pays enclavé (ou non), les devises utilisées, les langues parlées, les codes d’appel et plus encore.
Module solaire: avec humour, la documentation de Positionstack décrit cela comme des données «astrologiques». Vous n’obtiendrez pas votre horoscope avec ce paramètre, mais vous verrez des données sur le moment où le soleil se lève et se couche, selon la chronologie astronomique, civile et nautique.
Module fuseau horaire: ajouter