0
(0)

No tienes que ser Google Maps para obtener valor de la geocodificación. Y, gracias a Positionstack, tampoco necesitas el presupuesto técnico del Gran G para hacerlo. Hoy revisamos la robusta API de Positionstack, que tiene como objetivo hacer que la geocodificación hacia adelante y hacia atrás a nivel empresarial sea altamente asequible y utilizable.

PositionStack - Preciso Adelante y Atrás-Geocodificación de Lotes-REST-API

Posicionamiento 101

Entonces, ¿por qué deberías molestarte en leer una reseña de más de 2.000 palabras sobre Posicionamiento¿Y qué ganas tú? La respuesta suena linda, pero es precisa: el el mundo entero.

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

Veamos algunas estadísticas rápidas sobre Positionstack:

  • Miles de millones de solicitudes de búsqueda de geocodificación procesadas cada hora, cada día; con un tiempo de funcionamiento del 100% y tiempos de respuesta < 100ms
  • Infraestructura basada en la nube, altamente escalable
  • Datos en tiempo real de todos los países del mundo, compilados en un conjunto de datos cavernosos que se actualizan cada pocas horas
  • Planes de suscripción generosamente repartidos y con precios competitivos; además de una cuota mensual sin rival 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 en el servicio a clientes como Zendesk, Slack, LinkedIn, Lyft, Apple y Amazon

Positionstack ciertamente tiene su pedigrí en jaque, pero en caso de que no te convenza un puñado de viñetas, vamos a sumergirnos profundamente en lo que es usar realmente el API.

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

Si pasas algún tiempo en su sitio web, verás que Positionstack realmente hace hincapié en la facilidad de uso como principal punto de venta de su API. Durante el proceso de registro, verás inmediatamente que eso es bastante cierto. De hecho, lo primero que ves después de escribir las credenciales de tu cuenta es una rápida hoja de ruta de lo que se necesita para poner en marcha Positionstack en tres sencillos pasos. Echemos un vistazo:

  1. Configure su clave de acceso a la API – Por defecto, se le da una clave de acceso que está lista para salir de la caja. Sin embargo, puedes restablecerla fácilmente según sea necesario.
  2. Elija los puntos finales de la API – En la siguiente sección se tratan con más detalle los puntos finales de la API, pero por ahora sólo entienda que este paso se refiere a la configuración del tipo de datos que se devuelven cuando su aplicación hace una solicitud a Positionstack. Aquí verás primero la URL base, que es donde diriges tus peticiones, pero también aparece en la documentación. Por último, vemos una solicitud de API de muestra, que consiste en unas pocas líneas de código sencillo.
  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 está cubierto en la documentación. Lo importante aquí es: El equipo de soporte de Positionstack te cubrirá las espaldas y te ofrecerá toda la ayuda que necesites para configurar e integrar su API en tu aplicación.

Bastante fácil, ¿verdad? Las APIs pueden parecer intimidantes para la gente sin amplios conocimientos de informática al principio. Pero de entrada, Positionstack te reconforta sabiendo que no sólo es fácil, sino que te ayudará a lo largo del camino con una increíble documentación de su diseño inteligente. Ayuda a que tengan un apasionado equipo de expertos listos para ayudarte también.

Su tablero de posiciones

Duplicando su valor principal de facilidad de uso, Positionstack ofrece un Tablero de Control racionalizado y despejado desde el cual se puede acceder a todo lo que necesita saber sobre su API. Echemos un vistazo a las opciones de la barra lateral:

  • Tablero de mandos – Aquí encontrará notificaciones (que normalmente le avisan cuando pasa ciertos umbrales de uso), y luego enlaces tanto a la Guía de Inicio Rápido de 3 Pasos como a su página de Documentación. También hay una descripción general de su clave de 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. Actualízate en cualquier momento, aunque si quieres cambiar entre un plan mensual o anual en cualquier dirección, tendrás que bajar primero a una cuenta gratuita y luego elegir la opción deseada. El soporte de Positionstack está dispuesto a ayudarte si necesitas ayuda para hacerlo.
  • Cuenta/Pago – Estas se explican por sí solas; cualquier pestaña le permitirá actualizar sus credenciales en cualquier momento. Hay que decir que apreciamos que no entierren estos controles básicos en una interfaz sobrediseñada y llamativa. WYSIWYG.
  • Uso de la API – Probablemente la pestaña que revisará más a menudo, aquí puede encontrar cuánto de su cuota de solicitud mensual ha comido hasta ahora. También hay una sección útil que muestra las estadísticas de uso a lo largo del tiempo, para que puedas ajustar tu estrategia en consecuencia.

