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

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Routes API, 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ı olacaktı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 Rotalar API'sini kullanırken karşılaşabileceğiniz bazı geliştirmeler açıklanmaktadı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 (başlangıç noktaları + 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 maskeleri 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 TVS doğruluğunu artırın.

Yalnızca ihtiyacınız olan verileri isteyin

Artık hangi alanların döndürüleceğini belirleyerek 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ğlar. Böylece gereksiz işlem süresi ve faturalandırma ücretlerinden kaçınabilirsiniz.
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 ortalama zamandan bağımsız trafik verilerini kullanır. Bu da en düşük yanıt gecikmesini sağlar. 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 yok TRAFFIC_UNAWARE departure_time mülk ayarlanmadı Üç mod arasında en hızlı gecikme süresine sahiptir.
Canlı trafik koşulları uygulanır. 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 ile karşılaştırıldığında çok daha düşük bir 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ının kullandığı 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 farkların yanı sıra mevcut uygulamalarınızda bu hizmetlerden geçiş yaparken bu farkları 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 İstek gövdesinde veya üstbilgilerde parametreleri 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 		HTTP GET isteği kullanarak URL parametrelerini iletin.

TVS yanıtı farklılıkları

Rotalar API'si, aşağıdaki tabloda gösterildiği gibi, Directions API ve Distance Matrix API hizmetlerinden farklı olarak duration yanıt özelliğini kullanarak TVS döndürür.

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

TRAFFIC_UNAWARE kullanarak ayarlayın.

  • 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ı trafik durumunu dikkate alan TVS.

TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL kullanarak ayarlayın.

  • Gerçek zamanlı trafik durumunu dikkate alan 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 durumunu dikkate alan 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ırı sorununu çözdü.

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

Routes API, yanıtta biçimlendirilmiş adresler sağlamaz. Biçimlendirilmiş adresler elde etmek 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

Routes API, Directions API'de olduğu gibi, bir rota isteğinde seyahat modu belirtilmediğinde varsayılan mod olarak ARABA'yı kullanır. Ancak bir rota için ulaşım modu belirtildiğinde, Routes API, istek için alternatif seçenek olarak kullanılabilir ulaşım modlarının dizisini 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 kaydı oluşturun. 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.