Ottieni gratuitamente la geocodifica di livello aziendale con lAPI Positionstack (REVISIONE)

Non devi essere Google Maps per ottenere valore dalla geocodifica. E, grazie a Positionstack, non hai nemmeno bisogno del budget tecnologico di Big G per farlo. Oggi esaminiamo la solida API di Positionstack, che mira a rendere la geocodifica diretta e inversa a livello aziendale altamente conveniente e utilizzabile.

Pila di posizioni 101

Quindi, perché dovresti preoccuparti di leggere una recensione di oltre 2000 parole su Positionstack e cosa puoi guadagnare? La risposta sembra carina, ma è precisa: il mondo intero .

Considera per un momento quanti posti ci sono sulla mappa del mondo. Ora, moltiplica quel numero nella tua testa per ogni pezzo di metadati che la tua azienda ha bisogno di sapere su quei luoghi. Questo è ciò che offre Positionstack, e poi alcuni.

Diamo un'occhiata ad alcune statistiche rapide su Positionstack:

• Miliardi effettivi di richieste di ricerca di geocodifica elaborate ogni ora, ogni giorno; con il 100% di uptime e < 100ms="" response="">
• Infrastruttura basata su cloud e altamente scalabile
• Dati in tempo reale su ogni paese del mondo, compilati in un set di dati cavernoso che viene aggiornato ogni poche ore
• Piani di abbonamento generosamente ripartiti e a prezzi competitivi; più un'impareggiabile quota mensile di 10.000 richieste per gli utenti gratuiti
• Supporto all'integrazione per tutti i principali linguaggi di programmazione
• Documentazione completa e di facile lettura completa di frammenti di codice
• Un team di soddisfazione del cliente di livello mondiale con esperienza al servizio di clienti come Zendesk, Slack, LinkedIn, Lyft, Apple e Amazon

Positionstack ha sicuramente il suo pedigree sotto controllo, ma nel caso in cui non sei convinto da una manciata di punti elenco, diamo un'occhiata a com'è effettivamente utilizzare l'API.

Guida rapida in 3 passaggi di Positionstack

Se trascorri del tempo sul loro sito Web, vedrai che Positionstack sottolinea davvero la facilità d'uso come punto di forza principale della loro API. Durante il processo di registrazione, vedrai immediatamente che è vero. In effetti, la prima cosa che vedi dopo aver digitato le credenziali del tuo account è una rapida tabella di marcia di ciò che serve per iniziare a utilizzare Positionstack in tre semplici passaggi. Diamo un'occhiata:

1. Imposta la tua chiave di accesso API : per impostazione predefinita, ti viene consegnata una chiave di accesso pronta per l'uso. Tuttavia, puoi facilmente ripristinarlo lungo la linea, se necessario.
2. Scegli gli endpoint API : tratteremo gli endpoint API in modo più approfondito nella prossima sezione, ma per ora comprendi solo che questo passaggio si riferisce alla configurazione del tipo di dati che viene restituito quando la tua app effettua una richiesta a Positionstack. È qui che vedrai prima l'URL di base, che è dove indirizzi le tue richieste, ma appare anche nella documentazione. Infine, vediamo una richiesta API di esempio, che consiste in poche semplici righe di codice.
3. Integrazione dell'applicazione : l'ultimo passaggio si riferisce all'integrazione finale dell'API di Positionstack nella tua applicazione. C'è molto da sapere su questo processo e la maggior parte di esso è coperto dalla documentazione. La cosa importante qui è: il team di supporto di Positionstack ti dà le spalle e ti offrirà tutto o il minimo aiuto di cui hai bisogno per configurare e integrare la loro API nella tua app.

Abbastanza facile vero? Le API possono sembrare intimidatorie per le persone senza una conoscenza IT approfondita all'inizio. Ma subito, Positionstack ti conforta con la consapevolezza che non solo è facile, ma ti aiuterà lungo la strada con un'incredibile documentazione del loro design intelligente. Aiuta anche ad avere un team appassionato di esperti pronti ad aiutarti.

La tua dashboard della pila di posizioni

Raddoppiando il loro valore fondamentale di facilità d'uso, Positionstack offre una dashboard semplificata e ordinata da cui puoi accedere a tutto ciò che devi sapere sulla tua API. Diamo un'occhiata alle opzioni della barra laterale:

• Dashboard : qui troverai le notifiche (di solito ti avvisano quando superi determinate soglie di utilizzo), quindi i collegamenti alla Guida rapida in 3 passaggi e alla loro pagina di documentazione. C'è anche una panoramica della tua chiave API, del tuo abbonamento attuale, dei dettagli dell'account e del metodo di pagamento.
• Upgrade/Abbonamento : puoi modificare il tuo abbonamento su una di queste due opzioni. Esegui l'upgrade in qualsiasi momento, tuttavia, se desideri passare da un piano mensile a uno annuale in entrambe le direzioni, dovrai prima eseguire il downgrade a un account gratuito, quindi scegliere l'opzione desiderata. Il supporto di Positionstack è disposto ad assisterti se hai bisogno di aiuto per farlo.
• Conto/Pagamento – Sono autoesplicativi; entrambe le schede ti permetteranno di aggiornare le tue credenziali in qualsiasi momento. Va detto che apprezziamo il fatto che non seppelliscano questi controlli di base in un'interfaccia appariscente e troppo progettata. WYSIWYG.
• Utilizzo dell'API : probabilmente la scheda che visiterai più spesso, qui puoi trovare quanta parte della tua quota di richiesta mensile hai consumato finora. C'è anche una pratica sezione che mostra le tue statistiche di utilizzo nel tempo, così puoi adattare la tua strategia di conseguenza.

