Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

Routes API'nin yol tarifinin, mesafenin ve seyahat süresinin hesaplanmasında daha iyi performans sağlaması nedeniyle Directions API'yi ve DISTANCE Matrix API'sini kullanan uygulamaların yerini değiştirmek önemlidir. Routes API'nin işlevlerinin çoğu, Directions API'nin ve Mesafe Matrix API'sinin çoğuyla geriye dönük uyumludur.

Routes API'nin yerini aldığı ürünlere kıyasla Routes API'deki önemli farkları ve gerekli değişikliklerin nasıl ele alınacağını anlamak için bu kılavuzu kullanın. Diğer Routes API özellikleri hakkında daha fazla ayrıntı için ürüne genel bakış sayfasını inceleyin.

Temel 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ı

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

İsteklere daha hızlı yanıt verilmesi

Rota hesaplama 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. Böylece, yalnızca ihtiyacınız olan verileri isteyin. Bu, maliyetinizi azaltmanıza yardımcı olan en iyi uygulamadır.
Trafik için gelişmiş rota hesaplamaları sayesinde veri kalitesinden yanıt süresi arasında denge kurabilirsiniz.

Yönlendirme geliştirmeleri

Rota hesaplama özelliği şu yönlendirme geliştirmelerini sunar:

Ücretli geçiş bilgileri (mesafe ve TVS'ye ek olarak).
2 tekerlekli araç rotaları.
Güvenlik için mola verdiğiniz ara noktaların uygunluğunu onaylayın.
Ara noktalar için seyahat yönünü ve yol kenarı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 belirleyebilirsiniz. Böylece işlem süresi ve faturalandırma ücretleri azalır.

Rotalar API'si	Yanıtta döndürülmesini istediğiniz alanları belirtmek için isteklerinizde bir alan maskesi kullanılmalıdır. Alan maskeleme, gereksiz veri isteğinde bulunmamanızı sağlar. Böylece gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınmış olursunuz. 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 kesinlikle ihtiyaç duymasa bile varsayılan bir alan listesi döndürür. Bu da gereksiz işlem sürelerine ve faturalandırma ücretlerine yol açabilir.

Trafik için gelişmiş rota hesaplamaları

Routes API, trafik bilgilerini isterken yanıt gecikmesi ile 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, zamana bağlı ortalama trafik verilerini kullanır. Böylece en düşük yanıt gecikmesi elde edilir. Bu ayar, Directions API'de ve Uzaklık Matrisi API'sinde trafiğin kullanılmadığı durumlara eşdeğerdir.
`TRAFFIC_AWARE` (yeni)	Daha düşük gecikme için performans açısından 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'de de yeni kullanıma sunulmuştur ve Directions API'de veya Uzaklık Matrisi API'sinde bir eşdeğeri yoktur.
`TRAFFIC_AWARE_OPTIMAL`	Yüksek kaliteli ve kapsamlı trafik verileri. Bu ayar en yüksek gecikmeyi üretir ve Directions API'deki ve Uzaklık Matrisi API'sindeki `departure_time` ayarına eşdeğerdir. Bu tercih, maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan moda eşdeğerdir.

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

Aşağıdaki tabloda, Routes API ile Directions API ve Mesafe Matris API'si hizmetleri arasındaki yönlendirme seçenekleri karşılaştırılmaktadır.

Trafik seçeneği Routes API Directions API
Mesafe Matrisi API'si Gecikme

Gerçek zamanlı trafik yok TRAFFIC_UNAWARE departure_time özelliği ayarlanmadı Üç modun en hızlı gecikme süresi.

Canlı trafik koşulları uygulandı

Trafik seçeneği	Routes API	Directions API Mesafe Matrisi API'si	Gecikme
Gerçek zamanlı trafik yok	`TRAFFIC_UNAWARE`	`departure_time` özelliği ayarlanmadı	Üç modun en hızlı gecikme süresi.
Canlı trafik koşulları uygulandı	`TRAFFIC_AWARE`	Eşdeğeri yok	Routes API tarafından yeni mod eklendi. Düşük bir tahmini varış süresi maliyetiyle `TRAFFIC_UNAWARE` koluna kıyasla biraz daha fazla gecikme sağlar. `TRAFFIC_AWARE_OPTIMAL` ile karşılaştırıldığında çok daha düşük bir gecikme süresine sahiptir.
Yüksek kaliteli ve kapsamlı canlı trafik verileri uygulandı	`TRAFFIC_AWARE_OPTIMAL`	`departure_time` özellik ayarlandı	maps.google.com ve Google Haritalar mobil uygulaması tarafından kullanılan moda eşdeğerdir. İşlem Rotası Matrisi için bir istekteki öğe sayısı (kaynak sayısı × hedef sayısı) 100'ü aşamaz.

TRAFFIC_AWARE

Eşdeğeri yok

Routes API tarafından yeni mod eklendi. Düşük bir tahmini varış süresi maliyetiyle TRAFFIC_UNAWARE koluna kıyasla biraz daha fazla gecikme sağlar.

TRAFFIC_AWARE_OPTIMAL ile karşılaştırıldığında çok daha düşük bir gecikme süresine sahiptir.

Yüksek kaliteli ve kapsamlı canlı trafik verileri uygulandı

TRAFFIC_AWARE_OPTIMAL

departure_time özellik ayarlandı

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

İşlem Rotası Matrisi için bir istekteki öğe sayısı (kaynak sayısı × hedef sayısı) 100'ü aşamaz.

Temel farklar

Bu bölümde, Routes API ile yerini aldığı hizmetler arasındaki temel farklılıkların yanı sıra, mevcut uygulamalarınızda bu hizmetlerden taşıma işlemi gerçekleştirirken bu farklılıkları nasıl ele alabileceğiniz açıklanmaktadır.

İki yerine bir hizmeti arayın

Rotalar API'si	Uygulamanızın API Konsolu'nda Compute Rotaları ve İşlem Rota Matrisi'ni kullanması için 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	API Konsolu'nda ayrı hizmetler olarak Directions API ve Uzaklık Matrisi API'sini olmak üzere iki hizmeti etkinleştirin.

`HTTPS POST` istek kullanır

Rotalar API'si	Parametreleri, bir `HTTP POST` isteğinin parçası olarak istek gövdesine veya başlıklara iletin. Örnekler için şu bölüme göz atın: - Rota hesaplama - Rota matrisini hesaplama
Directions API Mesafe Matrisi API'si	URL parametrelerini bir `HTTP GET` isteği kullanarak iletin.

TVS yanıtı farklılıkları

Routes API, GMR değerini 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

Trafikte bilgisi olmayan, zamana bağlı TVS.

TVS türü	Routes API	Directions API Mesafe Matrisi API'si
Trafikte bilgisi olmayan, zamana bağlı TVS.	`TRAFFIC_UNAWARE` ile ayarlayın. `duration` yanıt özelliğinde bulunan GMR. `duration` ve `staticDuration` yanıt özellikleri aynı değeri içerir.	İstekte ayarlanmayan `departure_time` değerine karşılık gelir. `duration` yanıt özelliğinde bulunan GMR. `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 tahmini varış süresi, `duration` yanıt özelliğinde yer alır. `staticDuration` yanıt özelliği, trafik koşulları dikkate alınmadan 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 tahmini varış süresi, `duration_in_traffic` yanıt özelliğinde yer alır.

TRAFFIC_UNAWARE ile ayarlayın.

duration yanıt özelliğinde bulunan GMR.
duration ve staticDuration yanıt özellikleri aynı değeri içerir.

İstekte ayarlanmayan departure_time değerine karşılık gelir.

duration yanıt özelliğinde bulunan GMR.
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 tahmini varış süresi, duration yanıt özelliğinde yer alır.
staticDuration yanıt özelliği, trafik koşulları dikkate alınmadan 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 tahmini varış süresi, duration_in_traffic yanıt özelliğinde yer alır.

Çoklu çizgi ara noktaları

Bu hizmetle enlem/boylam koordinatlarınızı artık çoklu çizgi ara noktalarına dönüştürmenize gerek yoktur. Bu hizmet POST istek gövdesini destekler ve dolayısıyla URL dizesi sınırlarından etkilenmez. Mesafe 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 ele aldı.

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

Routes API, yanıtta biçimlendirilmiş adresler sağlamıyor. Biçimlendirilmiş adresler elde etmek için bu kullanım alanı için oluşturulan ve daha yüksek kaliteli sonuçlar sağlayan Coğrafi Kodlama API'sini kullanın.

Kullanılabilir ulaşım şekilleri

Directions API'de olduğu gibi, rota isteği bir ulaşım şekli belirtmediğinde Routes API'de varsayılan mod olarak DRIVE kullanılır. Bununla birlikte, bir istek bir rota için ulaşım şekli belirttiğinde Routes API, istek için alternatif seçenekler olarak mevcut ulaşım şekilleri dizisi döndürmez. Kullanım alanınız bu özelliğe dayanıyorsa konuyu takip edebilmemiz için özelliği nasıl kullandığınızı açıklayan bir sorun bildirin.

Yanıt biçimi olarak XML

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