Referenciar Ubicaciones Guardadas mediante API
¿Por qué utilizar la Referencia de Ubicación Guardada?
Muchos clientes integrados de Tive utilizan la plataforma para crear ubicaciones guardadas con geocercas precisas. Sin embargo, referenciar estas ubicaciones guardadas mediante la API ha sido a menudo un desafío, lo que ha provocado entradas duplicadas, envíos incompletos y alertas innecesarias.
La Referencia de Ubicación Guardada resuelve estos problemas al permitir a los usuarios hacer referencia a ubicaciones creadas previamente utilizando IDs únicos generados por Tive, en lugar de ingresar manualmente coordenadas y direcciones cada vez.
Beneficios clave:
- Elimina la duplicación de ubicaciones: No es necesario crear la misma ubicación varias veces.
- Reduce errores: Previene problemas que provocan envíos incompletos y ruidos de alerta.
- Agiliza la creación de envíos: Utiliza identificadores guardados para interacciones API más rápidas y confiables.
- Mejora la consistencia: Mantiene datos de ubicación centralizados y precisos en toda su organización.
Nota: Esta función está disponible para clientes del nivel Premium o cualquier cuenta con la bandera API habilitada.
Cómo funciona
Siga los pasos a continuación para asegurarse de que sus ubicaciones guardadas estén referenciadas correctamente a través de la API.
Paso 1: Verificar que las ubicaciones estén guardadas
- Vaya a Configuración > Ubicaciones en la plataforma Tive.
- Haga clic en la pestaña Mis Ubicaciones y asegúrese de que las ubicaciones deseadas aparezcan allí.
- Utilice la barra de búsqueda para localizar una dirección específica o el nombre de una ubicación.
Si una ubicación no está en la pestaña Mis Ubicaciones:
- Vaya a la pestaña Sugerido.
- Busque la ubicación y haga clic en Guardar Ubicación.
- Agregue cualquier información necesaria para guardarlo oficialmente.
Paso 2: Obtener los ID de ubicación
Puede recuperar los ID únicos de Tive (utilizados para referenciar a través de API) de dos maneras:
Opción 1: Vía API (Recomendado)
- Llame al punto final de lista de ubicaciones : /public/v3/Locations.
- Esto devolverá una lista paginada de sus ubicaciones guardadas.
- Cada objeto de ubicación incluirá un campo de identificación que se puede utilizar en la creación de envíos.
Nota: Vea la documentación de la API de Tive aquí .
Opción 2: A través de la Plataforma Tive
- Vaya a Configuración > Ubicaciones.
- Cada ubicación guardada incluye un campo de ID visible que se puede copiar y usar en la API.
Paso 3: Crear un envío usando IDs
- Utilice el punto final Crear envío .
- En lugar de ingresar una dirección y coordenadas para cada tramo:
- Utilice fromLocationId para el origen.
- Utilice toLocationId para el destino.
Esto hace referencia directamente a sus ubicaciones guardadas, lo que simplifica la creación de envíos y garantiza la precisión de los datos.
Puntos clave a saber
Requisitos:
- Solo disponible para clientes de nivel Premium o aquellos con la función API habilitada.
Evite errores comunes:
- No omita guardar una ubicación antes de referenciarla; esto garantiza que esté utilizando geocercas de alta calidad en todos sus envíos generados por API.
- Verifique siempre que esté utilizando el ID de ubicación correcto.
Consejo de integración:
- Funciona perfectamente con otras herramientas API de Tive y flujos de trabajo de gestión de envíos.
- Tive es compatible con SSO a través de SAML 2.0, OpenID Connect, Microsoft Azure AD o Active Directory. Póngase en contacto con su Administrador de Cuenta o Ejecutivo de Cuenta para obtener ayuda con la configuración de una integración.
Mejores prácticas
- Utilice siempre API para obtener ID: Automatizar el proceso de obtención a través de API ayuda a reducir el error humano y agiliza el flujo de trabajo.
- Audite sus ubicaciones guardadas periódicamente: Asegúrese de que sus datos de ubicación estén limpios, actualizados y etiquetados correctamente para evitar confusiones durante las llamadas a la API.
- Centralice la creación de ubicaciones: Limite la creación de ubicaciones a un administrador designado o un sistema automatizado para mantener la coherencia de los datos y evitar duplicados.