Documentación de la API

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

Esta página está dividida en cinco secciones diferentes. Repasaremos cada una, dedicando tiempo y verborrea para proporcionarles un contexto para que entiendan mejor lo que encontrarán.

Empezando

Aquí, encontrarás funciones básicas que se aplican a cada solicitud que haces con Positionstack. Estos son:

  • Clave API – Tu clave API es como un pasaporte digital que usarás para acceder al conjunto de datos de Positionstack. Sin ella, la API es inútil para ti. Si crees que está comprometida, puedes rotar fácilmente tu antigua clave por una nueva.
  • Cifrado – La encriptación SSL de 256 bits se utiliza en toda la Internet, y es el estándar de la industria en materia de seguridad por una buena razón. Aunque necesitarás un plan básico o mejor para encriptar las comunicaciones de tu aplicación con los servidores de Positionstack, vale la pena la inversión por sí sola. Para evocar la encriptación, simplemente cambia HTTP a HTTPS en la URL base de la API. ¡Simple!
  • JSON Retrollamadas – No entraremos en demasiados detalles técnicos sobre cómo funciona esto, pero si sus solicitudes de API se ven obstaculizadas por las políticas del mismo origen, utilice las devoluciones de llamada de JSON para afectar a una solución. Esencialmente, se solicitan datos de un script externo, que no se atasca con problemas de dominio cruzado.
  • Errores de la API – Como con cualquier otra cosa, a veces las solicitudes de la API se topan con errores. Positionstack entiende esto, y ha incorporado en su aplicación una funcionalidad de informe de errores para ayudarte a identificar lo que ha salido mal. Los fallos de las solicitudes de la API devolverán automáticamente un objeto de error en el formato JSON, además de código, mensaje y subobjetos de contexto para proporcionar el contexto del error.

Puntos finales de la API

Esta sección documenta la funcionalidad de Positionstack, es decir, la geocodificación hacia adelante y hacia atrás. Si no estás 100% seguro de cuál es la diferencia, piensa en la geocodificación como una calle de doble sentido donde puedes traducir lugares y direcciones escritas en un inglés sencillo a datos de localización como coordenadas y direcciones IP, y viceversa.

Entonces, usarías la geocodificación avanzada para convertir la ubicación de la Torre Eiffel en coordenadas. Del mismo modo, puedes averiguar la dirección de la calle asociada a una dirección IP utilizando la geocodificación inversa. Bastante simple, después de todo!

Solicitudes de geocodificación hacia adelante y hacia atrás

Para hacer una solicitud básica de cualquiera de los dos tipos de geocodificación, tendrá que añadir el punto final apropiado (/encargado o /reversa) a la URL base de la API. A continuación, proporcionarás tu clave de acceso, y luego harás un consulta usando una dirección de localización en inglés sencillo o sus correspondientes datos de localización… y, ¡voilá! Se verá algo como esto:

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 sólo direcciones y coordenadas. Puedes analizar estas otras categorizaciones a través del uso de varios parámetros. Aquí hay un ejemplo de lo que geocodificación hacia adelante solicitud, preguntando a la Casa Blanca, parece:

