Obtenga codificación geográfica de nivel empresarial gratis con la API de Positionstack (REVISIÓN)

No es necesario ser Google Maps para obtener valor de la codificación geográfica. Y, gracias a Positionstack, tampoco necesita el presupuesto tecnológico de Big G para hacerlo. Hoy, revisamos la robusta API de Positionstack, que tiene como objetivo hacer que la codificación geográfica directa e inversa a nivel empresarial sea altamente asequible y utilizable.

Pila de posiciones 101

Entonces, ¿por qué debería molestarse en leer una revisión de más de 2,000 palabras en Positionstack , y qué puede ganar? La respuesta suena linda, pero es precisa: el mundo entero .

Considere por un momento cuántos lugares hay en el mapa mundial. Ahora, multiplique ese número en su cabeza por cada pieza de metadatos que su empresa necesita saber sobre esos lugares. Eso es lo que ofrece Positionstack, y más.

Veamos algunas estadísticas rápidas sobre Positionstack:

• Miles de millones de solicitudes de búsqueda de codificación geográfica procesadas cada hora, todos los días; con un tiempo de actividad del 100% y <100ms = "" response = "">
• Infraestructura altamente escalable basada en la nube
• Datos en tiempo real de todos los países del mundo, recopilados en un enorme conjunto de datos que se actualiza cada pocas horas.
• Planes de suscripción generosamente distribuidos y con precios competitivos; más una cuota mensual inigualable de 10,000 solicitudes para usuarios gratuitos
• Soporte de integración para todos los principales lenguajes de programación
• Documentación completa y fácil de leer con fragmentos de código
• Un equipo de satisfacción del cliente de clase mundial con experiencia al servicio de clientes como Zendesk, Slack, LinkedIn, Lyft, Apple y Amazon.

Positionstack ciertamente tiene su pedigrí bajo control, pero en caso de que no esté convencido por un puñado de viñetas, profundicemos en lo que es realmente usar la API.

Guía de inicio rápido de 3 pasos de Positionstack

Si pasa algún tiempo en su sitio web, verá que Positionstack realmente enfatiza la facilidad de uso como un punto de venta principal para su API. Durante el proceso de registro, verá de inmediato que es bastante cierto. De hecho, lo primero que ve después de escribir las credenciales de su cuenta es una hoja de ruta rápida de lo que se necesita para comenzar a usar Positionstack en tres sencillos pasos. Vamos a ver:

1. Configure su clave de acceso a la API : de forma predeterminada, se le entrega una clave de acceso lista para usar. Sin embargo, puede restablecerlo fácilmente en el futuro según sea necesario.
2. Elija puntos finales de API : cubrimos los puntos finales de API con mayor profundidad en la siguiente sección, pero por ahora solo comprenda que este paso se refiere a configurar qué tipo de datos se devuelven cuando su aplicación realiza una solicitud a Positionstack. Es aquí donde verá primero la URL base, que es donde dirige sus solicitudes, pero también aparece en la documentación. Por último, vemos una solicitud de API de muestra, que consta de unas pocas líneas de código sencillas.
3. Integración de la aplicación : el último paso se refiere a la integración final de la API de Positionstack en su aplicación. Hay mucho que saber sobre este proceso, y la mayor parte se trata en la documentación. Lo importante aquí es: el equipo de soporte de Positionstack lo respalda y ofrecerá tanta o poca ayuda que necesite para configurar e integrar su API en su aplicación.

Bastante fácil, ¿verdad? Las API pueden parecer intimidantes para las personas sin un amplio conocimiento de TI al principio. Pero desde el principio, Positionstack lo consuela con el conocimiento de que no solo es fácil, sino que también lo ayudarán en el camino con una documentación increíble de su diseño inteligente. Les ayuda a tener un equipo apasionado de expertos listos para ayudarlo también.

Su panel de control de Positionstack

Al duplicar su valor fundamental de facilidad de uso, Positionstack ofrece un panel de control optimizado y ordenado desde el que puede acceder a todo lo que necesita saber sobre su API. Echemos un vistazo a las opciones de la barra lateral:

