Method: isochrones.generate

Calcula e retorna uma única isócrona para um determinado conjunto de parâmetros.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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)

Obrigatório. O tempo de viagem para o cálculo da isócrona. O valor precisa ser positivo e limitado a 7.200 segundos (120 minutos). Para o modo DRIVE, a duração máxima permitida é de 3.600 segundos (60 minutos).

Duração em segundos com até nove dígitos fracionários, terminando em 's'. Exemplo: "3.5s".
travelMode

enum (TravelMode)

Obrigatório. O modo de transporte.
travelDirection

enum (TravelDirection)

Obrigatório. A direção da viagem.
routingPreference

enum (RoutingPreference)

Opcional. Especifica a preferência de como rotear. O padrão é TRAFFIC_UNAWARE.
enableSmoothing

boolean

Opcional. Especifica se as bordas dos polígonos isócronos resultantes precisam ser suavizadas.
polygonFidelity

enum (PolygonFidelity)

Opcional. Controla a precisão do polígono gerado. O padrão é POLYGON_FIDELITY_UNSPECIFIED.
Campo de união origin. Obrigatório. O ponto de partida para o cálculo da isócrona. origin pode ser apenas de um dos tipos a seguir:
location

object (LatLng)

A origem como uma coordenada de latitude/longitude.
place

string

O nome do recurso de um lugar, no formato places/{place_id}.

Corpo da resposta

Uma resposta contendo os dados da isócrona gerada.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "isochrone": {
    object (Isochrone)
  }
}
Campos
isochrone

object (Isochrone)

Apenas saída. A isócrona gerada.

LatLng

Um objeto que representa um par de latitude/longitude. Ele é expresso como um par de valores duplos para representar graus de latitude e longitude. A menos que especificado de outra forma, esse objeto precisa seguir o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.

Representação JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

TravelMode

Define o modo de transporte para o cálculo da isócrona.

Tipos enumerados
TRAVEL_MODE_UNSPECIFIED Nenhum modo de viagem especificado.
DRIVE Viagem de carro de passeio.
BICYCLE Viagem de bicicleta.
WALK Viagem a pé.

TravelDirection

Especifica a direção da viagem para o cálculo da isócrona.

Tipos enumerados
TRAVEL_DIRECTION_UNSPECIFIED Nenhuma direção de viagem especificada.
FROM Calcula a área acessível a partir do ponto de origem. Exemplo: "Onde posso fazer entregas a partir do meu armazém em 30 minutos?"
TO Calcula a área de onde você pode viajar até o ponto de origem. Exemplo: "De onde meus funcionários podem se deslocar para chegar ao escritório em 30 minutos?"

RoutingPreference

Determina como as condições de trânsito são incorporadas ao cálculo.

Tipos enumerados
ROUTING_PREFERENCE_UNSPECIFIED Nenhuma preferência de rota especificada. O servidor vai usar o padrão, que é TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE O cálculo não vai considerar as condições de trânsito. A isócrona será baseada na rede viária e nos tempos de viagem estáticos. Isso é adequado para fins de planejamento em que o trânsito não é um fator.
TRAFFIC_AWARE O cálculo vai considerar as condições de trânsito em tempo real.

PolygonFidelity

Controla o nível de detalhes no polígono isócrono.

Tipos enumerados
POLYGON_FIDELITY_UNSPECIFIED Nenhuma fidelidade de polígono especificada. O servidor vai usar o padrão, que é baseado na duração da viagem.
LOW Baixa precisão. Bom para cobrir grandes áreas com menos vértices.
MEDIUM Precisão média. Um equilíbrio entre detalhes e tamanho do artefato.
HIGH Alta precisão. Bordas de alta fidelidade, mas podem produzir buracos no polígono onde a densidade da rede viária é baixa.

Isochrone

O resultado de um cálculo de isócrona, que representa uma área de acessibilidade de um ponto de origem dentro de um tempo de viagem especificado.

Representação 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ão geometry. A representação geométrica da isócrona. geometry pode ser apenas de um dos tipos a seguir:
geoJson

object (Struct format)

A geometria da isócrona no formato GeoJSON, usando o formato RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.