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

Rotalar API'si, yol tarifi, mesafe ve seyahat süresini hesaplama konusunda daha iyi performans sunar. Bu da şu anda Directions API ve Distance Matrix API kullanan uygulamaları değiştirmeyi değerli kılar. Rotalar API'sinin işlevlerinin çoğu hem Directions API hem de Distance Matrix API ile geriye dönük uyumludur.

Routes API'nin, yerini aldığı ürünlere kıyasla temel farklılıklarını ve gerekli değişikliklerin nasıl yapılacağını öğrenmek 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ünü inceleyin.

Ö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 maksimum 625 öğe.
  • TRAFFIC_AWARE_OPTIMAL ile en fazla 100 öğe. Gelişmiş yönlendirme tercihleri bölümüne bakın.
  • Yer kimliği kullanılarak en fazla 50 yol noktası (başlangıç noktaları + hedefler).
Distance Matrix API
  • İstek başına en fazla 25 kaynak veya 25 hedef.
  • Sunucu tarafı istek başına en fazla 100 öğe (kaynak sayısı × hedef sayısı).

Daha hızlı istek yanıtları

Hesaplama yolu matrisi özelliği aşağıdaki gecikme iyileştirmelerini sunar:

  • Matrisin tamamı hesaplanmadan önce yanıtın akış öğelerini alın.
  • Yanıt ayrıntılarını özelleştirmek için alan maskelerini kullanın. Yalnızca ihtiyacınız olan verileri isteyerek maliyetinizi düşürmenize de yardımcı olan en iyi uygulamalardan birini uygulayın.
  • Veri kalitesi ile yanıt süresi arasında denge kurabilmeniz için trafik için gelişmiş rota hesaplamaları

Yönlendirme iyileştirmeleri

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

  • Mesafe ve tahmini varış zamanına ek olarak otoyol geçiş ücreti bilgileri.
  • 2 tekerlekli araç rotaları.
  • Güvenlik için durak noktalarınızın yol işaretlerini doğrulayın.
  • Ara noktalar için seyahat yönü ve yolun kenarı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 belirterek işlem süresini ve faturalandırma ücretlerini azaltabilirsiniz.

Routes API İ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. 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 bu alanlara kesinlikle ihtiyaç duymasa bile varsayılan bir alan listesi döndürür. Bu durum, gereksiz işlem süresi ve faturalandırma ücretlerine yol açabilir.

Trafik için gelişmiş rota hesaplamaları

Rotalar API'si, trafik bilgileri isteğinde bulunurken yanıt gecikmesi ile veri kalitesi arasında denge kurmak için kullanabileceğiniz üç yönlendirme tercihini destekler.

Daha fazla bilgi için Kaliteyi ve gecikmeyi yapılandırma başlıklı makaleyi inceleyin.

TRAFFIC_UNAWARE
(varsayılan)		 Rotayı hesaplamak için canlı trafik verileri yerine zamana bağlı olmayan ortalama trafik verilerini kullanır. Bu da en düşük yanıt gecikmesine neden olur. 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 açısından optimize edilmiş canlı trafik kalitesi. TRAFFIC_AWARE_OPTIMAL'e kıyasla bu ayar, gecikmeyi önemli ölçüde azaltmak için optimizasyonlar uygular. Bu ayar, Directions API veya Distance Matrix API'de eşdeğeri olmayan, Rotalar API'si için de yenidir.
TRAFFIC_AWARE_OPTIMAL Yüksek kaliteli ve kapsamlı trafik verileri. Bu ayar en yüksek gecikmeyi oluşturur 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
Gerçek zamanlı trafik yok TRAFFIC_UNAWARE departure_time mülkü ayarlanmadı Üç mod arasında en hızlı gecikmeye sahiptir.
Canlı trafik koşulları uygulandı TRAFFIC_AWARE Eşdeğeri yok

Routes API tarafından eklenen yeni mod. ETA kalitesinin küçük bir maliyeti karşılığında TRAFFIC_UNAWARE'ten biraz daha yüksek bir gecikme süresi sağlar.

