Toplu taşıma rotası, bölgedeki toplu taşıma seçeneklerini kullanarak navigasyon talimatları sağlar. Toplu taşıma seçenekleri arasında otobüs, metro ve tren gibi araçlar yer alabilir. Toplu taşıma rotası genellikle toplu taşıma istasyonlarına, istasyonlardan ve istasyonlar arasında yürüme talimatlarını da içerir. Toplu taşıma rotası genellikle birden fazla ulaşım şekli kullanmanızı gerektirdiğinden rotayı nasıl istediğiniz ve yanıtın bazı bölümleri farklıdır.
Toplu taşıma rotalarının diğer rotalardan farkı
travelMode TRANSIT olarak ayarlayarak istediğiniz toplu taşıma rotaları, farklı ulaşım şekli seçeneklerinin kullanıldığı rotalardan farklıdır.
Aynı nesnelerin ve seçeneklerin tümünü isteyemezsiniz. Ayrıca yanıt, diğer rotalara kıyasla farklı alanlar döndürür.
Routes API'de adımlar, tüm seyahat türlerinde tutarlı bir şekilde tek bir navigasyon talimatı olarak tanımlanır. Bu nedenle, her gezinme talimatı bir adımdır. Toplu taşıma rotası yanıtı, diğer ulaşım şekillerindeki rotalara çok benzer. Ancak birkaç önemli fark vardır:
| Farklılık isteğinde bulunma | Yanıt farklılıkları |
|---|---|
| Ara yol noktaları belirtemezsiniz. | Toplu taşıma ayrıntılarını içerir. |
| Çevre dostu rotalar alınamıyor | Her seyahat modu için meta veriler içerir. Bu meta veriler, söz konusu seyahat moduna ilişkin adımların özetini stepsOverview içinde barındırır (Bu meta verileri istemek için stepsOverview alan maskesini kullanın). |
| Trafik verilerinin nasıl ve dahil edilip edilmeyeceği belirtilemez. | |
| Kaçınılacak rota özellikleri belirtilemiyor | |
Yalnızca transitPreferences belirtilebilir. Ayrıntılı bilgi için TransitPreference başlıklı makaleyi inceleyin. |
Toplu taşıma rotası almak için
- Başlangıç ve varış noktanızı ayarlayın.
travelModedeğeriniTRANSITolarak ayarlayın.- İhtiyacınız olan yanıtı almak için uygun alan maskelerini ekleyin. İhtiyacınız olan toplu taşıma rotası alanlarını isteyin.
- Gerekirse isteğe bağlı parametreleri ayarlayın. Toplu taşıma rotası için parametreleri ayarlama başlıklı makaleyi inceleyin.
İhtiyacınız olan toplu taşıma rotası alanlarını isteyin
Alan maskelerini kullanarak ihtiyacınız olan toplu taşıma rotası alanlarını isteyin. Aşağıdaki tabloda, toplu taşıma rotası için önerilen bazı yanıtlar ve bunları istemek için kullanılacak alan maskesi yer almaktadır.
| Bu bilgileri istemek için | Bu alan maskesini kullanın |
|---|---|
| Tüm rota ayrıntıları. | * |
| Rota ayaklarıyla ilgili toplu taşıma bilgileri. | legs |
| Rotanın her adımı için tahmini ücret ve yerelleştirilmiş tahmini ücret. | travelAdvisory |
| Süre ve mesafe için yerelleştirilmiş metin | localizedValues |
Toplu taşıma rotası için parametreleri ayarlama
Toplu taşıma güzergahlarıyla ilgili parametreler şunlardır:
| Bunu yapmak için: | Bu parametreyi kullanın | Notlar |
|---|---|---|
| Toplu taşıma modunu seçme | travelMode: "TRANSIT" |
Zorunlu. Daha fazla bilgi |
| Varış veya kalkış saati ayarlama | arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)
VEYA departureTime: new Date(yyyy-mm-ddThh:mm:ssZ) |
İsteğe bağlıdır. Varış veya kalkış saatini belirtebilirsiniz. İki saat de belirtilmezse departureTime varsayılan olarak mevcut yürütme zamanı (now) olur. Varış ve kalkış saatlerini yalnızca aşağıdaki zaman aralığında ayarlayabilirsiniz. Referans olarak mevcut yürütme zamanı (now) kullanılır:
Date nesnesi olarak ifade edilir.
Not: Toplu taşıma tarifeleri sık sık değişir, mevcut toplu taşıma yolculukları zaman içinde değişebilir ve çok önceden yapılan tahminler için tutarlı sonuçlar sağlanacağı garanti edilmez. |
| Alternatif rotaları dahil etme | computeAlternativeRoutes: true |
İsteğe bağlıdır. Kullanılabilir olduğunda computeRoutes'nın 3'e kadar ek rota hesaplaması için true (doğru) olarak ayarlayın.
Daha fazla bilgi |
| Toplu taşıma türü için tercihleri belirtin | transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}
Not: Tercih edilen bir ulaşım şekli belirtirseniz döndürülen rotalar, tercih edilen ulaşım şeklinin rotadaki verimliliğine ve kullanılabilirliğine bağlı olarak diğer toplu taşıma şekillerini kullanabilir, hatta yalnızca diğer toplu taşıma şekillerini kullanabilir. |
İsteğe bağlıdır. Tercih edilen toplu taşıma şekillerini belirtin. Daha fazla bilgi |
| Toplu taşıma rotası için tercihleri belirtme | transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} |
İsteğe bağlıdır. Toplu taşıma rotası tercihlerini belirtin. Daha fazla bilgi |
Örnek istek
Aşağıdaki örnekte toplu taşıma rotası isteğinde bulunma işlemi gösterilmektedir:
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'], };