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

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.

Routes API'nin, yerini aldığı ürünlerle arasındaki temel farkları ve gerekli değişiklikleri nasıl yapacağınızı öğrenmek için bu kılavuzdan yararlanabilirsiniz. Diğer Routes API özellikleri hakkında daha fazla bilgi için ürüne genel bakış sayfasını inceleyin.

Önemli iyileştirmeler

Bu bölümde, uygulamalarınızda Routes API'yi kullanırken karşılaşabileceğiniz bazı iyileştirmeler açıklanmaktadır.

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

Routes API Compute Route Matrix	TRAFFIC_AWARE_OPTIMAL özelliğini belirtmediğiniz sürece en fazla 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ı + varış noktaları) eklenebilir.
Distance Matrix API	İstek başına en fazla 25 kaynak veya 25 hedef. Sunucu tarafı istek başına en fazla 100 öğe (başlangıç noktası sayısı × hedef sayısı).

Daha hızlı istek yanıtları

Rota Matrisi Hesaplama özelliği aşağıdaki gecikme süresi iyileştirmelerini sunar:

• Yanıtın akış öğelerini, matrisin tamamı hesaplanmadan alabilirsiniz.
• Yanıt ayrıntılarını özelleştirmek için alan maskelerini kullanın. Bu sayede yalnızca ihtiyacınız olan verileri isteyebilirsiniz. Bu en iyi uygulama, maliyetinizi azaltmanıza da yardımcı olur.
• Trafik için gelişmiş rota hesaplamaları sayesinde veri kalitesi ile yanıt süresi arasında seçim yapabilirsiniz.

Yönlendirmeyle ilgili geliştirmeler

Rota hesaplama özelliği aşağıdaki yönlendirme geliştirmelerini sunar:

• Mesafe ve TVS'ye ek olarak ücret 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ırdık.

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 bir alan maskesi kullanılmalıdır. Alan maskeleme, gereksiz veri istememenizi sağlar. Bu sayede 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 verilerini değil, zamandan bağımsız ortalama trafik verilerini kullanır. Bu sayede en düşük yanıt gecikmesi elde edilir. Bu ayar, Directions API ve Distance Matrix API'de trafik kullanılmadığı duruma eşdeğerdir.
TRAFFIC_AWARE (yeni)	Daha düşük gecikme süresi için performansı optimize edilmiş canlı trafik kalitesi. TRAFFIC_AWARE_OPTIMAL ayarının aksine bu ayar, gecikmeyi önemli ölçüde azaltmak için optimizasyonlar uygular. Bu ayar, Routes API için de yenidir ve Directions API veya Distance Matrix API'de eşdeğeri yoktur.
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ı tarafından kullanılan modla 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 rota 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.
Anlık trafik koşulları uygulanır.	TRAFFIC_AWARE	Eşdeğeri yok	Routes API tarafından yeni bir mod eklendi. Bu işlev, TRAFFIC_UNAWARE'ya kıyasla biraz daha fazla gecikme sağlar ve tahmini varış zamanı kalitesinde küçük bir maliyete neden olur. TRAFFIC_AWARE_OPTIMAL ile karşılaştırıldığında çok daha düşük bir gecikmeye sahiptir.
Yüksek kaliteli, 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 modla eşdeğerdir. Compute Route Matrix için bir istekteki öğe sayısı (başlangıç noktası sayısı × hedef sayısı) 100'ü aşamaz.

Temel farklar

Bu bölümde, Routes API ile yerine geçtiği hizmetler arasındaki temel farklar ve 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	Compute Routes ve Compute Route Matrix'i kullanmak için uygulamanızın API Konsolu'nda yalnızca bir hizmeti etkinleştirin. Daha fazla bilgi için Google API Konsolu'nda kurulum başlıklı makaleyi inceleyin.
Directions API Distance Matrix API	API Konsolu'nda iki hizmeti (Directions API ve Distance Matrix API) ayrı ayrı etkinleştirin.

HTTPS POST isteklerini kullanır

Routes API	İstek gövdesinde veya başlıklarında parametreleri HTTP POST isteğinin bir parçası olarak iletin. Örnekler için şunlara 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ı

Routes API, 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.

ETA türü	Routes API	Directions API Distance Matrix API
Trafik durumundan bağımsız, zamandan bağımsız TVS.	TRAFFIC_UNAWARE kullanarak ayarlayın. Tahmini varış zamanı, duration yanıt özelliğinde yer alır. duration ve staticDuration yanıt özellikleri aynı değeri içerir.	İstek içinde departure_time ayarlanmamış olmasına karşılık gelir. TVS, duration yanıt özelliğinde yer alır. duration_in_traffic yanıt özelliği döndürülmüyor.
Anlık trafik bilgilerini dikkate alan TVS	TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL kullanarak ayarlayın. Gerçek zamanlı trafiği dikkate alan TVS, duration yanıt mülkünde 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. Anlık trafik durumunu dikkate alan tahmini varış zamanı, duration_in_traffic yanıt özelliğinde yer alır.

Çoklu çizgi ara noktaları

POST isteği gövdesini desteklediği için 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ı çok çizgili yol noktalarına dönüştürerek istek sınırları sorununu çözdü.

Biçimlendirilmiş adresler (ters 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 seyahat modları

Directions API'de olduğu gibi Routes API da rota isteğinde seyahat modu belirtilmediğinde varsayılan mod olarak DRIVE'ı kullanır. Ancak bir istekte rota için bir seyahat modu belirtildiğinde, Rotalar 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 takip edebilmemiz için özelliği nasıl kullandığınızı açıklayan bir sorun kaydı oluşturun.

Yanıt biçimi olarak XML

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