Conceptos clave

Para generar una isócrona, proporciona a la API un origen, un medio de transporte, como auto, moto, bicicleta o a pie, y un límite de tiempo. También puedes ajustar las preferencias de rutas y la apariencia visual del polígono resultante.

Horizonte temporal

La restricción principal que proporcionas al servicio es travel_duration. Esto define el horizonte temporal para el cálculo.

• Duración máxima: La API admite una duración del viaje máxima de 3,600 segundos (1 hora) para los modos DRIVE y TWO_WHEELER, y de 7,200 segundos (2 horas) para los modos WALK y BICYCLE.
• Rendimiento: El tiempo de cálculo se ajusta según la duración solicitada y el medio de transporte seleccionado. Una isócrona de una hora en auto abarca un área geográfica y una red de rutas mucho más grandes que una isócrona de una hora a pie, lo que genera una mayor latencia para la solicitud de conducción.
• Formato: Debido a que la API usa google.protobuf.Duration, la duración debe tener el formato de una cadena que termine en "s" (por ejemplo, "3600s") en lugar de un número entero.

Puntos de origen y ajuste de rutas

Puedes especificar el punto de partida de la isócrona de dos maneras:

• Coordenadas: Un par de latitud y longitud (location).
• IDs de lugar: Un identificador único para un lugar específico en Google Maps (place). Cuando proporcionas un ID de lugar, el servicio usa el centroide de ese lugar como punto de origen. Ten en cuenta que la API espera el formato de nombre del recurso, como places/ChIJ.... Para obtener más información sobre los IDs de lugar, consulta IDs de lugar.

Independientemente del método de entrada, la API no calcula los tiempos de viaje desde el punto físico exacto si ese punto no está en una ruta, como dentro de un parque o un edificio. Para controlar esta situación, el servicio usa el ajuste de rutas. El ajuste de rutas tiene las siguientes características:

• Ajuste inteligente: El servicio intenta ajustar tu punto de origen al segmento de ruta más cercano que se pueda recorrer.
• Conocimiento del modo: La lógica de ajuste tiene en cuenta tu travel_mode. Si solicitas DRIVE o TWO_WHEELER, la API ignora las rutas solo para peatones y busca la calle más cercana que se pueda conducir. Si solicitas WALK, la API prioriza las rutas y las veredas que se pueden recorrer a pie.
• Casos de falla: Si la API no puede encontrar un segmento de ruta adecuado dentro de la distancia máxima de ajuste de tu punto de origen (aproximadamente 150 a 200 metros, según el medio de transporte: 200 metros para DRIVE y TWO_WHEELER, 180 metros para BICYCLE y 150 metros para WALK), la API muestra un error 404 NOT_FOUND. Por lo general, esto indica que el punto está demasiado lejos de la red de rutas o en un área en la que los datos del mapa no admiten el medio de transporte solicitado.

Dirección del viaje (hacia la ciudad o desde la ciudad)

Puedes calcular la accesibilidad hacia la ciudad y desde la ciudad con el parámetro travelDirection:

• FROM (desde la ciudad): Calcula el área accesible desde el punto de origen dentro del límite de tiempo especificado. Esto es adecuado para casos de uso como zonas de entrega o cobertura de servicios.
• TO (hacia la ciudad): Calcula el área desde la que puedes viajar hasta el punto de origen dentro del límite de tiempo especificado. Esto es adecuado para determinar zonas de captación, como desde dónde pueden viajar los empleados para llegar a una oficina central.

Conocimiento del tráfico

Controla cómo los datos de tráfico influyen en el polígono generado con el parámetro routing_preference:

• TRAFFIC_UNAWARE (predeterminado): Usa los límites de velocidad y la jerarquía de rutas para generar el polígono de isócrona. Esto produce una forma determinista que no fluctúa según la hora del día. Este parámetro es ideal para el análisis general o la planificación de situaciones de referencia.
• TRAFFIC_AWARE: Calcula las isócronas con condiciones de tráfico en vivo o predictivas en el momento de la solicitud, lo que hace que el área accesible se reduzca durante la congestión y se expanda durante las horas de menor actividad. Nota: El enrutamiento con conocimiento del tráfico solo se admite cuando travel_mode se establece en DRIVE o TWO_WHEELER.

Nota: Las isócronas con conocimiento del tráfico son más sensibles a la latencia que las isócronas sin conocimiento del tráfico isócronas.

Suavizado y fidelidad

Puedes personalizar la apariencia y la precisión de los polígonos de salida con los parámetros polygon_fidelity y enable_smoothing. Si bien estas opciones son independientes, funcionan juntas para determinar la forma final.

• polygon_fidelity: Controla el tamaño de las celdas de cuadrícula subyacentes que se usan para calcular el área accesible.

  • LOW: Usa celdas de cuadrícula más grandes. Es la mejor opción para cubrir áreas grandes sin espacios, lo que da como resultado una forma generalizada.
  • MEDIUM: Precisión equilibrada.
  • HIGH: Usa celdas de cuadrícula más pequeñas. Da como resultado un ajuste más preciso a la red de rutas, pero puede producir áreas vacías o agujeros si la red de rutas es escasa.
  • POLYGON_FIDELITY_UNSPECIFIED: Si no se especifica, el servicio selecciona de forma dinámica la fidelidad según la duración del viaje solicitada.

    

    Fidelidad de polígonos alta, media y baja

• enable_smoothing: Controla si se redondean los bordes afilados de las celdas de cuadrícula definidas por la fidelidad.

  • false (sin procesar): Es el valor predeterminado. Muestra el cálculo geométrico exacto. Los bordes aparecen irregulares o escalonados. Es la mejor opción para la precisión analítica, como las pruebas estrictas de punto en polígono. Menor latencia que el suavizado.
  • true (suavizado): Aplica un algoritmo de posprocesamiento para redondear las esquinas. Es la mejor opción para la visualización en mapas.

    

    Isócrona con y sin suavizado