Web

Obtenga codificación geográfica de nivel empresarial de forma gratuita 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 tiempos de respuesta de <100 ms
  • Infraestructura altamente escalable basada en la nube
  • Datos en tiempo real de todos los países del mundo, recopilados en un conjunto de datos cavernoso que se actualiza cada pocas horas.
  • Planes de suscripción generosamente distribuidos y con precios competitivos; además de 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 cómo 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 que está lista para salir de la caja. 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. Finalmente, vemos una solicitud de API de muestra, que consta de solo unas pocas líneas de código.
  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 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.

Tu panel 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 le avisan 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 hacerlo.
  • 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 la API : probablemente la pestaña que volverá a visitar con más frecuencia, aquí puede encontrar la cantidad de su cuota de solicitud mensual que 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 el 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. Revisaremos 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 cada solicitud que realice con Positionstack. Estos son:

  • Clave API : su clave API es como un pasaporte digital que utilizará 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 todo 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. ¡Sencillo!
  • 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, utiliza devoluciones de llamada JSON para afectar una solución alternativa. Esencialmente, 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 utilizando la codificación geográfica inversa. ¡Bastante simple, después de todo!

Solicitudes de codificación geográfica directa / inversa

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á 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 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 directa , que consulta 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 usando 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 adaptar 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

Publicaciones relacionadas

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Botón volver arriba