Mendapatkan rute transportasi umum

Developer Wilayah Ekonomi Eropa (EEA)

Rute transportasi umum memberikan petunjuk navigasi menggunakan opsi transportasi umum yang tersedia di wilayah tersebut. Opsi transportasi umum dapat mencakup bus, kereta bawah tanah, dan kereta api, serta opsi lainnya. Rute transportasi umum juga biasanya menyertakan petunjuk tentang cara berjalan kaki ke, dari, dan di antara stasiun transportasi umum. Karena rute transportasi umum biasanya mengharuskan Anda bepergian menggunakan lebih dari satu moda transportasi, cara Anda meminta rute dan beberapa bagian responsnya berbeda.

Perbedaan rute transportasi umum dengan rute lainnya

Rute transportasi umum, yang Anda minta dengan menetapkan travelMode TRANSIT, berbeda dengan rute yang menggunakan opsi mode perjalanan yang berbeda. Anda tidak dapat meminta semua objek dan opsi yang sama, dan respons menampilkan kolom yang berbeda, jika dibandingkan dengan rute lain.

Di Routes API, langkah-langkah secara konsisten merupakan satu petunjuk navigasi di semua jenis perjalanan. Jadi, setiap petunjuk navigasi adalah langkah. Respons rute transportasi umum sangat mirip dengan rute dengan moda transportasi lainnya, dengan beberapa perbedaan utama:

Perbedaan permintaan Perbedaan respons
Anda tidak dapat menentukan titik jalan perantara. Mencakup detail Transit.
Tidak dapat melihat rute ramah lingkungan Mencakup metadata untuk setiap mode perjalanan yang berisi ringkasan langkah-langkah untuk mode perjalanan tersebut, dalam stepsOverview (untuk meminta metadata ini, gunakan mask kolom stepsOverview).
Tidak dapat menentukan cara dan apakah akan menyertakan data traffic
Tidak dapat menentukan fitur rute yang harus dihindari
Hanya dapat menentukan transitPreferences. Untuk mengetahui detailnya, lihat TransitPreference.

Untuk melihat rute transportasi umum

  1. Tetapkan asal dan tujuan Anda.
  2. Tetapkan travelMode ke TRANSIT.
  3. Tambahkan mask kolom yang sesuai untuk mendapatkan respons yang Anda butuhkan. Lihat Meminta kolom rute transportasi umum yang Anda butuhkan.
  4. Jika perlu, tetapkan parameter opsional. Lihat Menetapkan parameter untuk rute transit

Meminta kolom rute transportasi umum yang Anda butuhkan

Minta kolom rute transportasi umum yang Anda butuhkan menggunakan mask kolom. Tabel berikut berisi beberapa respons yang disarankan untuk rute transportasi umum, dan mask kolom yang akan digunakan untuk memintanya.

Untuk meminta informasi ini Gunakan mask kolom ini
Semua detail rute. *
Detail transportasi umum untuk segmen rute. legs
Estimasi tarif untuk setiap langkah rute, dan estimasi tarif yang dilokalkan. travelAdvisory
Teks yang dilokalkan untuk durasi dan jarak localizedValues

Menetapkan parameter untuk rute transportasi umum

Berikut adalah parameter yang relevan untuk rute transportasi umum:

Untuk melakukannya Gunakan parameter ini Catatan
Pilih mode transportasi umum travelMode: "TRANSIT" Wajib. Pelajari lebih lanjut.
Menetapkan waktu tiba atau berangkat arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)

ATAU

departureTime: new Date(yyyy-mm-ddThh:mm:ssZ)		 Opsional. Anda dapat menentukan waktu kedatangan atau waktu keberangkatan. Jika waktu tidak ditentukan, departureTime akan ditetapkan secara default ke waktu eksekusi saat ini (now). Anda dapat menetapkan waktu kedatangan dan keberangkatan hanya dalam jangka waktu berikut, dengan waktu eksekusi saat ini (now) sebagai referensi:
  • hingga dan termasuk 7 hari sebelum now
  • hingga dan termasuk 100 hari setelah now
Waktu dinyatakan sebagai objek Date.

Catatan: Jadwal transportasi umum sering berubah, perjalanan transportasi umum yang tersedia dapat berubah dari waktu ke waktu dan tidak ada jaminan untuk memberikan hasil yang konsisten untuk prediksi jauh di muka.
Menyertakan rute alternatif computeAlternativeRoutes: true Opsional. Setel ke benar (true) agar computeRoutes menghitung hingga 3 rute tambahan, jika tersedia. Pelajari lebih lanjut
Tentukan preferensi untuk jenis transportasi umum transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}

Catatan: Jika Anda menentukan moda transportasi pilihan, rute yang ditampilkan mungkin masih menggunakan moda transportasi lain, bahkan hanya menggunakan moda transportasi lain, bergantung pada efisiensi rute dan ketersediaan perjalanan pilihan.

 Opsional. Tentukan moda transportasi umum pilihan. Pelajari lebih lanjut
Menentukan preferensi untuk rute transportasi umum transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} Opsional. Tentukan preferensi pemilihan rute transportasi umum. Pelajari lebih lanjut

Contoh permintaan

Contoh berikut menunjukkan cara meminta rute transportasi umum:

const request = {
  origin: 'Hunters Point San Francisco, CA 94124',
  destination: '201 Marine Dr, San Francisco, CA 94129',
  travelMode: 'TRANSIT',
  departureTime: new Date(),
  transitPreference: {
    allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'],
    routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'.
  },
  fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'],
};