> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tread.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Coordenadas de Sitios y Geocercas
> Envía lat y lon en los Sitios importados para que Tread construya una geocerca funcional y registre eventos de llegada y salida.
Las coordenadas enviadas mediante las [APIs de Importador](/es/api-reference/importer-apis) 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](/es/concepts/sites-geofences) 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.
```json theme={null}
{
"projects": [
{
"external_id": "PRJ-2025-014",
"customer": { "external_id": "CUST-441" },
"sites": [
{
"waypoint": "pickup",
"external_id": "SITE-QUARRY-1",
"name": "Quarry Rd Scale House",
"site_type": "Quarry",
"full_address": "4500 Quarry Rd, Denver, CO",
"lat": 39.812345,
"lon": -105.087654
},
{
"waypoint": "drop_off",
"external_id": "SITE-JOB-19",
"name": "Main St Paving",
"site_type": "JobSite",
"full_address": "800 Main St, Denver, CO",
"lat": 39.745210,
"lon": -104.998320
}
]
}
]
}
```
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.
Busca el panel **Geofence Creation**. Consulta [Configuraciones de la plataforma](/es/onboarding/platform-configurations) para el resto de los ajustes de esta página.
**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 campo muestra pies o metros según el ajuste de unidades de tu empresa. La API siempre usa metros.
| Tipo de sitio | Radio típico |
| ---------------------------- | ---------------------- |
| Pozo grande, cantera o patio | 100–150 m (330–500 ft) |
| Planta o depósito | 75–100 m (250–330 ft) |
| Entrega urbana estrecha | \~50 m (165 ft) |
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.
```json theme={null}
{
"waypoint": "pickup",
"external_id": "SITE-QUARRY-1",
"name": "Quarry Rd Scale House",
"lat": 39.812345,
"lon": -105.087654,
"next_billion_geofence": {
"geofence": {
"name": "Quarry Rd",
"type": "circle",
"circle_radius": 120
}
}
}
```
`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](/es/workflows/track-drivers-collect-tickets).
* 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
* [APIs de Importador](/es/api-reference/importer-apis) — los payloads de `/ingest/projects` y `/ingest/orders`
* [Sitios y Geocercas](/es/concepts/sites-geofences) — tipos de geocerca, temporizadores y comportamiento de auto-finalización
* [Configuraciones de la plataforma](/es/onboarding/platform-configurations) — los valores predeterminados de geocerca de la empresa
* [Onboarding: Sitios](/es/onboarding/master-data/sites) — configurar Sitios en la app
* [Pavimentación y Geocercas Móviles](/es/specialized/paving-geofences) — cercas que se mueven con el trabajo