Routes API'yi neden kullanmalısınız?
Routes API ile toplu taşıma ayrıntılarını, güncel trafik ve yol koşullarını ve rota tercihlerini kullanarak doğru rota ve seyahat bilgileri alabilirsiniz:
Farklı ulaşım modlarının türleri ve olanakları
Bir aracın gittiği yön
Alma veya bırakma için yol kenarı
Trafik koşulları ve kapalı yollar
Tehlikeli alanlardan kaçınmak veya güvenli alma alanları sağlamak gibi güvenlikle ilgili kaygılar
Ücretli geçişler ve süre ve mesafe gibi seyahat meta verileri ve yakıt verimliliği gibi isteğe bağlı özellikler gibi isteğe bağlı özelliklerle rota ihtiyaçlarınız genelinde gecikme, kalite ve maliyeti dengeleyin
Ayrıca, dağıtım planlaması için en verimli rotaları belirleyebilirsiniz. Örneğin:
Bir dizi paketi teslim alacak bir çalışan grubu en iyi nasıl atanır?
Paketlerin nihai varış noktasına gönderileceği en iyi depoyu belirlemek
Routes API ile neler yapabilirsiniz?
Routes API ile iki birincil yönlendirme bilgisi kategorisi alabilirsiniz:
Bir konumdan bir veya daha fazla hedefe giden rotalar
Birçok başlangıç ve bitiş konumu arasındaki olası rotaların bir matrisi.
Bir veya daha fazla hedef için rota alma
Routes API Compute Routes
yöntemini kullanarak şu konumlar arasında hesaplama yapabilirsiniz:
Farklı seyahat yolları ve tek veya birden fazla varış noktası için yol tarifi alın:
Toplu taşıma, araba, iki tekerlekli araçlar, yaya veya bisiklet dahil olmak üzere ulaşım şekilleri.
Yolculuk yaparken en verimli sıralamayı elde etmek için optimize edebileceğiniz bir dizi referans noktası.
Kalkış noktalarını, hedefleri ve ara noktaları belirtmek için kullanabileceğiniz birden fazla yöntem:
Metin dizeleri. Örneğin: "Chicago, IL", "Darwin, NT, Avustralya", "1800 Amphitheatre Parkway, Mountain View, CA 94043" veya "CWF6+FWX Mountain View, Kaliforniya"
Yer kimlikleri
İsteğe bağlı olarak araç yönüyle birlikte enlem ve boylam koordinatları
İhtiyaçlarınıza ve hedeflerinize göre rota seçeneklerinizde ince ayarlar yapın:
Aracınızın motor türü için yakıt veya enerji verimliliği yüksek rotalar seçin: Dizel, Elektrikli, Hibrit, Benzin. Daha fazla bilgi için Çevre dostu rota alma başlıklı makaleyi inceleyin.
Trafik hesaplaması için ayrıntılı seçenekler ayarlayın. Bu sayede, gecikmeden ödün verme kararlarına kıyasla kaliteyi elde edin. Ayrıntılar için Trafik verilerinin nasıl ve nasıl dahil edileceğini belirtme bölümüne bakın.
TVS doğruluğunu artırmak için ara noktaların araç yönünü (seyahat yönü) ve yol tarafı bilgilerini ayarlayın. Ayrıntılar için Araç başlığını ve yol kenarını belirtme bölümüne bakın.
Geçiş ve terminal konumlarını ve güvenli duraklama konumlarını belirtin. Ayrıntılı bilgi edinmek için Rota boyunca duraklama ve Rota için nokta belirleme başlıklı makaleleri inceleyin.
Rota mesafesi ve TVS'nin yanı sıra ücretli geçiş bilgilerini isteyin. Ayrıntılar için Rota için ücretli geçiş ücretlerini hesaplama bölümünü inceleyin.
Alan maskesi kullanarak yalnızca ihtiyacınız olan verileri isteyerek gecikmenizi ve kalitenizi kontrol edebilirsiniz. Böylece, gereksiz işleme süresinden ve yüksek istek faturalandırma ücretlerinden kaçınmış olursunuz. Ayrıntılar için Döndürülecek bilgileri seçme bölümüne bakın.
Olası rotaların matrisini alma
Routes API Compute Route Matrix
yöntemi, iş ihtiyaçlarınıza göre en iyi başlangıç ve varış noktalarını seçmenize yardımcı olmak amacıyla, birden fazla başlangıç ve bitiş noktası arasındaki önerilen rotalar için mesafe ve tahmini varış süreleri dahil olmak üzere bir bilgi matrisi sağlar. Aşağıdaki tür mesafe verilerini isteyebilirsiniz:
Seçili ulaşım şekli için mesafe
Kilometre veya mil cinsinden mesafe
Trafikteki tahmini seyahat süresi
Mesafe verilerini kullanarak yolcuları, sevkiyatları veya çalışanları olası birden fazla başlangıç noktası ve hedef arasında yönlendirmenin en verimli yolunu belirleyebilirsiniz.
Matrisin tamamı hesaplanmadan önce yanıtın öğelerini akışla alabilir, böylece yanıt gecikmesini azaltabilirsiniz.
Sunucu tarafı isteği başına birden fazla kaynak ve hedef belirtebilirsiniz. Kaynak sayısı çarpı hedef sayısı ile en fazla 625 olabilir.
Routes API'nin işleyiş şekli
Routes API'nin iki yöntemi vardır: ComputeRoutes
ve ComputeRouteMatrix
.
ComputeRoutes
Routes API ComputeRoutes
yöntemi, istek ayrıntılarını içeren bir JSON istek gövdesine sahip HTTP POST isteğini kabul eder. Hangi alanların döndürüleceğini belirtmek için başlangıç noktası, 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 istekte bulunduğunuz alanları döndürür.
ComputeRouteMatrix
Routes API ComputeRouteMatrix
, istek ayrıntılarını içeren bir JSON istek gövdesine sahip HTTP POST isteğini kabul eder. Hangi alanların döndürüleceğini belirtmek için en az bir kaynak, iki veya daha fazla hedef, TravelMode ve bir alan maskesi gerekir.
Örnek
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Yanıt, tüm başlangıç ve hedef ara noktalarının kombinasyonu için olası rotaları içerir.
Kaynaklar
Aşağıdaki tabloda, Rotalar API'si aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmiştir.
Veri kaynakları | Döndürülen veriler | Dönüş biçimi |
---|---|---|
ComputeRoutes | İstenirse alternatif rotalarla birlikte rotanın rotalarını, bacaklarını ve adımlarını döndürür. | JSON |
ComputeRouteMatrix | Bir başlangıç ara noktasından bir hedef ara noktaya kadar bir rota dizisi döndürür. |
Routes API'yi kullanma
1 | Hazırlanın | Google Cloud projenizi oluşturma ile başlayın ve aşağıdaki kurulum talimatlarını tamamlayın. |
2 | Bir rota hesaplama ve yanıtı inceleme | Daha fazla bilgi için Rota alma ve Rota yanıtlarını inceleme başlıklı makalelere göz atın. |
3 | Rotaların matrisini hesaplama ve yanıtı inceleme | Daha fazla bilgi için Rota matrisi alma ve Rota matrisi yanıtını inceleme sayfalarına göz atın. |
Kullanılabilir istemci kitaplıkları
Routes API'de kullanılabilen istemci kitaplıklarının listesini İstemci kitaplıkları bölümünde bulabilirsiniz.