Giriş
Compute Routes, Routes API hizmetinde HTTPS isteğini kabul eden ve iki konum arasındaki ideal rotayı döndüren bir yöntemdir. Birden çok konum arasında toplu taşımayla, bisikletle, arabayla, 2 tekerlekli motorlu araçlarla veya yaya olarak gitmek için gerçek zamanlı trafik bilgilerini içeren yol tarifleri sağlayın.
Rota matrislerine mi ihtiyacınız var? Rota matrisiyle ilgileniyorsanız Rota Matrisi Hesaplamasına Genel Bakış bölümüne bakın.
Taşıma işlemi mi yapıyorsunuz? Distance Matrix API'den (Eski) geçiş yapıyorsanız Neden Rotalar API'ye geçmelisiniz? başlıklı geçiş talimatlarına bakın.
Compute Routes'u neden kullanmalısınız?
Compute Routes ile çok çeşitli rota ayrıntılarını kullanarak araçlarınızı veya paketlerinizi tercihlerinize göre yönlendirebilir, aynı zamanda maliyet ve kaliteyi optimize edebilirsiniz.
Compute Routes ile yapabilecekleriniz
Routes API Compute Routes
yöntemiyle şunları yapabilirsiniz:
Farklı seyahat yöntemleri ve tek veya birden fazla hedef için yol tarifi alma:
Ulaşım yöntemleri: toplu taşıma, araba, iki tekerlekli araçlar, yaya veya bisiklet.
En verimli şekilde ziyaret etmek için optimize edebileceğiniz bir dizi yol noktası.
Başlangıç noktalarını, varış noktalarını ve ara noktaları belirtmek için birden fazla yöntem kullanın:
Metin dizeleri. Örneğin: "Chicago, IL", "Darwin, NT, Avustralya", "1800 Amphitheatre Parkway, Mountain View, CA 94043" veya "CWF6+FWX Mountain View, California"
Yer kimlikleri
Enlem ve boylam koordinatları (isteğe bağlı olarak araç yönüyle birlikte)
İhtiyaçlarınıza ve hedeflerinize göre rota seçeneklerinizi hassas bir şekilde ayarlayın:
Aracınızın motor türüne (dizel, elektrikli, hibrit, benzinli) göre yakıt veya enerji verimliliği yüksek rotalar seçin. Daha fazla bilgi için Çevre dostu rota alma başlıklı makaleye bakın.
Trafik hesaplaması için ayrıntılı seçenekler belirleyerek kalite ve gecikme arasında denge kurmanıza olanak tanır. Ayrıntılar için Trafik verilerinin nasıl ve dahil edilip edilmeyeceğini belirtme başlıklı makaleyi inceleyin.
TVS doğruluğunu artırmak için ara noktaların araç yönünü (seyahat yönü) ve yolun hangi tarafında olduğunu ayarlayın. Ayrıntılar için Aracın yönünü ve yolun hangi tarafında olduğunu belirtme başlıklı makaleyi inceleyin.
Aktarma noktası ve terminal konumlarını, güvenli aktarma konumlarını belirtin. Ayrıntılar için Rota üzerinde durak ayarlama ve Rotanın geçeceği nokta ayarlama başlıklı makaleleri inceleyin.
Rota mesafesi ve tahmini varış zamanıyla birlikte geçiş ücreti bilgilerini isteyin. Ayrıntılı bilgi için Bir rota için geçiş ücretlerini hesaplama başlıklı makaleyi inceleyin.
Yalnızca ihtiyacınız olan verileri bir alan maskesi kullanarak isteyerek gecikme sürenizi ve kalitenizi kontrol edin. Bu sayede gereksiz işlem süresinden ve daha yüksek istek faturalandırma oranlarından kaçınabilirsiniz. Ayrıntılar için Hangi bilgilerin döndürüleceğini seçme başlıklı makaleyi inceleyin.
Compute Routes'un işleyiş şekli
Routes API'nin ComputeRoutes
yöntemi, istek ayrıntılarını içeren bir JSON istek gövdesiyle HTTP POST isteğini kabul eder. Döndürülecek alanları belirtmek için kaynak, hedef, travelMode
ve alan maskesi gereklidir.
Örnek
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Hizmet daha sonra istenen rotayı hesaplar ve istediğiniz alanları döndürür.
Kaynaklar
Aşağıdaki tabloda, Routes API Compute Routes yöntemi aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmektedir.
Veri kaynakları | Döndürülen veriler | Dönüş biçimi |
---|---|---|
ComputeRoutes | İstenirse alternatif rotalarla birlikte bir rotanın yollarını, ayaklarını ve adımlarını döndürür. | JSON |
Compute Routes nasıl kullanılır?
1 | Kurulum | Google Cloud projenizi oluşturma ile başlayın ve kurulum talimatlarını tamamlayın. |
2 | Routes API'nin nasıl faturalandırdığını anlama | Daha fazla bilgi için Kullanım ve faturalandırma başlıklı makaleyi inceleyin. |
3 | Bir rota hesaplama ve yanıtı inceleme | Daha fazla bilgi için Rota alma ve Rota yanıtlarını inceleme başlıklı makalelere bakın. |
Kullanılabilir istemci kitaplıkları
Compute Routes için kullanılabilen istemci kitaplıklarının listesini görmek istiyorsanız İstemci kitaplıkları bölümüne bakın.
Sırada ne var?
- Rota alma
- Kullanılabilir rota seçenekleri
- Hangi bilgilerin döndürüleceğini seçme
- Directions API (Eski) sürümünden geçiş
- Routes API önizlemesinden GA'ya geçiş