{
   "data": {
      "results": [
         {
            "latitude": 38.897675,
            "longitude": -77.036547,
            "label": "1600 Pennsylvania Avenue NW, Washington, DC, USA",
            "name": "1600 Pennsylvania Avenue NW",
            "type": "address",
            "number": "1600",
            "street": "Pennsylvania Avenue NW",
            "postal_code": "20500",
            "confidence": 1,
            "region": "District of Columbia",
            "region_code": "DC",
            "administrative_area": null,
            "neighbourhood": "White House Grounds",
            "country": "United States",
            "country_code": "US",
            "map_url": "http://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

Curiosamente, si hicieras una geocodificación inversa usando las coordenadas aproximadas de la Casa Blanca, los resultados devueltos se verían casi idénticos, excepto que también se vería la diferencia en distancia entre sus coordenadas y las coordenadas oficiales de la Casa Blanca tal y como aparecen en el conjunto de datos de Positionstack.

La razón de esta similitud es que ambos puntos finales utilizan el mismo conjunto de parámetros GET, y por lo tanto son capaces de devolver (casi) los mismos objetos de respuesta. Eso significa que no importa qué datos de inicio tengas que pasar, puedes obtener un complemento completo de datos de localización a cambio. (Es posible reducir estos resultados utilizando las API campos pero hablaremos de eso más tarde).

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

Solicitudes de lotes

El último título importante en este entorno de documentación trata de solicitudes de lotes. Todo lo que tienes que hacer es invocar al lote parámetro, y luego anidar múltiples consulta instancias (junto con sus parámetros deseados) debajo en una sola solicitud, y la API de Positionstack se encarga del resto. Es muy simple, y se ve así:

{
   "batch":[
      {
         "query": "Main Street",
         "country": "US",
         "region": "Minnesota"
      },
      {
         "query": "Main Street",
         "country": "US",
         "region": "Illinois"
      },
      {
         "query": "Main Street",
         "country": "US",
         "region": "Missouri"
      }
   ]
}

Datos avanzados

Además de los parámetros básicos de localización, puede adaptar aún más sus solicitudes de API para devolver más datos avanzados. Estos incluyen:

  • Mapas incrustados – Devuelve un objeto map_url vinculado a su resultado de geocodificación, que puede utilizar para crear una representación visual atractiva del mapa en su sitio web o aplicación.
  • Módulo de país – A diferencia de otros parámetros que devuelven hasta unos pocos objetos de respuesta, módulo_de_país devuelve un increíble conjunto de datos sobre su país consultado. No son sólo coordenadas y direcciones, sino también la capital, la bandera, el nombre oficial, la condición de país sin litoral (o no), las monedas utilizadas, los idiomas hablados, los códigos de llamada y más.
  • Módulo solar – Humorísticamente, 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, de acuerdo con la cronología astronómica, civil y náutica.
  • Módulo de la zona horaria – Apéndices módulo_de_zona_temporal para devolver el desplazamiento GMT de una ubicación en segundos o como una cadena de lenguaje natural.
  • Módulo de la caja de unión Si un solo par de coordenadas x/y no es adecuado para su tarea, pruebe con un cuadro delimitador, que encierre 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 lanzarte, pero por suerte te proporciona herramientas adicionales para gestionar este tesoro de información.

  • Especifique los campos de respuesta – Hemos cubierto a fondo la cantidad de datos que Positionstack puede devolver, pero tened en cuenta que todos esos datos tienen un coste. Si quieres limitar tus peticiones mensuales, puedes hacerlo con el campos Adición de campos = resultados.banderapor ejemplo, hará que la API sólo muestre la bandera del país consultado. Puede invocar campos tantas veces como necesites para obtener el conjunto de datos específicos que requieras.
  • Especificar el formato de salida – Los suscriptores gratuitos están limitados al formato JSON para sus resultados de geocodificación devueltos. Los clientes de pago, sin embargo, pueden añadir salida en sus solicitudes de especificar JSON, XML o GeoJSON según sea necesario.

Ejemplos de códigos

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

Prueba y rendimiento

En este punto, debe quedar claro que Positionstack es capaz de hacer mucho. Pero.., lo bien que ¿hace estas cosas?

Primero, consideremos un poco de contexto. Positionstack es uno de los más de 20 microservicios de API en el ecosistema basado en la nube de Apilayer. Juntas, estas APIs sirven a más de un millón de clientes B2B desde las empresas de nueva creación hasta las empresas. Algunos de sus clientes más notables son Amazon, Apple, Slack, LinkedIn y muchos otros nombres conocidos. Claramente, tienen una infraestructura robusta para manejar esta escala de demanda.

Por sus propios méritos, Positionstack está a la altura de su pedigrí, con un increíble 100% de tiempo de funcionamiento a lo largo de 2020 en el momento de escribir este artículo. Esto es aún más impresionante si se considera la API rutinariamente procesa más de mil millones de búsquedas de geocódigos al día por cliente de ballena, sin mencionar el vertiginoso conjunto de solicitudes simultáneas que provienen de sus estables clientes de PYMES. Lo que es más, estas solicitudes típicamente obtienen respuestas entre 10 y 100 ms.

En nuestro libro, eso es una especie de maravilla tecnológica, especialmente considerando lo agresivo del precio de esta oferta de SaaS.

Y no es sólo el poder en bruto lo que hace que Positionstack sea tan atractivo. Su conjunto de datos es realmente sofisticado, y proviene de nombres fiables como Nominatim, GeoNames, Pelias, y OpenStreetMap. Positionstack cruza, filtra y recombina esta riqueza de datos múltiples veces al día, impulsando actualizaciones regulares a través de algoritmos inteligentes que aseguran que siempre tengas datos de localización altamente precisos, en cualquier lugar del mundo y en tiempo real.

Odiamos estropear nuestro veredicto final, pero si está buscando una solución de geocodificación robusta y escalable, el currículum de Positionstack exige una mirada más atenta.

Precios

Apilayer se propuso ofrecer una alternativa asequible a los programas de geocodificación de nivel empresarial, que son muy caros, y con ese fin han tenido éxito.

PositionStack - Geocodificación de dirección libre y API de mapas

La pila de posiciones viene en cinco precios y soporta facturación mensual, o suscripciones anuales con un 20% de descuento. Esos niveles son:

  • Libre – Con 25.000 solicitudes mensuales de geocodificación de avance y retroceso, en formato JSON. No tienes muchas características avanzadas o soporte al cliente, pero ya te hemos mostrado el valioso recurso que es su página de documentación. Este nivel es gratuito y sin compromiso, ni siquiera tiene que proporcionar los datos de su tarjeta de crédito para empezar.
  • Básico – El paquete comercial de entrada. Los suscriptores básicos cuadruplican su cuota mensual hasta 100.000 solicitudes de geocodificación, además de obtener acceso a funciones avanzadas como la encriptación HTTPS, múltiples opciones de salida (JSON, XML, GeoJSON), mapas incrustables, múltiples idiomas y más. Obtenga una licencia comercial de Positionstack por sólo $9.99 al mes.
  • Profesional – La oferta más popular de Positionstack, el nivel Profesional ofrece un aumento de diez veces en las solicitudes de geocodificación hasta 1.000.000 por mes. Todos los productos del nivel Básico están presentes y algunos más, incluyendo solicitudes por lotes para aplicaciones de gran potencia. Este nivel cuesta 49,99 dólares al mes.
  • Negocios – Pasando a la escala empresarial, el nivel de negocios aumenta la cuota mensual a la friolera de 3.000.000 de solicitudes. Una vez más, todas las funciones avanzadas están completamente disponibles, respaldadas por el apasionado equipo de atención al cliente de Positionstack para ayudarle a sacar el máximo provecho de ellas. 99,99 dólares al mes.
  • Empresa – Este es el nivel en el que las ofertas estándar salen por la ventana, y el cliente es el rey. Tienes necesidades precisas que exigen soluciones personalizadas, y Positionstack está listo para alcanzar tus objetivos. Tú dictas tus solicitudes de volumen mensual, incluso (especialmente) si son variables. ¿Necesitas más potencia de la API? Busque soporte para soluciones personalizadas. Ponte en contacto con Positionstack para obtener un presupuesto.

Veredicto

Positionstack hace precisamente lo que se propuso: llevar la geocodificación a nivel empresarial desde puntos de precio que de otra manera estarían fuera de presupuesto a la mayoría de las PYMES, sin sacrificar el rendimiento. Su API está bien documentado y es fácil de usar, pero presenta una sólida integración en todos los principales lenguajes de programación para una máxima utilidad. El número de solicitudes que Positionstack maneja rutinariamente es asombroso, mientras que su conjunto de datos se mantiene inteligentemente para un alcance verdaderamente global en la geocodificación en tiempo real. Si usted está en el mercado para este tipo de producto, no duerma en Positionstack.

¿Qué clase de integración tiene planeada? ¿Cómo utilizará la geocodificación en su negocio? ¿Tiene alguna pregunta o comentario sobre Positionstack? Déjenos una nota en los comentarios de abajo.

¿Le ha parecido útil este contenido?

¡Haz clic en una estrella para puntuar!

Promedio de puntuación 0 / 5. Recuento de votos: 0

Hasta ahora, ¡no hay votos!. Sé el primero en puntuar este contenido.