• Panel de control : aquí encontrará notificaciones (que generalmente lo alertan cuando pasa ciertos umbrales de uso), luego enlaces a la Guía de inicio rápido de 3 pasos y su página de documentación. También hay una descripción general de su clave API, su suscripción actual, detalles de la cuenta y método de pago.
• Actualización / suscripción : puede cambiar su suscripción en cualquiera de estas dos opciones. Actualice en cualquier momento, aunque si desea cambiar entre un plan mensual o anual en cualquier dirección, primero deberá cambiar a una cuenta gratuita y luego elegir la opción deseada. El soporte de Positionstack está dispuesto a ayudarlo si necesita ayuda para hacer esto.
• Cuenta / Pago : se explican por sí mismos; cualquiera de las pestañas le permitirá actualizar sus credenciales en cualquier momento. Debe decirse que apreciamos que no oculten estos controles básicos en una interfaz llamativa y sobre-diseñada. WYSIWYG.
• Uso de API : probablemente la pestaña que volverá a visitar con más frecuencia, aquí puede encontrar cuánto de su cuota de solicitud mensual ha consumido hasta ahora. También hay una sección útil que muestra sus estadísticas de uso a lo largo del tiempo, para que pueda ajustar su estrategia en consecuencia.

Documentación de API

Ahora llegamos al corazón y al alma de la oferta de Positionstack: la documentación de la API . Considere esta página como su manual de usuario de referencia, que detalla cada punto final de API, sus parámetros y qué tipo de información devolverán.

Esta página está dividida en cinco secciones diferentes. Repasaremos cada uno de ellos, dedicando algo de tiempo y palabrería para proporcionar un contexto para que comprenda mejor lo que encontrará.

Empezando

Aquí encontrará funciones básicas que se aplican a todas las solicitudes que realice con Positionstack. Estos son:

• Clave API : su clave API es como un pasaporte digital que usará para acceder al conjunto de datos de Positionstack. Sin ella, la API es inútil para ti. Si cree que se ha visto comprometida, puede rotar fácilmente su clave anterior por una nueva.
• Cifrado : el cifrado SSL de 256 bits se utiliza en Internet y es el estándar de seguridad de la industria por una buena razón. Si bien necesitará un plan básico o mejor para cifrar las comunicaciones de su aplicación con los servidores de Positionstack, vale la pena la inversión por sí solo. Para evocar el cifrado, simplemente cambie HTTP a HTTPS en la URL base de la API. ¡Simple!
• Devoluciones de llamada JSON : no entraremos en demasiados detalles técnicos sobre cómo funciona esto, pero si sus solicitudes de API están bloqueadas por políticas del mismo origen, usa devoluciones de llamada JSON para afectar una solución alternativa. Básicamente, solicita datos de un script externo, que no se atasca con problemas entre dominios.
• Errores de API : como con todo, a veces sus solicitudes de API se encontrarán con errores. Positionstack comprende esto y ha incorporado en su aplicación una función de informe de errores para ayudarlo a identificar qué salió mal. Los errores de solicitud de API devolverán automáticamente un objeto de error en formato JSON, además de subobjetos de código, mensaje y contexto para proporcionar contexto para el error.

Puntos finales de API

Esta sección documenta la funcionalidad de carne y papas de Positionstack, es decir, codificación geográfica directa e inversa. Si no está 100% seguro de cuál es la diferencia, piense en la codificación geográfica como una calle de dos vías donde puede traducir lugares y direcciones escritas en inglés simple a datos de ubicación como coordenadas y direcciones IP, y viceversa.

Por lo tanto, usaría la codificación geográfica directa para convertir la ubicación de la Torre Eiffel en coordenadas. Del mismo modo, puede averiguar la dirección de la calle asociada con una dirección IP mediante el uso de codificación geográfica inversa. ¡Bastante simple, después de todo!

Solicitudes de codificación geográfica hacia adelante / hacia atrás

Para realizar una solicitud básica para cualquier tipo de codificación geográfica, deberá agregar el punto final apropiado ( / adelante  o atrás ) a la URL base de la API. A continuación, proporcionará su clave de acceso, luego realizará una consulta utilizando una dirección de ubicación en inglés simple o sus datos de ubicación correspondientes, y ¡listo! Se verá más o menos así:

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

Por supuesto, el conjunto de datos de Positionstack contiene mucho, mucho más que direcciones y coordenadas. Puede analizar estas otras categorizaciones mediante el uso de varios parámetros. A continuación, se muestra un ejemplo de cómo se ve una solicitud de codificación geográfica reenviada , que consulta a la Casa Blanca:

