Menetapkan perhentian di sepanjang rute

Developer Wilayah Ekonomi Eropa (EEA)

Anda dapat menetapkan perhentian di sepanjang rute, seperti untuk pengambilan atau penurunan, dengan salah satu dari dua cara berikut:

  • Menambahkan titik jalan perantara: Opsi ini merupakan default. Tambahkan titik jalan perantara antara tempat asal dan tujuan dalam array intermediates. Mesin perutean akan mengarahkan titik jalan ke jalan yang dapat dilalui terdekat dan membagi rute menjadi segmen RouteLeg yang terhubung dengan perhentian tersebut.
  • Menentukan vehicleStopover: Jika Anda ingin mesin perutean melakukan analisis tambahan untuk menghindari segmen jalan yang tidak sesuai untuk berhenti—seperti jalan raya, terowongan, atau jalan layang—tetapkan vehicleStopover: true pada titik jalan.

Menambahkan titik jalan perantara

Untuk menetapkan perhentian di sepanjang rute, tambahkan titik jalan perantara ke array intermediates dalam permintaan Anda.

Menambahkan titik jalan perantara akan memberikan efek berikut:

  • Rute dibagi menjadi RouteLeg segmen: Setiap segmen menghubungkan satu perhentian ke perhentian berikutnya.
  • Koordinat diarahkan ke jalan: Mesin perutean akan mengarahkan koordinat lintang dan bujur Anda, yang mungkin berada di atap atau di halaman, ke segmen jalan yang dapat dilalui terdekat.

Untuk banyak jalan di permukaan, pengarahan ke jalan terdekat memberikan lokasi perhentian yang praktis. Namun, pengarahan tidak menentukan apakah segmen jalan tersebut sesuai untuk berhenti, seperti saat jalan terdekat adalah jalan raya atau terowongan.

Contoh: Menambahkan titik jalan perantara

Contoh berikut menunjukkan cara menetapkan perhentian di sepanjang rute dengan menambahkan titik jalan perantara dalam permintaan POST computeRoutes:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Untuk mengetahui informasi selengkapnya tentang titik jalan perantara dan segmen rute, lihat Menetapkan titik jalan perantara.

Menentukan vehicleStopover untuk kesesuaian pengambilan dan penurunan

Meskipun titik jalan perantara standar diarahkan ke jalan terdekat, jalan tersebut tidak selalu sesuai untuk perhentian kendaraan. Jika Anda ingin mesin perutean melakukan analisis tambahan untuk mengevaluasi kesesuaian jalan untuk pengambilan atau penurunan, tetapkan vehicleStopover: true pada titik jalan.

Saat Anda menetapkan vehicleStopover: true, mesin perutean akan mengevaluasi segmen jalan kandidat dan mencoba menghindari jalan yang tidak sesuai untuk berhenti, seperti jalan bebas hambatan, terowongan, dan jalan layang.

Misalnya, pertimbangkan lokasi tempat jalan di permukaan melewati jalan raya di dalam terowongan: * Titik jalan perantara standar: Diarahkan ke jalan raya atau terowongan di bawahnya jika secara geometris lebih dekat ke koordinat Anda. * Perhentian kendaraan: Melakukan analisis tambahan untuk melewati jalan raya dan terowongan, mengarahkan perhentian ke jalan di permukaan yang sesuai untuk berhenti.

Contoh: Menentukan vehicleStopover pada titik jalan

Contoh berikut menunjukkan cara menetapkan vehicleStopover: true pada titik jalan perantara dalam permintaan POST lengkap:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Untuk mengetahui informasi selengkapnya tentang jenis dan opsi titik jalan, lihat Jenis dan opsi titik jalan.