Praca z liniami łamanymi

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Metoda computeRoutes zwraca trasę przedstawioną w postaci linii łamanej w ramach odpowiedzi. Możesz poprosić o 2 rodzaje polilinii:

  • Podstawowa linia łamana (domyślna), która reprezentuje trasę, ale bez informacji o ruchu drogowym osadzonych w linii łamanej. Żądania, które zwracają podstawową linię łamaną, są rozliczane według stawki za Routes Basic. Więcej informacji o płatnościach za interfejs Routes API
  • Linia łamana uwzględniająca natężenie ruchu, która zawiera informacje o warunkach na drodze na trasie. Warunki na drogach są wyrażane w kategoriach prędkości (NORMAL, SLOW, TRAFFIC_JAM) obowiązujących w danym przedziale polilinii. Żądania polilinii uwzględniających ruch są rozliczane według stawki za trasy preferowane. Więcej informacji o płatnościach za interfejs Routes API
  • Linia multimodalna, która zawiera szczegółowe informacje o transporcie publicznym oraz dane o ruchu. Żądania dotyczące polilinii multimodalnych są rozliczane według stawki za trasy preferencyjne. Więcej informacji o płatnościach za interfejs Routes API

Podstawowa linia łamana (domyślna)

Linia łamana jest reprezentowana przez obiekt Polyline, a ścieżka to tablica współrzędnych LatLngAltitude. Aby zwrócić podstawową polilinię, wywołaj metodę computeRoutes z właściwością fields ustawioną na path, a następnie wywołaj metodę createPolylines w instancji trasy, aby uzyskać obiekt Polyline.

Ten przykład pokazuje, jak wysłać żądanie podstawowej linii łamanej:

// Define a basic routes request.
const requestWithBasicPolyline = {
  origin: '155 Steuart St, San Francisco, CA 94105',
  destination: '450 Powell St, San Francisco, CA 94102',
  travelMode: 'WALKING',
  fields: ['path'],  // Request path field to get a polyline.
};

Linia łamana uwzględniająca ruch

Aby poprosić o linię łamaną uwzględniającą ruch, dodaj do żądania te właściwości:

  1. Ustaw właściwość travelMode na DRIVING.
  2. Ustaw właściwość routingPreference na TRAFFIC_AWARE.
  3. Ustaw właściwość extraComputations na TRAFFIC_ON_POLYLINE.
  4. Określ pola path, speedPaths i routeLabels.

Poniższy przykład pokazuje, jak wysłać żądanie dotyczące linii łamanej uwzględniającej ruch:

// Define a traffic aware routes request.
const requestWithTraffic = {
  origin: '200 King St San Francisco, CA 94107',
  destination: 'Pier 41, San Francisco, CA 94133',
  travelMode: 'DRIVING',
  routingPreference: 'TRAFFIC_AWARE',
  extraComputations: ['TRAFFIC_ON_POLYLINE'],
  fields: ['speedPaths'],
};

Wyświetlanie linii łamanych na mapie

Aby wyświetlić linie łamane na mapie, wywołaj metodę createPolylines na obiekcie trasy, a następnie użyj metody setMap, aby ustawić mapę linii łamanej na obiekt mapy. Obiekt mapy służy do wyświetlania linii łamanej na mapie.

Ten przykład pokazuje, jak wyświetlić linię łamaną na mapie:

  // Call createPolylines to create polylines for the first route.
  mapPolylines = routes[0].createPolylines();
  // Add polylines to the map.
  mapPolylines.forEach((polyline) => polyline.setMap(map));