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

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Rotalar API'si, yol tariflerini, mesafeyi ve seyahat süresini hesaplama konusunda daha iyi performans sunar. Bu nedenle, Directions API ve Distance Matrix API'yi kullanan uygulamaları değiştirmek faydalıdır. Routes API'nin işlevlerinin çoğu, Directions API ve Distance Matrix API ile geriye dönük olarak uyumludur.

Bu kılavuzu kullanarak, Routes API'nin yerine geçtiği ürünlere kıyasla temel farklılıklarını ve gerekli değişikliklerin nasıl yapılacağını öğrenebilirsiniz. Diğer Routes API özellikleri hakkında daha fazla bilgi için ürüne genel bakış bölümünü inceleyin.

Önemli iyileştirmeler

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

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

Routes API Compute Route Matrix
  • TRAFFIC_AWARE_OPTIMAL belirtmediğiniz sürece maksimum 625 öğe.
  • TRAFFIC_AWARE_OPTIMAL ile en fazla 100 öğe. Gelişmiş yönlendirme tercihleri başlıklı makaleyi inceleyin.
  • Yer kimliği kullanılarak en fazla 50 ara nokta (kaynaklar + hedefler).
Distance Matrix API
  • İstek başına en fazla 25 kaynak veya 25 hedef.
  • Sunucu tarafı isteği başına en fazla 100 öğe (kaynak sayısı × hedef sayısı).

Daha hızlı istek yanıtları

Compute Route Matrix özelliği aşağıdaki gecikme süresi iyileştirmelerini sunar:

  • Matrisin tamamı hesaplanmadan yanıtın akış öğelerini alma
  • Yanıt ayrıntılarını özelleştirmek için alan maskelerini kullanın. Bu sayede yalnızca ihtiyacınız olan verileri isteyebilir ve maliyetinizi düşürebilirsiniz.
  • Trafik için gelişmiş rota hesaplamaları sayesinde veri kalitesi ile yanıt süresi arasında seçim yapabilirsiniz.

Yönlendirmeyle ilgili iyileştirmeler

İşlem rotası özelliği aşağıdaki yönlendirme geliştirmelerini sunar:

  • Mesafe ve tahmini varış zamanına ek olarak ücretli yol bilgileri.
  • 2 tekerlekli araç rotaları.
  • Güvenlik için mola noktalarınızı uygun hale getirin.
  • Ara noktalar için seyahat yönünü ve yolun tarafını ayarlayarak tahmini varış zamanı doğruluğunu artırın.

Yalnızca ihtiyacınız olan verileri isteyin

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

Routes API
Compute Routes
Compute Route Matrix 		İsteklerinizde, yanıtta döndürülmesini istediğiniz alanları belirtmek için alan maskesi kullanmanız gerekir. Alan maskeleme, gereksiz veri istememenizi sağlayarak gereksiz işlem süresini ve faturalandırma ücretlerini önler.
Daha fazla bilgi için Döndürülecek alanları seçme başlıklı makaleyi inceleyin.
Directions API
Distance Matrix API 		Uygulamanızın kesinlikle ihtiyacı olmasa bile varsayılan bir alan listesi döndürür. Bu durum, gereksiz işlem süresine ve faturalandırma ücretlerine neden olabilir.

Trafik için gelişmiş rota hesaplamaları

Routes API, trafik bilgisi 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 gecikme süresini yapılandırma başlıklı makaleyi inceleyin.

TRAFFIC_UNAWARE
(varsayılan)		 Rotayı hesaplamak için canlı trafik verileri yerine zamandan bağımsız ortalama trafik verilerini kullanır. Bu da en düşük yanıt gecikmesiyle sonuçlanır. Bu ayar, Directions API ve Distance Matrix API'de trafiğin kullanılmadığı duruma eşdeğerdir.
TRAFFIC_AWARE
(yeni)		 Gecikmeyi azaltmak için performansı optimize edilmiş canlı trafik kalitesi. TRAFFIC_AWARE_OPTIMAL ayarının aksine bu ayar, gecikme süresini önemli ölçüde azaltmak için optimizasyonlar uygular. Bu ayar, Directions API veya Distance Matrix API'de eşdeğeri olmayan Routes API için de yeni bir ayardır.
TRAFFIC_AWARE_OPTIMAL Yüksek kaliteli ve kapsamlı trafik verileri. Bu ayar, en yüksek gecikmeyi üretir ve Directions API ile Distance Matrix API'deki departure_time ayarına eşdeğerdir.
Bu tercih, maps.google.com ve Google Haritalar mobil uygulamasının kullandığı moda eşdeğerdir.

Rota hesaplama 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ılmaktadır.

Trafik seçeneği Routes API Directions API
Distance Matrix API		 Gecikme
Anlık trafik bilgisi yok TRAFFIC_UNAWARE departure_time mülk ayarlanmadı Üç mod arasında en hızlı gecikme süresine sahiptir.
Canlı trafik koşulları uygulandı TRAFFIC_AWARE Eşdeğeri yok