{
   "datos": {
      "resultados": [
         {
            "latitud": 38.897675,
            "longitud": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, EE. UU.",
            "nombre": "1600 Pennsylvania Avenue NW",
            "tipo": "dirección",
            "número": "1600",
            "street": "Pennsylvania Avenue NW",
            "postal_code": "20500",
            "confianza": 1,
            "region": "Distrito de Columbia",
            "region_code": "DC",
            "área_administrativa": nulo,
            "barrio": "Terrenos de la Casa Blanca",
            "País: Estados Unidos",
            "country_code": "EE. UU.",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

Curiosamente, si realizara una solicitud de codificación geográfica inversa utilizando las coordenadas aproximadas de la Casa Blanca, los resultados devueltos se verían casi idénticos, excepto que también vería la diferencia en la distancia entre sus coordenadas y las coordenadas oficiales de la Casa Blanca, tal como aparecen en Positionstack. conjunto de datos.

La razón de esta similitud es que ambos extremos utilizan la misma matriz de parámetros GET y, por lo tanto, son capaces de devolver (casi) los mismos objetos de respuesta. Eso significa que, independientemente de los datos iniciales que tenga que utilizar, puede obtener a cambio un complemento completo de datos de ubicación. (Es posible reducir estos resultados utilizando el parámetro de campos de  la API , pero lo tocaremos más adelante).

Nota: La página de documentación de Positionstack detalla completamente cada parámetro y objeto de respuesta, ¡así que asegúrese de revisarlo!

Solicitudes por lotes

El último encabezado principal de esta configuración de documentación se ocupa de las solicitudes por lotes . Todo lo que tiene que hacer es invocar el parámetro de lote  , luego anidar múltiples instancias de consulta (junto con los parámetros deseados) debajo en una sola solicitud, y la API de Positionstack se encarga del resto. Es muy simple y se ve así:

{
   "lote":[
      {
         "consulta": "Calle principal",
         "país": "EE. UU.",
         "region": "Minnesota"
      },
      {
         "consulta": "Calle principal",
         "país": "EE. UU.",
         "region": "Illinois"
      },
      {
         "consulta": "Calle principal",
         "país": "EE. UU.",
         "region": "Missouri"
      }
   ]
}

Datos avanzados

Además de los parámetros de ubicación básicos, puede personalizar aún más sus solicitudes de API para devolver datos más avanzados . Éstas incluyen:

• Mapas incrustables: devuelve un objeto map_url vinculado a su resultado de codificación geográfica, que puede usar para crear una representación de mapa visual atractiva en su sitio web o aplicación.
• Módulo de país : a diferencia de otros parámetros que devuelven algunos objetos de respuesta, country_module devuelve una increíble variedad de datos sobre el país consultado. No se trata solo de coordenadas y direcciones; es la capital, la bandera, el nombre oficial, el estado de país sin litoral (o no), las monedas utilizadas, los idiomas que se hablan, los códigos de llamada y más.
• Módulo solar : con humor, la documentación de Positionstack describe esto como datos "astrológicos". No obtendrá su horóscopo con este parámetro, pero verá datos sobre cuándo sale y se pone el sol, según la cronología astronómica, civil y náutica.
• Módulo de zona horaria : agregue timezone_module para devolver el desplazamiento GMT de una ubicación en segundos o como una cadena de lenguaje natural.
• Módulo de cuadro delimitador: si un solo par de coordenadas x / y no es adecuado para su tarea, pruebe con un cuadro delimitador, que encierra un área con valores mínimos y máximos de longitud y latitud.

Opciones adicionales

La API de Positionstack tiene una tonelada de datos para arrojarle, pero afortunadamente le brinda herramientas adicionales para administrar este tesoro de información.

• Especificar campos de respuesta : hemos cubierto en profundidad cuántos datos puede devolver Positionstack, pero tenga en cuenta que todos esos datos tienen un costo. Si desea limitar sus solicitudes mensuales, puede hacerlo con los campos Anexar campos = resultados.bandera , por ejemplo, hará que la API muestre solo la bandera de su país consultado. Puede invocar campos tantas veces como necesite para obtener el conjunto de datos específico que necesita.
• Especificar formato de salida : los suscriptores gratuitos están limitados al formato JSON para sus resultados de codificación geográfica devueltos. Sin embargo, los clientes que pagan pueden agregar resultados a sus solicitudes para especificar JSON, XML o GeoJSON según sea necesario. 

Ejemplos de código 

Cuando Positionstack dice que están aquí para ayudarlo, lo dicen en serio. Ya hemos visto cuán completa es su documentación, pero la completan con ejemplos de código útiles en todos los lenguajes que admite su API. No vamos a copiar / pegar ese código aquí, pero para referencia rápida, esos lenguajes son:

• Pitón
• Nodejs
• jQuery
• Vamos
• Rubí

Prueba y desempeño

En este punto, debería quedar claro que Positionstack es capaz de hacer bastante. Pero, ¿qué tan bien hace estas cosas?

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.