Neden Routes API'ye geçiş yapmalısınız?

Routes API; yol tariflerinin, mesafenin ve seyahat süresinin hesaplanması için iyileştirilmiş performans sunduğundan, şu anda Directions API ve DISTANCE Matris API'yi kullanan uygulamaların yerini almaya değer. Routes API işlevlerinin çoğu, hem Directions API hem de Mesafe Matrisi API'si ile geriye dönük uyumludur.

Routes API'nin yerini aldığı ürünlere kıyasla önemli farklılıkları ve gerekli değişikliklerin nasıl ele alınacağını anlamak için bu kılavuzu kullanın. Routes API'nin diğer özellikleri hakkında daha fazla bilgi için ürüne genel bakış bölümüne bakın.

Önemli iyileştirmeler

Bu bölümde, uygulamalarınızda Routes API'yi kullanırken bekleyebileceğiniz bazı iyileştirmeler ele alınmaktadır.

Artırılmış istek sınırları

Routes API
  • TRAFFIC_AWARE_OPTIMAL belirtmediğiniz sürece en fazla 625 öğe.
  • TRAFFIC_AWARE_OPTIMAL ile maksimum 100 öğe. Gelişmiş yönlendirme tercihleri bölümüne göz atın.
  • Yer Kimliği kullanılarak en fazla 50 ara nokta (kaynaklar ve hedefler) kullanılabilir.
Distance Matrix API
  • İstek başına en fazla 25 kaynak veya 25 hedef.
  • Sunucu tarafı istek başına maksimum 100 öğe (kaynak sayısı × hedef sayısı).

Daha hızlı istek yanıtları

İşlem rotası matrisi özelliği, aşağıdaki gecikme iyileştirmelerini sunar:

  • Tüm matris hesaplanmadan önce yanıtın akış öğelerini alın.
  • Yanıt ayrıntılarını özelleştirmek için alan maskeleri kullanın, yalnızca ihtiyacınız olan verileri isteyin. Bu da maliyetinizi azaltmanıza yardımcı olan bir en iyi uygulamadır.
  • Trafik için geliştirilmiş rota hesaplamaları sayesinde, veri kalitesi ile yanıt süresi arasında denge kurabilirsiniz.

Yönlendirme geliştirmeleri

İşlem rotası özelliği, şu rota geliştirmelerini sunar:

  • Mesafe ve TVS bilgilerine ek olarak ücretli geçiş bilgileri.
  • 2 tekerlekli araç rotaları.
  • Güvenliğiniz için ara noktalarınızın niteliğini belirleyin.
  • Ara noktalar için seyahat yönünü ve yolun yönünü ayarlayarak daha fazla TVS doğruluğu.

Yalnızca ihtiyacınız olan verileri isteyin

Artık hangi alanların döndürüleceğini belirleyebilir, işlem süresini ve faturalandırma ücretlerini azaltabilirsiniz.

Routes API İstekleriniz, yanıtta döndürülmesini istediğiniz alanları belirtmek için bir alan maskesi kullanmalıdır. Alan maskeleme, gereksiz veri isteğinde bulunmamanızı sağlayarak gereksiz işlem süresini ve faturalandırma ücretlerini önler.
Daha fazla bilgi için Döndürülecek alanları seçme bölümüne bakın.
Directions API
Mesafe Matrisi API'si 		Uygulamanız özellikle ihtiyaç duymasa bile varsayılan alan listesini döndürür. Bu durum, gereksiz işlem süresine ve faturalandırma ücretlerine neden olabilir.

Trafik için geliştirilmiş rota hesaplamaları

Routes API, trafik bilgileri isterken yanıt gecikmesi ve veri kalitesi arasında denge kurmak için kullanabileceğiniz üç yönlendirme tercihini destekler.

Daha fazla bilgi için Kalite ve gecikmeyi yapılandırma bölümüne bakın.

TRAFFIC_UNAWARE
(varsayılan)		 Rotayı hesaplamak için canlı trafik verilerini değil, zamandan bağımsız trafik verilerini kullanarak en düşük yanıt gecikmesi sağlar. Bu ayar, Directions API'de ve DISTANCE Matris API'de trafiğin kullanılmadığı durumlardakiyle eşdeğerdir.
TRAFFIC_AWARE
(yeni)		 Daha az gecikme için performansa göre optimize edilmiş canlı trafik kalitesi. TRAFFIC_AWARE_OPTIMAL işlevinin aksine bu ayar, gecikmeyi önemli ölçüde azaltmak için optimizasyonlar uygular. Bu ayar, Routes API için yeni olup Directions API'de veya DISTANCE Matrix API'de eşdeğeri yoktur.
TRAFFIC_AWARE_OPTIMAL Yüksek kaliteli, kapsamlı trafik verileri. Bu ayar en yüksek gecikmeyi sağlar ve Directions API'deki departure_time ayarına eşdeğerdir.
Bu tercih, maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan modla eşdeğerdir.

Rota hesaplaması karşılaştırması

Aşağıdaki tabloda Routes API ile Directions API ve DISTANCE Matrix API hizmetleri arasındaki yönlendirme seçenekleri karşılaştırılmıştır.

