Method: isochrones.generate

Calcula y devuelve una sola isócrona para un conjunto determinado de parámetros.

Solicitud HTTP

POST https://isochrones.googleapis.com/v1/isochrones:generate

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "travelDuration": string,
  "travelMode": enum (TravelMode),
  "travelDirection": enum (TravelDirection),
  "routingPreference": enum (RoutingPreference),
  "enableSmoothing": boolean,
  "polygonFidelity": enum (PolygonFidelity),

  // Union field origin can be only one of the following:
  "location": {
    object (LatLng)
  },
  "place": string
  // End of list of possible types for union field origin.
}
Campos
travelDuration

string (Duration format)

Obligatorio. Es la duración del viaje para el cálculo de la isócrona. El valor debe ser positivo y no puede superar los 7,200 segundos (120 minutos). En el modo DRIVE, la duración máxima permitida es de 3,600 segundos (60 minutos).

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
travelMode

enum (TravelMode)

Obligatorio. Es el medio de transporte.
travelDirection

enum (TravelDirection)

Obligatorio. Es la dirección del viaje.
routingPreference

enum (RoutingPreference)

Opcional. Especifica la preferencia de cómo generar la ruta. La configuración predeterminada es TRAFFIC_UNAWARE.
enableSmoothing

boolean

Opcional. Especifica si se deben suavizar los bordes de los polígonos de isócronas resultantes.
polygonFidelity

enum (PolygonFidelity)

Opcional. Controla la precisión del polígono generado. La configuración predeterminada es POLYGON_FIDELITY_UNSPECIFIED.
Campo de unión origin. Obligatorio. Es el punto de partida para el cálculo de la isócrona. origin puede ser solo uno de los parámetros siguientes:
location

object (LatLng)

Es el origen como una coordenada de latitud y longitud.
place

string

Es el nombre del recurso de un lugar, en formato places/{place_id}.

Cuerpo de la respuesta

Es una respuesta que contiene los datos de la isócrona generada.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "isochrone": {
    object (Isochrone)
  }
}
Campos
isochrone

object (Isochrone)

Solo salida. Es la isócrona generada.

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de números de punto flotante de doble precisión que representan los grados de latitud y longitud. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

TravelMode

Define el medio de transporte para el cálculo de la isócrona.

Enums
TRAVEL_MODE_UNSPECIFIED No se especificó ningún medio de viaje.
DRIVE Viajar en automóvil de pasajeros
BICYCLE Viajar en bicicleta
WALK Viajar a pie

TravelDirection

Especifica la dirección del viaje para el cálculo de la isócrona.

Enums
TRAVEL_DIRECTION_UNSPECIFIED No se especificó la dirección del viaje.
FROM Calcula el área a la que se puede llegar desde el punto de origen. Ejemplo: "¿A dónde puedo hacer entregas desde mi almacén en 30 minutos?"
TO Calcula el área desde la que puedes viajar hasta el punto de origen. Por ejemplo: "¿Desde dónde pueden viajar mis empleados para llegar a la oficina en 30 minutos?".

RoutingPreference

Determina cómo se incorporan las condiciones de tráfico en el cálculo.

Enums
ROUTING_PREFERENCE_UNSPECIFIED No se especificó ninguna preferencia de enrutamiento. El servidor usará su valor predeterminado, que es TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE El cálculo no tendrá en cuenta las condiciones del tráfico. La isócrona se basará en la red de rutas y los tiempos de viaje estáticos. Es adecuado para fines de planificación en los que el tráfico no es un factor.
TRAFFIC_AWARE El cálculo tendrá en cuenta las condiciones del tráfico en tiempo real.

PolygonFidelity

Controla el nivel de detalle del polígono de isocrona.

Enums
POLYGON_FIDELITY_UNSPECIFIED No se especificó la fidelidad del polígono. El servidor usará su valor predeterminado, que se basa en la duración del viaje.
LOW Precisión baja. Es ideal para cubrir áreas grandes con menos vértices.
MEDIUM Precisión media: Es un equilibrio entre el detalle y el tamaño del artefacto.
HIGH Alta precisión Bordes de alta fidelidad, pero es posible que produzca agujeros en el polígono donde la densidad de la red vial es baja.

Isócrona

Es el resultado del cálculo de una isócrona, que representa un área de accesibilidad desde un punto de origen dentro de una duración del viaje especificada.

Representación JSON 
{

  // Union field geometry can be only one of the following:
  "geoJson": {
    object
  }
  // End of list of possible types for union field geometry.
}
Campos
Campo de unión geometry. Es la representación geométrica de la isócrona. geometry puede ser solo uno de los parámetros siguientes:
geoJson

object (Struct format)

Es la geometría de la isócrona en formato GeoJSON, con el formato RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.