Routes API, iki yöntemi olan bir web hizmetidir: Compute Routes, isteğe bağlı ara noktalarla iki konum arasındaki rotayı döndürür. Compute Route Matrix ise başlangıç ve hedef kombinasyonları için seyahat mesafesini ve süresini döndürür (625 rota öğesine kadar).
Routes API: Temel bilgiler
- Ürün: Routes API
- Diğer adları: Routes API v2, Compute Routes, Compute Route Matrix
- Kategori: Rotalar
- Platform: Web hizmeti (REST)
- Çalıştığı yer: Sunucu (arka uç kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: Routes API'ye genel bakış
- Kullanılabildiği bölgeler: Dünya geneli. İki tekerlekli araç rotası, çevre dostu rotalar ve ücret hesaplama özellikleri, desteklenen ülkeler ve şehirlerle sınırlıdır. Kendi CLDR kodu olan bağımlı bölgeler, listede yer almadığı sürece desteklenmez. Avrupa Ekonomik Alanı (AEA) fatura adresleri için https://developers.google.com/maps/comms/eea/routes adresindeki AEA şartları, rota açıklamalarının veya adımlarının herhangi bir haritayla kullanılmasını yasaklar. (kapsam ayrıntıları)
Routes API: Ne zaman kullanılır?
Routes API'yi şu durumlarda kullanın:
- Araba, yaya, bisiklet, iki tekerlekli araç veya toplu taşıma için başlangıç ve varış noktası arasında isteğe bağlı ara noktalar içeren bir rotaya ihtiyacınız vardır.
- Tek bir istekte birçok başlangıç-hedef çifti için seyahat mesafelerine ve sürelerine ihtiyacınız vardır (625 öğeye kadar).
- Tahmini geçiş ücreti (belirli şehirler), çevre dostu rotalar (belirli bölgeler), trafiğe duyarlı çoklu çizgiler veya büyük araç rotası (sınırlı kullanılabilirlik) gerekiyorsa.
- Bir sunucu uygulamasını eski Directions API veya Distance Matrix API'den taşıyorsanız.
Routes API'yi şu durumlarda kullanmayın:
- Yük atamalarını optimize etmeniz ve tüm araç filosu için sipariş vermeyi durdurmanız gerekiyor. Bunun yerine Route Optimization API'yi kullanın.
- Android'de, hesaplanan bir rotayı izleyen uygulama içi adım adım rota özelliğine ihtiyacınız var. Bunun yerine Android için Navigasyon SDK'sını kullanın.
- iOS'te, hesaplanan bir rotayı izleyen uygulama içi adım adım rota özelliğine ihtiyacınız varsa Bunun yerine iOS için Navigasyon SDK'sını kullanın.
Routes API: kurulum
- Etkinleştirilecek hizmet:
routes.googleapis.com - Kimlik doğrulama: API anahtarı, OAuth 2.0, hizmet hesabı
- Başlayın: Routes API'yi ayarlama
- Referans: Routes API referansı
- Fiyatlandırma: Routes API kullanımı ve faturalandırması
- Politikalar: Routes API politikaları
- Sürüm notları: Routes API sürüm notları
Resmi Routes API paketleri:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
Routes API: İlgili ürünler
- Şunların yerine geçer: Directions API, Distance Matrix API
- Genellikle birlikte kullanıldığı ürünler: Android için Navigation SDK, iOS için Navigation SDK, Route Optimization API, Geocoding API, Places API (New)
Routes API: Sık yapılan yanlışlar
- Sorun: Döndürülen alanların varsayılan bir listesi yoktur. Alan maskesi (
X-Goog-FieldMasküstbilgisi veya$fieldsparametresi) olmayan istekler hata döndürür. Düzeltme: Her zaman ihtiyacınız olan yanıt alanlarını listeleyen bir alan maskesi gönderin. /maps/documentation/routes/choose_fields adresini inceleyin. - Sorun: Üretimde joker karakter alan maskesi (
*) kullanmak maliyeti ve gecikmeyi artırır. Yanıta yeni ileri seviye özellikler eklendikçe maliyet beklenmedik şekilde artabilir. Düzeltme:*öğesini yalnızca geliştirme sırasında kullanın. Üretim aşamasında yalnızca ihtiyacınız olan alanları isteyin. /maps/documentation/routes/choose_fields adresini inceleyin. - Sorun: Ücret bilgileri ve yakıt tüketimi, yalnızca alan maskesine eklenerek döndürülmez. GA'dan beri bu bilgilerin açıkça etkinleştirilmesi gerekir. Düzeltme: Alan maskesine ek olarak isteğe
extraComputationsdizisini (ör.TOLLS,FUEL_CONSUMPTION) ekleyin. /maps/documentation/routes/migrate-routes-preview adresini ziyaret edin. - Sorun: Compute Route Matrix 625 öğeye izin verir ancak
routingPreference,TRAFFIC_AWARE_OPTIMALolduğunda yalnızca 100 öğeye izin verir. Düzeltme:TRAFFIC_AWARE_OPTIMALkullanırken başlangıç noktası x hedef sayısını 100 veya daha az tutun ya da isteği bölün. /maps/documentation/routes/compute_route_matrix sayfasına bakın.
Routes API ile yapabilecekleriniz
Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.
- İki veya daha fazla enlem/boylam koordinatı arasındaki yol tariflerini, rota boyunca her adım için bir dizi koordinat olarak döndürür.
- İki veya daha fazla enlem/boylam koordinat kümesi arasındaki yol tariflerini, bir rota boyunca adımlar için bir dizi manevra açıklaması olarak döndürür.
- İki veya daha fazla enlem/boylam koordinat kümesi arasındaki bir rota boyunca her adım arasındaki mesafeyi döndürür.
- İki veya daha fazla enlem/boylam koordinat kümesi arasındaki bir rota boyunca her adım arasındaki seyahat süresini döndürür.
- İki veya daha fazla enlem/boylam koordinat kümesi arasındaki bir rota boyunca her adım arasında kodlanmış bir çoklu çizgi döndürür.
- İki veya daha fazla enlem/boylam koordinatı kümesi arasındaki rotanın mesafesini döndürür.
- İki veya daha fazla enlem/boylam koordinatı grubu arasındaki bir rotanın seyahat süresini döndürme
- İki veya daha fazla enlem/boylam koordinat kümesi arasındaki rota için kodlanmış bir çoklu çizgi döndürür.
- İki veya daha fazla enlem/boylam koordinat kümesi arasındaki bir rota için ücret bilgilerini döndürür.
- Rota isteği için seyahat modunu (araba, toplu taşıma, yaya, iki tekerlekli) belirtin. Not: Routes API web hizmetinde (computeRoutes), RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT veya routeModifiers.vehicleInfo ile TRUCK) kullanarak HTTP POST JSON gövdesinde travelMode'u iletin ve eski bir GET modu sorgu parametresi yerine gerekli X-Goog-FieldMask başlığını ekleyin. Maps JavaScript API Rotalar kitaplığında, ComputeRoutesRequest'te travelMode ve alanları iletin.
- Rota isteği için durak veya geçiş noktası belirtme
- Rota isteğinde trafik verilerinin nasıl kullanılacağını belirtin.
- Rota isteği için otoyollar veya ücretli geçişler gibi kaçınılacak özellikleri belirtme
- Rota boyunca ara noktalar belirleyin.
- Rota boyunca ara noktalar belirleyin.
- Rotanın geçeceği bir nokta belirleyin.
- Bir rota için aracın yönünü ve yolun tarafını belirtin.
- Rotanızdaki durakların sırasını optimize edin.
- Rota isteği için çevre dostu rota bulma özelliğini belirtin. Önizleme
- Rota isteği için daha kısa mesafe veya alternatif rota belirtin. Not: Routes API'de daha kısa mesafeli referans rota (SHORTER_DISTANCE) istemek deneysel bir özelliktir. Alternatif rotalar (computeAlternativeRoutes) istemek ise genel kullanıma sunulmuştur.
- Birden fazla başlangıç ve varış noktası arasındaki rotalardan oluşan bir matris için mesafeleri döndürür.
- Birden fazla başlangıç ve varış noktası arasındaki rotalardan oluşan bir matris için seyahat sürelerini döndürme
- Birden fazla başlangıç ve varış noktası arasındaki rotalardan oluşan bir matris için ücretli geçiş bilgilerini döndürme
- Rota matrisi isteği için seyahat modunu (sürüş, toplu taşıma, yürüme, iki tekerlekli) belirtin. Not: Routes API web hizmetinde (computeRouteMatrix), RouteTravelMode'u (DRIVE, TWO_WHEELER, WALK, TRANSIT veya origins[].routeModifiers.vehicleInfo ile TRUCK; rota matrisleri için BICYCLE desteklenmez) kullanarak travelMode'u HTTP POST JSON gövdesine iletin ve gerekli X-Goog-FieldMask üstbilgisini ekleyin. Maps JavaScript API Routes kitaplığında, ComputeRouteMatrixRequest'te travelMode ve alanları iletin.