Routes API hızlı referansı

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

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: 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 $fields parametresi) 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 extraComputations dizisini (ö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_OPTIMAL olduğunda yalnızca 100 öğeye izin verir. Düzeltme: TRAFFIC_AWARE_OPTIMAL kullanı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.