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 rotalar ve yolculuk bilgileri alabilirsiniz:
Farklı ulaşım modlarının türleri ve özellikleri
Aracın gittiği yön
Teslim alma veya bırakma için yol kenarı
Trafik koşulları ve kapalı yollar
Tehlikeli alanlardan kaçınma veya güvenli teslim alma alanları sunma gibi güvenlik endişeleri
Ücretli geçişler ve yolculuk meta verileri (süre, mesafe ve yakıt verimliliği gibi) gibi isteğe bağlı özelliklerle rota ihtiyaçlarınız genelinde gecikme, kalite ve maliyeti dengeleyin
Ayrıca, sevkıyat planlaması için en verimli rotaları belirleyebilirsiniz. Örneğin:
Bir dizi paketi teslim alacak bir çalışan grubu atamanın en iyi yolu
Paketlerin nihai hedefine gönderileceği en iyi depoyu belirlemek
Routes API ile neler yapabilirsiniz?
Routes API ile iki temel yönlendirme bilgisi kategorisi alabilirsiniz:
Bir konumdan bir veya daha çok hedefe giden rotalar
Birçok başlangıç ve bitiş konumu arasındaki olası rotalar matrisi.
Bir veya daha fazla hedef için rota bulma
Routes API Compute Routes
yöntemiyle konumlar arasında hesaplama yapabilirsiniz:
Farklı seyahat yolları için yol tarifi ve bir veya daha fazla varış noktası için:
Toplu taşıma, araba, iki tekerlekli araçlar, yürüyüş veya bisiklet gibi ulaşım şekilleri.
En verimli şekilde seyahat etme sırası için optimize edebileceğiniz bir dizi ara nokta.
Kalkış noktalarını, hedefleri ve ara noktaları belirtmek için kullanılan birden çok yöntem:
Metin dizeleri. Örneğin: "Şikago, IL", "Darwin, NT, Avustralya", "1800 Amphitheatre Parkway, Mountain View, CA 94043" veya "CWF6+FWX Mountain View, California"
Yer kimlikleri
İsteğe bağlı olarak araç yönü ile 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 bulma bölümüne bakın.
Trafik hesaplaması için ayrıntılı seçenekler belirleyerek gecikmeden ödün vermeden kaliteyi sağlamaya çalışın. Ayrıntılar için Trafik verilerinin nasıl ekleneceğini ve eklenip eklenmeyeceğini belirtme bölümünü inceleyin.
TVS doğruluğunu artırmak amacıyla ara noktalar için araç yönü (seyahat yönü) ve yol kenarı bilgilerini ayarlayın. Ayrıntılar için Araç yönünü ve yolunu belirleme bölümüne bakın.
Geçiş ve terminal konumlarını ve güvenli duraklama konumlarını belirtin. Ayrıntılı bilgi için Rota boyunca durak belirleme ve Rotanın geçeceği bir nokta ayarlama konularına bakın.
Rota mesafesi ve TVS ile birlikte ücretli geçiş bilgisi isteyin. Ayrıntılı bilgi için Rota için ücret ücretlerini hesaplama bölümünü inceleyin.
Alan maskesi kullanarak yalnızca ihtiyaç duyduğunuz verileri isteyerek gecikmenizi ve kalitenizi kontrol edin. Böylece gereksiz işleme süresinden ve daha yüksek istek faturalandırma ücretlerinden kaçınabilirsiniz. Ayrıntılar için İade edilecek bilgileri seçme bölümüne göz atın.
Olası rotaların matrisini alma
Routes API Compute Route Matrix
yöntemi, iş ihtiyaçlarınıza göre en iyi kalkış ve varış noktalarını seçmenize yardımcı olmak için birden fazla başlangıç ve bitiş noktası arasındaki önerilen rotalar için mesafe ve tahmini varış süreleri dahil bir bilgi matrisi sağlar. Aşağıdaki tür mesafe verileri isteyebilirsiniz:
Seçilen ulaşım şekli için mesafe
Kilometre veya mil cinsinden mesafe
Trafikte tahmini seyahat süresi
Mesafe verileriyle, yolcuları, gönderileri veya çalışanları birden fazla olası kalkış ve varış noktası arasında yönlendirmenin en verimli yolunu belirleyebilirsiniz.
Matrisin tamamı hesaplanmadan önce yanıtın öğelerini akış olarak yayınlayabilirsiniz. Böylece yanıt gecikmesini azaltabilirsiniz.
Sunucu tarafı istek başına birden fazla kaynak ve hedef belirtebilirsiniz. Bunun için kaynak sayısı çarpı hedef sayısı 625'e kadar çıkabilir.
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. Döndürülecek alanları belirtmek için kalkış, 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'
Daha sonra hizmet istenen rotayı hesaplar ve istediğiniz alanları döndürür.
ComputeRouteMatrix
Routes API ComputeRouteMatrix
, istek ayrıntılarını içeren JSON istek içeriğine sahip bir HTTP POST isteğini kabul eder. Döndürülecek alanları belirtmek için en az bir kaynak, iki veya daha fazla hedef, TravelMode ve 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 kalkış ve varış ara noktalarının kombinasyonu için olası rotaları içerir.
Kaynaklar
Aşağıdaki tabloda, döndürdüğü verilerle birlikte Routes API aracılığıyla kullanılabilen kaynaklar özetlenmektedir.
Veri kaynakları | Döndürülen veriler | İade biçimi |
---|---|---|
ComputeRoutes | İstenirse alternatif rotalarla birlikte bir rotanın rotaları, ayaklarını ve adımlarını döndürür. | JSON |
ComputeRouteMatrix | Bir kalkış ara noktasından bir hedef ara noktasına giden rota dizisini döndürür. |
Routes API'yi kullanma
1 | Kurulumu yapın | Google Cloud projenizi oluşturun bölümünü inceleyin ve sonraki kurulum talimatlarını tamamlayın. |
2 | Rota hesaplayın ve yanıtı inceleyin | Daha fazla bilgi için Rota alma ve Rota yanıtlarını inceleme konularına bakın. |
3 | Rotaların matrisini hesaplayın ve yanıtı gözden geçirin | Daha fazla bilgi için Rota matrisi alma ve Rota matrisi yanıtını inceleme konularına bakın. |
Kullanılabilir istemci kitaplıkları
Routes API'de kullanılabilen istemci kitaplıklarının listesi için İstemci kitaplıkları sayfasını inceleyin.