Trafik seçeneği Routes API Directions API
Mesafe Matrisi API'si		 Yanıt gecikti
Gerçek zamanlı trafik yok TRAFFIC_UNAWARE departure_time özelliği ayarlanmadı Üç mod arasındaki en hızlı gecikme.
Canlı trafik koşulları uygulandı TRAFFIC_AWARE Eşdeğeri yok

Routes API tarafından yeni mod eklendi. GMR kalitesi düşük bir maliyet sayesinde TRAFFIC_UNAWARE ile kıyaslandığında biraz daha fazla gecikme sağlar.

TRAFFIC_AWARE_OPTIMAL ile karşılaştırıldığında çok daha düşük bir gecikmeye sahiptir.
Yüksek kaliteli, kapsamlı canlı trafik verileri uygulandı TRAFFIC_AWARE_OPTIMAL departure_time özellik grubu

maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan modla eşdeğerdir.

Compute Rota Matrisi için bir istekteki öğe sayısı (kaynak sayısı × hedef sayısı) 100'den fazla olamaz.

Temel farklar

Bu bölümde, Routes API ile yerini aldığı hizmetler arasındaki temel farklılıklar ve mevcut uygulamalarınızda bu hizmetlerden geçiş yaparken bu farklılıkları nasıl giderebileceğiniz ele alınmaktadır.

İki yerine bir hizmeti ara

Routes API Uygulamanızın Compute Rotaları ve Compute Rota Matrisi'ni kullanması için API Konsolu'nda yalnızca bir hizmeti etkinleştirin.
Daha fazla bilgi için Google API Konsolu'nda Kurulum bölümüne bakın.
Directions API
Mesafe Matrisi API'si 		İki hizmeti etkinleştirin: API Konsolu'nda Directions API ve Mesafe Matrisi API'sini ayrı hizmetler olarak.

HTTPS POST isteklerini kullanır

Routes API Bir HTTP POST isteğinin parçası olarak istek gövdesinde veya başlıklarda parametreleri iletin.
Örnekler için bkz.
- Rota işleme
- Rota matrisi hesaplama
Directions API
Mesafe Matrisi API'si 		URL parametrelerini HTTP GET isteği kullanarak iletin.

Tahmini varış süresi yanıt farklılıkları

Routes API, GMR'yi döndürür ve duration yanıt özelliğini, aşağıdaki tabloda gösterildiği gibi Directions API ve Mesafe Matrisi API hizmetlerinden farklı bir şekilde kullanır.

TVS türü Routes API Directions API
Mesafe Matrisi API'si
Trafiğin farkında olmayan, zamandan bağımsız TVS.

TRAFFIC_UNAWARE kullanarak ayarlayın.

  • TVS, duration yanıt özelliğinde yer alır.
  • duration ve staticDuration yanıt özellikleri aynı değeri içerir.

İstekte ayarlanmayan departure_time öğesine karşılık gelir.

  • TVS, duration yanıt özelliğinde yer alır.
  • duration_in_traffic yanıt özelliği döndürülmedi.
Gerçek zamanlı trafiği hesaba katan TVS.

TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL kullanarak ayarlayın.

  • Gerçek zamanlı trafiği dikkate alan TVS, duration yanıt özelliğinde yer alır.
  • staticDuration yanıt özelliği, trafik koşulları dikkate alınmadan rotada seyahatin süresini içerir.
  • duration_in_traffic özelliği artık döndürülmüyor.

İstekte departure_time kullanarak ayarlayın.

  • Gerçek zamanlı trafiği dikkate alan TVS, duration_in_traffic yanıt özelliğinde yer alır.

Çoklu çizgi ara noktaları

Bu hizmetle artık enlem/boylam koordinatlarınızı çoklu çizgi ara noktalarına dönüştürmenize gerek yoktur. Bu hizmet, POST isteği gövdesini destekler ve bu nedenle URL dizesi sınırlarından etkilenmez. Mesafe Matrisi API'sinin bazı kullanıcıları, enlem/boylam noktalarını çoklu çizgi ara noktalarına dönüştürerek istek sınırları sorununu ele aldı.

Biçimlendirilmiş adresler (ters coğrafi kod)

Routes API, yanıtta biçimlendirilmiş adresler sağlamaz. Biçimlendirilmiş adresler elde etmek için bu kullanım alanı için geliştirilen ve daha yüksek kaliteli sonuçlar sunan Geocoding API'yi kullanın.

Kullanılabilir ulaşım şekilleri

Directions API'de olduğu gibi, bir rota isteği ulaşım şekli belirtmediğinde Routes API'yi varsayılan mod olarak kullanır. Ancak, istekte bir rota için ulaşım şekli belirtildiğinde Routes API, istek için alternatif seçenekler olarak mevcut seyahat modlarını döndürmez. Kullanım alanınız bu özelliğe bağlıysa özelliği nasıl kullandığınızı açıklayan bir sorun bildirin. Böylece konuyu takip edebiliriz.

Yanıt biçimi olarak XML

Routes API, yanıt biçimi olarak XML sağlamaz. Amaçlarınıza uygun çeşitli JSON'den XML'e dönüştürücüleri internette bulabilirsiniz.