Ustawianie punktu na drodze, przez którą przechodzi

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Domyślnie punkty pośrednie służą do zatrzymywania się w celu odbioru i wysadzenia pasażerów, ale możesz też określić, że punkt pośredni ma służyć tylko do przejazdu.

Trasa, która zawiera punkt początkowy, punkt pośredni i punkt docelowy, ma tylko 1 etap łączący punkt początkowy z docelowym, który przebiega przez punkt pośredni (nazywany via).

Skonfiguruj punkt pośredni jako punkt, przez który ma przebiegać trasa, ustawiając właściwość via punktu na true za pomocą interfejsu Waypoint.

Właściwość via jest najbardziej przydatna podczas tworzenia tras w odpowiedzi na przeciąganie przez użytkownika punktów pośrednich na mapie. Dzięki temu użytkownik może zobaczyć, jak będzie wyglądać ostateczna trasa w czasie rzeczywistym, i upewnić się, że punkty pośrednie są umieszczone w lokalizacjach dostępnych dla biblioteki Routes.

Przykładowe żądanie

Ten przykładowy request pokazuje, jak oznaczyć punkt pośredni jako punkt, przez który ma przebiegać trasa.

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);

Dostęp do identyfikatorów miejsc dla pośrednich punktów trasy

Jeśli określisz lokalizację punktu początkowego, docelowego lub pośredniego jako ciąg adresu lub kod plus, biblioteka Routes spróbuje znaleźć najbardziej odpowiednią lokalizację, która ma odpowiedni identyfikator miejsca. Tablica geocodingResults.intermediates w wynikach zawiera identyfikator miejsca odpowiadający lokalizacji punktów pośrednich oraz dodatkowe dane o lokalizacji.

Przykładowa odpowiedź z wynikami geokodowania

{
  "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
    }
  ]
}