Skip to main content
Las coordenadas enviadas mediante las APIs de Importador son lo que convierte un Sitio importado en seguimiento de camiones en vivo. Hazlo bien y las llegadas, salidas y tiempos de ciclo se registran solos. Hazlo mal y el Sitio se importa sin ninguna cerca a su alrededor, y cada carga necesita una llamada telefónica.

​
Envía lat y lon juntos

Incluye lat y lon en cada Sitio de tu array sites. Esos dos valores son con los que Tread construye la geocerca (una cerca virtual alrededor de un Sitio). Envía ambos o ninguno.
Reglas de formato:
  • Grados decimales con signo. La longitud es negativa en Norteamérica. Sin sufijos N/W y sin grados-minutos-segundos.
  • Seis decimales, máximo. Tread almacena seis, que son unos 10 centímetros. Los dígitos extra se redondean, así que no se gana nada enviando doce.
  • Números, no cadenas entre comillas.
lat sin lon falla la validación, y el Sitio se descarta del payload sin ningún error. El Proyecto aún devuelve processed — esa recogida o entrega simplemente falta. Enviar ni coordenadas ni full_address produce lo mismo.
Los Proyectos leen solo los waypoints pickup y drop_off. Los Pedidos también leen staging.

​
Apunta a donde paran los camiones

La geocerca es un círculo centrado exactamente en el lat/lon que envías. Apúntalo a la caseta de báscula, la entrada o el acopio. Una dirección postal o el centroide de una parcela es la razón más común de que una cerca nunca se active. Las coordenadas caen en un lugar donde ningún camión estaciona, así que ningún ping de GPS cae dentro del círculo.

​
Las coordenadas superan a las direcciones

Envía lat/lon siempre que tu sistema de origen las tenga. Cuando un Sitio llega con full_address y sin coordenadas, Tread geocodifica la dirección y acepta el resultado solo cuando Google devuelve una coincidencia ROOFTOP o GEOMETRIC_CENTER. Las direcciones rurales de canteras y obras a menudo resuelven a RANGE_INTERPOLATED o APPROXIMATE. Tread las rechaza a propósito, porque una cerca en el lugar equivocado es peor que ninguna cerca. El Sitio se crea sin coordenadas y sin geocerca. Dos cosas más que conviene saber sobre este respaldo:
  • La geocodificación se ejecuta solo cuando lat y lon están ambos vacíos. Nunca sobrescribe las coordenadas que enviaste.
  • Una dirección de UNDEFINED o UNKNOWN se omite en lugar de geocodificarse. Las integraciones envían estas como valores de relleno.
Conserva full_address incluso cuando envíes coordenadas. Tread la usa como etiqueta de la geocerca y para visualización.

​
Configura el radio predeterminado primero

Con las coordenadas presentes, Tread dibuja un círculo centrado en ellas usando el radio predeterminado de tu empresa. Confirma ese valor antes de tu primera importación.
1

Abre Settings → Configuration

Busca el panel Geofence Creation. Consulta Configuraciones de la plataforma para el resto de los ajustes de esta página.
2

Configura Auto Geofence Type en Circle

None no almacena ningún radio predeterminado, así que no se crea ninguna geocerca — no importa qué tan buenas sean tus coordenadas. El campo Radius solo aparece cuando el tipo es Circle.El ajuste Geofence Creation con Auto Geofence Type en Circle y el campo Radius resaltado
3

Dimensiona el radio según el sitio

El campo muestra pies o metros según el ajuste de unidades de tu empresa. La API siempre usa metros.Cubre el área de trabajo más la deriva del GPS. Evita que los círculos de Sitios vecinos se solapen, o la atribución de llegada y salida se vuelve ambigua.

​
Sobrescribe el radio en un solo Sitio

Agrega un objeto next_billion_geofence a un Sitio para sobrescribir el valor predeterminado de la empresa. circle_radius está en metros y debe ser mayor que cero. circle_center toma por defecto el lat/lon del Sitio cuando lo omites.
type acepta circle o polygon. Los polígonos toman un objeto geojson en lugar de un radio.
Un next_billion_geofence mal formado descarta el Sitio completo, silenciosamente, igual que unas coordenadas incorrectas. Omite la clave por completo cuando no estés sobrescribiendo el valor predeterminado.

​
Las coordenadas se establecen una sola vez

Un Sitio que coincide con un registro existente se reutiliza tal cual. Tread coincide por external_id, o por name cuando el Sitio almacenado no tiene external_id. Los nuevos valores de lat/lon en un payload posterior se ignoran. Acierta con las coordenadas en la primera importación. Las correcciones posteriores pasan por la app de Tread o el endpoint REST de Sitios, no por las APIs de Importador.

​
Verifica después de importar

Un 202 Accepted y un estado processed no prueban que el Sitio se haya creado. Revisa el mapa en su lugar.
  • El Sitio dibuja un círculo en el Live Map.
  • Las cargas que pasan por él registran eventos de llegada y salida.
  • Un Sitio que aparece en el Proyecto pero no dibuja círculo significa que sus coordenadas o el radio predeterminado fallaron.

​
Trampas comunes

  • Una coordenada sin la otra descarta el Sitio. No aparece ningún error en el registro importado. Envía ambas o ninguna.
  • Auto Geofence Type en None significa ninguna geocerca. Coordenadas perfectas siguen sin producir nada.
  • Las direcciones postales ponen la cerca en el lugar equivocado. Usa la caseta de báscula, la entrada o el acopio.
  • Los Sitios solo con dirección a menudo no obtienen coordenadas. Cualquier cosa menos precisa que GEOMETRIC_CENTER se rechaza, lo que deja al Sitio sin cerca.
  • Reimportar no corrige las coordenadas. Los Sitios coincidentes conservan los valores con los que fueron creados.
  • Los círculos solapados confunden la atribución. Reduce el radio o cambia a un polígono.

​
Relacionado