Documentazione API

Ora arriviamo al cuore e all'anima dell'offerta di Positionstack: la documentazione API . Considera questa pagina il tuo manuale utente di riferimento, che descrive in dettaglio ciascun endpoint API, i relativi parametri e il tipo di informazioni che restituiranno.

Questa pagina è suddivisa in cinque diverse sezioni. Analizzeremo ciascuno di essi, impiegando un po' di tempo e verbosità per fornire un contesto in modo che tu possa capire meglio cosa troverai.

Iniziare

Qui troverai le funzioni di base che si applicano a ogni richiesta che fai con Positionstack. Questi sono:

• Chiave API : la tua chiave API è come un passaporto digitale che utilizzerai per accedere al set di dati di Positionstack. Senza di essa, l'API è inutile per te. Se ritieni che sia stato compromesso, puoi facilmente ruotare la tua vecchia chiave per una nuova.
• Crittografia : la crittografia SSL a 256 bit viene utilizzata in tutta Internet ed è lo standard del settore per la sicurezza per una buona ragione. Anche se avrai bisogno di un piano Basic o migliore per crittografare le comunicazioni della tua app con i server di Positionstack, vale la pena investire da solo. Per evocare la crittografia, cambia semplicemente HTTP in HTTPS nell'URL di base dell'API. Semplice!
• Callback JSON : non entreremo in troppi dettagli tecnici su come funziona, ma se le tue richieste API vengono ostacolate da policy della stessa origine, utilizzi i callback JSON per modificare una soluzione alternativa. In sostanza, richiedi i dati da uno script esterno, che non si impantana con problemi tra domini.
• Errori API : come con qualsiasi cosa, a volte le tue richieste API si imbatteranno in errori. Positionstack lo capisce e ha integrato nella sua app una funzionalità di segnalazione degli errori per aiutarti a identificare cosa è andato storto. Gli errori di richiesta API restituiranno automaticamente un oggetto errore in formato JSON, oltre a codice, messaggio e oggetti secondari di contesto per fornire il contesto per l'errore.

Endpoint API

Questa sezione documenta la funzionalità carne e patate di Positionstack, vale a dire geocodifica avanti e indietro. Se non sei sicuro al 100% di quale sia la differenza, pensa alla geocodifica come a una strada a doppio senso in cui puoi tradurre luoghi e indirizzi scritti in un inglese semplice in dati di posizione come coordinate e indirizzi IP e viceversa.

Quindi, useresti la geocodifica in avanti per convertire la posizione della Torre Eiffel in coordinate. Allo stesso modo, puoi scoprire l'indirizzo stradale associato a un indirizzo IP utilizzando la geocodifica inversa. Abbastanza semplice, dopotutto!

Richieste di geocodifica avanti/indietro

Per effettuare una richiesta di base per entrambi i tipi di geocodifica, dovrai aggiungere l'endpoint appropriato ( /forward  o /reverse ) all'URL di base dell'API. Successivamente, fornirai la tua chiave di accesso, quindi effettuerai una query utilizzando un indirizzo di posizione in inglese semplice o i dati sulla posizione corrispondenti e, voilà! Sarà simile a questo:

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

o

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

Naturalmente, il set di dati di Positionstack contiene molto, molto di più di semplici indirizzi e coordinate. È possibile analizzare queste altre categorizzazioni mediante l'uso di vari parametri. Ecco un esempio di come appare una richiesta di geocodifica in avanti , che interroga la Casa Bianca:

{
   "dati": {
      "risultati": [
         {
            "latitudine": 38.897675,
            "longitudine": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA",
            "nome": "1600 Pennsylvania Avenue NW",
            "tipo": "indirizzo",
            "numero": "1600",
            "street": "Pennsylvania Avenue NW",
            "codice_postale": "20500",
            "fiducia": 1,
            "regione": "Distretto di Columbia",
            "region_code": "DC",
            "area_amministrativa": nullo,
            "quartiere": "Giardini della Casa Bianca",
            "paese": "Stati Uniti",
            "codice_paese": "USA",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

È interessante notare che se dovessi eseguire una richiesta di geocodifica inversa utilizzando le coordinate approssimative della Casa Bianca, i risultati restituiti sembrerebbero quasi identici, tranne per il fatto che vedresti anche la differenza di distanza tra le tue coordinate e le coordinate ufficiali della Casa Bianca così come appaiono in Positionstack insieme di dati.

La ragione di questa somiglianza è che entrambi gli endpoint utilizzano lo stesso array di parametri GET e sono quindi in grado di restituire (quasi) gli stessi oggetti di risposta. Ciò significa che, indipendentemente dai dati di partenza che devi seguire, puoi ottenere in cambio una serie completa di dati sulla posizione. (È possibile restringere questi risultati utilizzando il parametro dei campi  dell'API , ma ne parleremo più avanti).

Nota: la pagina della documentazione di Positionstack descrive in dettaglio ogni parametro e oggetto di risposta, quindi assicurati di controllarlo!

Richieste batch

L'ultima intestazione principale in questa impostazione della documentazione riguarda le richieste batch . Tutto quello che devi fare è invocare il parametro batch  , quindi nidificare più istanze di query (insieme ai parametri desiderati) sotto in una singola richiesta e l'API di Positionstack si prenderà cura del resto. È semplicissimo e assomiglia a questo:

{
   "lotto":[
      {
         "query": "Strada principale",
         "paese": "USA",
         "regione": "Minnesota"
      },
      {
         "query": "Strada principale",
         "paese": "USA",
         "regione": "Illinois"
      },
      {
         "query": "Strada principale",
         "paese": "USA",
         "regione": "Missouri"
      }
   ]
}

Dati avanzati

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.