Bekerja dengan polyline

Developer Wilayah Ekonomi Eropa (EEA)

Metode computeRoutes menampilkan rute yang diwakili oleh polyline sebagai bagian dari respons. Anda dapat meminta dua jenis polyline:

  • Polyline dasar (default), merepresentasikan rute, tetapi tanpa informasi lalu lintas yang disematkan dalam polyline. Permintaan yang menampilkan polyline dasar ditagih dengan tarif Routes Basic. Pelajari lebih lanjut penagihan untuk Routes API.
  • Polyline yang mengetahui lalu lintas, berisi informasi tentang kondisi lalu lintas di sepanjang rute. Kondisi lalu lintas dinyatakan dalam kategori kecepatan (NORMAL, SLOW, TRAFFIC_JAM) yang berlaku pada interval polyline tertentu. Permintaan untuk polyline yang mengetahui kondisi lalu lintas ditagih dengan tarif Routes Preferred. Pelajari lebih lanjut penagihan untuk Routes API.
  • Polyline multimodal, berisi detail transportasi umum serta informasi lalu lintas. Permintaan untuk polyline multimodal ditagih dengan tarif Routes Preferred. Pelajari lebih lanjut penagihan untuk Routes API.

Polyline dasar (default)

Polyline direpresentasikan oleh objek Polyline; jalur adalah array koordinat LatLngAltitude. Untuk menampilkan polyline dasar, panggil metode computeRoutes dengan properti fields yang ditetapkan ke path, lalu panggil metode createPolylines pada instance rute untuk mendapatkan objek Polyline.

Contoh berikut menunjukkan cara meminta polyline dasar:

// 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.
};

Polyline yang mengetahui kondisi lalu lintas

Untuk meminta polyline yang mengetahui traffic, tambahkan properti berikut ke permintaan Anda:

  1. Tetapkan properti travelMode ke DRIVING.
  2. Tetapkan properti routingPreference ke TRAFFIC_AWARE.
  3. Tetapkan properti extraComputations ke TRAFFIC_ON_POLYLINE.
  4. Tentukan kolom path, speedPaths, dan routeLabels.

Contoh berikut menunjukkan cara meminta polyline yang mengetahui kondisi lalu lintas:

// 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'],
};

Menampilkan polyline di peta

Untuk menampilkan polyline di peta, panggil createPolylines pada objek rute, lalu gunakan metode setMap untuk menyetel peta polyline ke objek peta. Objek peta digunakan untuk menampilkan polyline di peta.

Contoh berikut menunjukkan cara menampilkan polyline di peta:

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