TRAFFIC_AWARE_OPTIMAL'e kıyasla çok daha düşük bir gecikmeye sahiptir.
Yüksek kaliteli, kapsamlı canlı trafik verileri uygulanır. TRAFFIC_AWARE_OPTIMAL departure_time mülk 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ı (kaynak sayısı × hedef sayısı) 100'ü aşamaz.

Temel farklılıklar

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

İki yerine bir hizmeti arama

Routes API Hesaplanmış Rotalar ve Hesaplanmış Rota Matrisi'ni kullanmak için uygulamanızın API Console'da yalnızca bir hizmetini 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 etkinleştirin: Directions API ve Distance Matrix API.

HTTPS POST isteği kullanıyor

Routes API Parametreleri, HTTP POST isteği kapsamında istek gövdesinde veya üstbilgilerde iletin.
Örnekler için şu makalelere bakın:
- Rota hesaplama
- Rota matrisi hesaplama
Directions API
Distance Matrix API 		HTTP GET isteği kullanarak URL parametrelerini iletin.

ETA yanıtı farklılıkları

Rotalar API'si, ETA'yı döndürür ve duration yanıt mülkünü aşağıdaki tabloda gösterildiği gibi Directions API ve Distance Matrix API hizmetlerinden farklı şekilde kullanır.

GMR türü Routes API Directions API
Distance Matrix API
Trafik bilgisine sahip olmayan, zamandan bağımsız TVS.

TRAFFIC_UNAWARE ile ayarlayın.

  • duration yanıt mülkünde bulunan ETA.
  • duration ve staticDuration yanıt özellikleri aynı değeri içeriyor.

İstekte departure_time ayarlanmamasına karşılık gelir.

  • duration yanıt mülkünde bulunan ETA.
  • duration_in_traffic yanıt özelliği döndürülmez.
Gerçek zamanlı trafiği dikkate alan TVS.

TRAFFIC_AWARE veya TRAFFIC_AWARE_OPTIMAL'ü kullanarak ayarlayın.

  • Gerçek zamanlı trafiği dikkate alan ETA, duration yanıt mülkünde yer alır.
  • staticDuration yanıt mülkü, trafik koşullarını dikkate almadan rotadaki seyahat süresini içerir.
  • duration_in_traffic özelliği artık döndürülmemektedir.

İstekte departure_time kullanılarak ayarlanır.

  • Gerçek zamanlı trafiği dikkate alan ETA, duration_in_traffic yanıt mülkünde yer alır.

Çoklu çizgi yol noktaları

Bu hizmet, POST istek gövdesini desteklediği için artık URL dizesi sınırlarından etkilenmiyor. Bu sayede, enlem/boylam koordinatlarınızı artık bu hizmetle çoklu çizgi yol işaretlerine dönüştürmeniz gerekmiyor. Distance Matrix API'nin bazı kullanıcıları, istekte bulunma sınırı sorununu çözmek için enlem/boylam noktalarını çoklu çizgi yol noktalarına dönüştürdü.

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

Routes API, yanıtta biçimlendirilmiş adresler sağlamaz. Şekillendirilmiş adresler elde etmek için bu kullanım alanı için tasarlanmış ve daha yüksek kaliteli sonuçlar sağlayan Coğrafi Kodlama API'yi kullanın.

Kullanılabilir ulaşım şekilleri

Yol Tarifleri API'sinde olduğu gibi, bir rota isteği ulaşım şekli belirtmediğinde Routes API de varsayılan mod olarak DRIVE'ı kullanır. Ancak bir istek bir rota için ulaşım modu belirttiğinde Routes API, istek için alternatif seçenekler olarak mevcut ulaşım modları dizisini döndürmez. Kullanım alanınız bu özelliğe dayanıyorsa özelliği nasıl kullandığınızı açıklayarak 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 olacak çeşitli JSON'dan XML'e dönüştürücüler bulabilirsiniz.