PositionStack suele aparecer en integraciones más ligeras, a menudo una sola clase de servicio que envuelve una llamada a la API dentro de una aplicación más grande. Ese tipo de integración es lo bastante pequeña como para pasarla por alto y lo bastante grande como para que reescribirla resulte molesto. Nuestro host compatible está pensado para eliminar por completo esa reescritura.
El host reproduce exactamente los parámetros de solicitud y el cuerpo de respuesta de PositionStack, salvo los textos de copyright, términos y privacidad, que son nuestros y no del proveedor original. Una solicitud construida para el endpoint de geocodificación de PositionStack puede enviarse a nuestro host sin cambios, y la respuesta vuelve con la misma estructura que el código existente ya analiza.
Lo que cambia es un nombre de host y una clave. Esa clave se autentica con el método de nuestros cuatro estándar que ya use tu integración: una cabecera X-API-Key, una cabecera Authorization: Bearer, autenticación HTTP Basic con la clave como nombre de usuario o un parámetro de consulta.
Una sola clase de servicio que envuelve una llamada es también el tipo de integración de la que nadie guarda documentación, así que las dudas suelen aparecer más tarde como tickets de soporte de quien heredó el código. La cola de soporte de My Geocode tiene respuestas predefinidas precisamente para estas preguntas recurrentes sobre compatibilidad, el significado de las cabeceras, los formatos de clave, qué cambia y qué no, para que una pregunta sencilla sobre migración se responda rápido en lugar de esperar detrás de otras más complejas.
Probar la estructura de una respuesta antes de tocar el código también es sencillo: la demo interactiva en /demo/ puede enviar una solicitud de ejemplo a cualquier endpoint o host compatible y mostrar los campos exactos que se devuelven, lo que a menudo basta para confirmar que una llamada con la forma de PositionStack se analizará sin problemas en los sistemas posteriores.
Los precios no varían según el host compatible que atienda una solicitud. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin ninguna clave, contadas por red. Una clave añade otras 2.500 solicitudes gratuitas al día propias. Superadas ambas cuotas, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited cubre el uso por 50 € al mes, exactamente igual que en cualquier otro endpoint y host de la plataforma.
Cada respuesta incluye también nuestras cabeceras de cuota: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit y X-Quota-Reset, que ofrecen una visibilidad del uso que una integración simple con PositionStack no expondría.
Para cualquier cosa más allá de los campos estándar de la respuesta compatible, mg_extras=1 en la solicitud, o una cabecera X-MG-Extras, agrega extras opcionales, totalmente a elección y desactivados por defecto.
El host está documentado en /compatibility/positionstack/, con una visión más amplia de cómo funcionan los diecisiete hosts compatibles en /docs/compatibility/. Si PositionStack está escondido en algún servicio de tu stack, apuntarlo aquí es un cambio pequeño y reversible para probar.