Definir um ponto para um trajeto

Desenvolvedores do Espaço Econômico Europeu (EEE)

Por padrão, os pontos intermediários são usados para paradas de embarque e desembarque, mas você também pode especificar que um ponto intermediário é apenas para passagem.

Um trajeto que contém um waypoint de origem, um waypoint intermediário de passagem e um waypoint de destino tem apenas um trecho que conecta a origem e o destino, passando pelo waypoint intermediário (chamado de via).

Configure um waypoint intermediário para ser um waypoint de passagem definindo a propriedade via do waypoint como true usando a interface Waypoint.

A propriedade via é mais eficaz ao criar rotas em resposta ao usuário arrastando os waypoints no mapa. Isso permite que o usuário veja como o trajeto final pode ficar em tempo real e ajuda a garantir que os waypoints sejam colocados em locais acessíveis à biblioteca Routes.

Exemplo de solicitação

O exemplo de solicitação a seguir demonstra como marcar um waypoint intermediário como um waypoint de passagem.

const routeRequestWithVia = {
  origin: '100 Moffett Blvd, Mountain View, CA 94043',
  destination: '1199 9th Ave, San Francisco, CA 94122',
  travelMode: 'DRIVING',
  intermediates: [
    {location: 'Half Moon Bay, CA', via: true} // Set the via property to true
  ],
  fields: ['path', 'legs'],
};

// Make the request.
const {routes, fallbackInfo, geocodingResults} = await Route.computeRoutes(routeRequestWithIntermediates);
  

Acessar IDs de lugar para waypoints intermediários

Se você especificar o local de um ponto de origem, destino ou intermediário como uma string de endereço ou um Plus Code, a biblioteca Routes vai tentar encontrar o local mais relevante que tenha um ID de lugar correspondente. A matriz geocodingResults.intermediates nos resultados contém o ID de lugar correspondente ao local dos waypoints, além de outros dados sobre o local.

Exemplo de resposta com resultados de geocodificação

{
  "origin": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJb5NgcTa3j4ARrfF4Oc_f6q8",
    "intermediateWaypointRequestIndex": null
  },
  "destination": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJAbIPLl2HhYARQ0SSdDFxU-s",
    "intermediateWaypointRequestIndex": null
  },
  "intermediates": [
    {
      "geocoderStatus": "OK",
      "types": [
        "locality",
        "political"
      ],
      "partialMatch": false,
      "placeId": "ChIJC8sZCqULj4ARVJvnNcic_V4",
      "intermediateWaypointRequestIndex": 0
    }
  ]
}