Routes API tarafından eklenen yeni mod. ETA kalitesinde küçük bir maliyetle TRAFFIC_UNAWARE'dan biraz daha fazla gecikme sağlar.

TRAFFIC_AWARE_OPTIMAL'ya kıyasla çok daha düşük gecikmeye sahiptir.
Yüksek kaliteli ve kapsamlı canlı trafik verileri uygulanır. TRAFFIC_AWARE_OPTIMAL departure_time özellik grubu

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

Compute Route Matrix için bir istekteki öğe sayısı (başlangıç noktası sayısı × hedef sayısı) 100'ü geçemez.

Temel farklar

Bu bölümde, Routes API ile yerine geçtiği hizmetler arasındaki temel farklılıklar ve mevcut uygulamalarınızda bu hizmetlerden geçiş yaparken bu farklılıkları nasıl ele alabileceğiniz açıklanmaktadır.

İki hizmet yerine tek bir hizmeti arama

Routes API Uygulamanızın Compute Routes ve Compute Route Matrix'i kullanabilmesi için API Console'da yalnızca bir hizmeti etkinleştirin.
Daha fazla bilgi için Google API Konsolu'nda Ayarlama başlıklı makaleyi inceleyin.
Directions API
Distance Matrix API 		API Konsolu'nda iki hizmeti ayrı ayrı etkinleştirin: Directions API ve Distance Matrix API.

HTTPS POST isteklerini kullanır

Routes API Parametreleri istek gövdesinde veya üstbilgilerde HTTP POST isteğinin bir parçası olarak iletin.
Örnekler için şu kaynaklara bakın:
- Rota hesaplama
- Rota matrisi hesaplama
Directions API
Distance Matrix API 		URL parametrelerini HTTP GET isteği kullanarak iletin.

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

Rotalar API'si, tahmini varış zamanını döndürür ve aşağıdaki tabloda gösterildiği gibi duration yanıt özelliğini Directions API ve Distance Matrix API hizmetlerinden farklı şekilde kullanır.

GMR türü Routes API Directions API
Distance Matrix API
Trafik bilgisi yok, zamandan bağımsız TVS.

TRAFFIC_UNAWARE kullanılarak ayarlanır.

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

İstekte departure_time ayarlanmamış olmasına karşılık gelir.

  • ETA, duration yanıt özelliğinde yer alır.
  • duration_in_traffic yanıt özelliği döndürülmüyor.
Gerçek zamanlı trafiği dikkate alan TVS.

TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL kullanarak ayarlayın.

  • Gerçek zamanlı trafik durumu dikkate alınarak hesaplanan tahmini varış zamanı, duration yanıt özelliğinde yer alır.
  • staticDuration yanıt özelliği, trafik koşulları dikkate alınmadan rota boyunca seyahat etme süresini içerir.
  • duration_in_traffic özelliği artık döndürülmüyor.

İstek içinde departure_time kullanılarak ayarlanır.

  • Gerçek zamanlı trafik durumu dikkate alınarak hesaplanan tahmini varış zamanı, duration_in_traffic yanıt özelliğinde yer alır.

Çoklu çizgi yol noktaları

POST isteği gövdesini destekleyen bu hizmetle artık enlem/boylam koordinatlarınızı çoklu çizgi yol noktalarına dönüştürmeniz gerekmiyor. Bu nedenle, URL dizesi sınırlarından etkilenmez. Distance Matrix API'nin bazı kullanıcıları, enlem/boylam noktalarını çoklu çizgi ara noktalarına dönüştürerek istek sınırları sorununu çözdü.

Biçimlendirilmiş adresler (tersine coğrafi kodlama)

Routes API, yanıtta biçimlendirilmiş adresler sağlamaz. Biçimlendirilmiş adresler almak için bu kullanım alanı için oluşturulmuş ve daha yüksek kaliteli sonuçlar sağlayan Geocoding API'yi kullanın.

Kullanılabilir ulaşım şekilleri

Yol Tarifi API'sinde olduğu gibi, Rota API'si de bir rota isteğinde ulaşım şekli belirtilmediğinde varsayılan mod olarak ARABA'yı kullanır. Ancak bir rota için seyahat modu belirtildiğinde, Routes API, istek için alternatif seçenekler olarak kullanılabilir seyahat modlarının bir dizisini döndürmez. Kullanım alanınız bu özelliğe bağlıysa bir sorun kaydı oluşturarak özelliği nasıl kullandığınızı açıklayın. Böylece, konuyu takip edebiliriz.

Yanıt biçimi olarak XML

Routes API, yanıt biçimi olarak XML sağlamaz. İnternette, amaçlarınıza uygun çeşitli JSON-XML dönüştürücüler bulabilirsiniz.