Directions API (eski) aracılığıyla yol tarifi alma

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Bu ürün eski durumdadır. Ekim 2026'dan itibaren Directions API (Eski) yeni Google Cloud projeleri için etkinleştirilemeyecek. Mevcut projeler tam olarak desteklenmeye devam eder. Yeni özellikler ve daha iyi performans için Routes API'ye geçiş yapın.

Kullanıcı girişine gerçek zamanlı olarak yanıt veren rota hesaplamaları için (örneğin, bir kullanıcı arayüzü öğesinde) Directions API'yi (Eski) veya Maps JavaScript API'yi kullanıyorsanız Rota hizmetini kullanabilirsiniz. Sunucu tarafında kullanım için Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi'ni kullanabilirsiniz.

Directions API (Eski) ile şunları yapabilirsiniz:

  • Toplu taşıma, araç, yaya veya bisiklet dahil olmak üzere çeşitli ulaşım modları için yol tarifi arayabilirsiniz.
  • Bir dizi yol noktası kullanarak çok parçalı yol tarifleri döndürür.
  • Başlangıç noktalarını, varış noktalarını ve ara noktaları metin dizeleri (ör. "Chicago, IL" veya "Darwin, NT, Avustralya"), yer kimlikleri ya da enlem/boylam koordinatları olarak belirtin.

API, yol tariflerini hesaplarken en verimli rotaları döndürür. Optimize edilen birincil faktör seyahat süresidir. Ancak API, en verimli rotanın hangisi olduğuna karar verirken mesafe, dönüş sayısı ve daha birçok faktörü de göz önünde bulundurabilir.

Başlamadan önce

Directions API'yi (Eski) kullanmaya başlamadan önce faturalandırma hesabı ve Directions API (Eski) etkinleştirilmiş bir projeniz olmalıdır. Daha fazla bilgi için Cloud Console'da kurulum başlıklı makaleyi inceleyin.

Directions API (Eski) isteklerinizi oluşturma

Directions API (Eski) isteği aşağıdaki biçimdedir:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Burada outputFormat, aşağıdaki değerlerden biri olabilir:

  • json (önerilen), JavaScript Object Notation (JSON) biçiminde çıkış yapılacağını belirtir.
  • xml, çıkışın XML olarak gösterileceğini belirtir.

Not: URL'lerin geçerli olması için uygun şekilde kodlanması gerekir ve tüm web hizmetleri için 16.384 karakterle sınırlıdır. URL'lerinizi oluştururken bu sınırı göz önünde bulundurun.

URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) karakteri kullanılarak ayrılır. Tüm ayrılmış karakterler (örneğin, artı işareti "+") URL kodlamalı olmalıdır. Parametrelerin listesi ve olası değerleri aşağıda sıralanmıştır.

Gerekli parametreler

hedef

Yol tarifini hesaplamak istediğiniz yer kimliği, adres veya metin biçimindeki enlem/boylam değeri. Hedef parametresinin seçenekleri, kaynak parametresinin seçenekleriyle aynıdır.

kaynak

Yol tarifini hesaplamak istediğiniz yer kimliği, adres veya metin biçimindeki enlem/boylam değeri.

  • Yer kimliklerinin önüne place_id: eklenmelidir. Geocoding API ve Places API'den (Yer Adı Otomatik Tamamlama dahil) yer kimliklerini alabilirsiniz. Yer Adı Otomatik Tamamlama'daki yer kimliklerini kullanan bir örnek için Yer Adı Otomatik Tamamlama ve Yol Tarifi başlıklı makaleyi inceleyin. Yer kimlikleri hakkında daha fazla bilgi için Yer kimliğine genel bakış başlıklı makaleyi inceleyin. 

    origin=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE

  • Bir adres iletirseniz Directions hizmeti, dizeyi coğrafi olarak kodlar ve yol tariflerini hesaplamak için enlem/boylam koordinatına dönüştürür. Bu koordinat, Geocoding API tarafından döndürülen koordinattan farklı olabilir (ör. bir binanın merkezi yerine girişi). 

    origin=24+Sussex+Drive+Ottawa+ON

    Yer kimliklerinin kullanılması, adreslerin veya enlem/boylam koordinatlarının kullanılmasına tercih edilir. Koordinatların kullanılması, noktanın her zaman bu koordinatlara en yakın yola sabitlenmesine neden olur. Bu yol, mülke erişim noktası olmayabilir, hatta hedefe hızlı veya güvenli bir şekilde ulaşmanızı sağlayan bir yol bile olmayabilir.

  • Koordinatları iletirseniz nokta en yakın yola sabitlenir. Yer kimliği iletmek tercih edilir. Koordinatları iletirseniz enlem ve boylam değerleri arasında boşluk olmadığından emin olun. 

    origin=41.43206,-81.38992

  • Plus Code'lar, global kod veya bileşik kod olarak biçimlendirilmelidir. Plus Code'ları burada gösterildiği gibi biçimlendirin (artı işaretleri URL kod dışına alma ile %2B ve boşluklar URL kod dışına alma ile %20 olur).

    • Global kod, 4 karakterlik bir alan kodu ve 6 karakter veya daha uzun bir yerel koddur (849VCWC8+R9, 849VCWC8%2BR9).
    • Bileşik kod, açık bir konum içeren 6 karakter veya daha uzun bir yerel koddur (CWC8+R9 Mountain View, CA, ABD, CWC8%2BR9%20Mountain%20View%20CA%20USA şeklindedir).
Not: Verimlilik ve doğruluk için mümkün olduğunda yer kimliklerini kullanın. Bu kimlikler, enlem/boylam değer çifti gibi benzersiz şekilde açıktır ve erişim noktaları ile trafik değişkenleri gibi rotalama için coğrafi kodlama avantajları sağlar. Adreslerin aksine, kimlikler hizmetin bir arama veya yer ayrıntıları için ara istek gerçekleştirmesini gerektirmez. Bu nedenle performans daha iyidir.

İsteğe bağlı parametreler

alternatifler

true olarak ayarlanırsa Directions hizmetinin yanıtta birden fazla rota alternatifi sunabileceğini belirtir. Alternatif rotalar sunmanın sunucudan yanıt alma süresini artırabileceğini unutmayın. Bu özellik yalnızca ara yol noktası olmayan istekler için kullanılabilir. Daha fazla bilgi için ara nokta kılavuzuna bakın.

arrival_time

Toplu taşıma yol tarifleri için tercih edilen varış zamanını, 1 Ocak 1970 UTC gece yarısından itibaren saniye cinsinden belirtir. departure_time veya arrival_time değerlerinden birini belirtebilirsiniz ancak ikisini birden belirtemezsiniz. arrival_time değerinin tam sayı olarak belirtilmesi gerektiğini unutmayın.

kaçınma

Hesaplanan rotaların belirtilen özelliklerden kaçınması gerektiğini gösterir. Bu parametre aşağıdaki bağımsız değişkenleri destekler:

  • tolls, hesaplanan rotada paralı yolların/köprülerin kullanılmaması gerektiğini belirtir.
  • highways, hesaplanan rotada otoyolların kullanılmaması gerektiğini belirtir.
  • ferries, hesaplanan rotada feribotların kullanılmaması gerektiğini belirtir.
  • indoor, hesaplanan rotada yürüme ve toplu taşıma yol tarifleri için kapalı alanlardaki merdivenlerin kullanılmaması gerektiğini belirtir.

Avoid parametresine birden fazla kısıtlama ileterek ücretli geçiş, otoyol ve feribot kombinasyonlarından kaçınan bir rota isteyebilirsiniz. Örneğin: 

avoid=tolls|highways|ferries.

departure_time

Tercih edilen kalkış saatini belirtir. Zamanı, 1 Ocak 1970 UTC gece yarısından itibaren saniye cinsinden bir tam sayı olarak belirtebilirsiniz. 31.12.9999T23:59:59.999999999Z'den sonraki bir departure_time belirtilirse API, departure_time değerini 31.12.9999T23:59:59.999999999Z olarak ayarlar. Alternatif olarak, kalkış saatini geçerli saate (en yakın saniyeye göre doğru) ayarlayan bir now değeri belirtebilirsiniz. Kalkış saati iki durumda belirtilebilir:

  • Seyahat modunun toplu taşıma olduğu istekler için: İsteğe bağlı olarak departure_time veya arrival_time değerlerinden birini belirtebilirsiniz. Hiçbir zaman belirtilmezse departure_time varsayılan olarak geçerli zamana ayarlanır (yani kalkış saati varsayılan olarak geçerli saate ayarlanır).
  • Seyahat modunun sürüş olduğu istekler için: Trafik koşullarını dikkate alan bir rota ve seyahat süresi (yanıt alanı: duration_in_traffic) almak için departure_time değerini belirtebilirsiniz. departure_time, geçerli zamana veya gelecekteki bir zamana ayarlanmalıdır. Geçmişte olamaz.
Not: Kalkış saati belirtilmezse rota ve süre seçimi, yol ağına ve zamandan bağımsız ortalama trafik koşullarına göre yapılır. Belirli bir isteğin sonuçları; yol ağındaki değişiklikler, güncellenen ortalama trafik koşulları ve hizmetin dağıtık yapısı nedeniyle zaman içinde değişiklik gösterebilir. Sonuçlar, neredeyse eşdeğer rotalar arasında herhangi bir zamanda veya sıklıkta da değişiklik gösterebilir.
Not: mode=driving olduğunda departure_time değerini belirten Distance Matrix istekleri, istek başına en fazla 100 öğeyle sınırlıdır. Başlangıç noktası sayısı ile hedef sayısı çarpılarak öğe sayısı bulunur.

language

Sonuçların döndürüleceği dil. Bu durumun yalnızca start_address ve end_address alanlarındaki coğrafi kodlu adresler, distance ve duration alanlarındaki (bacaklar ve adımlarda) yerelleştirilmiş metinler ve html_instructions alanındaki manevra açıklamaları için geçerli olduğunu unutmayın. html_instructions alanındaki adlar ve adresler için geçerli değildir. Bunlar yerel dillerinde ve alfabelerinde biçimlendirilir.

  • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste kapsamlı olmayabilir.
  • language sağlanmazsa API, Accept-Language başlığında belirtilen tercih edilen dili kullanmaya çalışır.
  • API, hem kullanıcı hem de yerel halk tarafından okunabilen bir açık adres sağlamak için elinden geleni yapar. Bu amaca ulaşmak için tercih edilen dili dikkate alarak açık adresleri yerel dilde döndürür ve gerekirse kullanıcının okuyabileceği bir alfabeye dönüştürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen dilde döndürülür.
  • Tercih edilen dilde bir ad yoksa API en yakın eşleşmeyi kullanır.
  • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile göre farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlı kelimeler. Örneğin, Macarcada utca ve tér, sokak kelimesinin eş anlamlılarıdır.

mod

Mesafelerin ve yol tariflerinin hesaplanması için kullanılacak ulaşım modunu belirtebilirsiniz. Varsayılan olarak driving modu kullanılır. Varsayılan olarak, yol tarifleri arabayla yol tarifi olarak hesaplanır. Aşağıdaki seyahat modları desteklenir:

  • driving (varsayılan), standart arabayla yol tarifini veya yol ağını kullanarak mesafeyi gösterir.
  • walking, yaya yolları ve kaldırımlar (varsa) üzerinden yaya yol tarifi veya mesafe bilgisi ister.
  • bicycling, bisiklet yolları ve tercih edilen sokaklar (varsa) üzerinden bisiklet için yol tarifi veya mesafe bilgisi ister.
  • transit, toplu taşıma rotalarını (varsa) kullanarak yol tarifi veya mesafe bilgisi ister. Modu toplu taşıma olarak ayarlarsanız isteğe bağlı olarak departure_time veya arrival_time belirtebilirsiniz. Hiçbir zaman belirtilmezse departure_time varsayılan olarak geçerli zamana ayarlanır (yani kalkış saati varsayılan olarak geçerli saate ayarlanır). İsteğe bağlı olarak transit_mode ve/veya transit_routing_preference da ekleyebilirsiniz. Toplu taşıma gezileri, veri sağlayıcılar tarafından sağlanan toplu taşıma bilgilerinin kullanılabilirliğine bağlı olarak geçmişte 7 güne kadar veya gelecekte 100 güne kadar kullanılabilir. Toplu taşıma programları sık sık değişir, mevcut toplu taşıma gezileri zaman içinde değişebilir ve çok önceden yapılan tahminler için tutarlı sonuçlar sağlanacağı garanti edilmez.
Not: Hem yaya hem de bisiklet için yol tarifi bazen net yaya veya bisiklet yolları içermeyebilir. Bu nedenle, bu yol tarifleri döndürülen sonuçta kullanıcıya göstermeniz gereken uyarılar döndürür.

bölge

İki karakterli bir ccTLD ("üst düzey alan") değeri olarak belirtilen bölge kodu. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için).

traffic_model

Trafikte geçen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, yanıttaki duration_in_traffic alanında döndürülen değeri etkiler. Bu alan, geçmiş ortalamalara göre trafikte geçirilen tahmini süreyi içerir. traffic_model parametresi yalnızca isteğin departure_time içerdiği arabayla yol tarifi için belirtilebilir. Bu parametre için kullanılabilen değerler şunlardır:

  • best_guess (varsayılan), döndürülen duration_in_traffic değerinin, hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenler göz önünde bulundurularak seyahat süresinin en iyi tahmini olması gerektiğini belirtir. Canlı trafik, departure_time şu ana yaklaştıkça daha önemli hale gelir.
  • pessimistic, döndürülen duration_in_traffic değerinin çoğu gün gerçek seyahat süresinden daha uzun olması gerektiğini gösterir. Ancak trafik koşullarının özellikle kötü olduğu bazı günlerde bu değer aşılabilir.
  • optimistic, döndürülen duration_in_traffic değerinin çoğu gün gerçek seyahat süresinden daha kısa olması gerektiğini gösterir. Ancak trafik koşullarının özellikle iyi olduğu bazı günlerde bu değerden daha hızlı olabilir.

best_guess varsayılan değeri, kullanım alanlarının büyük çoğunluğu için en faydalı tahminleri sağlar. best_guess tahmin modelinin canlı trafik bilgilerini entegre etme şekli nedeniyle best_guess seyahat süresi tahmini optimistic değerinden daha kısa veya pessimistic değerinden daha uzun olabilir.

transit_mode

Bir veya daha fazla tercih edilen toplu taşıma modunu belirtir. Bu parametre yalnızca toplu taşıma yol tarifleri için belirtilebilir. Parametre aşağıdaki bağımsız değişkenleri destekler:

  • bus, hesaplanan rotada otobüsle seyahatin tercih edilmesi gerektiğini gösterir.
  • subway, hesaplanan rotada metroyla seyahatin tercih edilmesi gerektiğini belirtir.
  • train, hesaplanan rotada trenle seyahatin tercih edilmesi gerektiğini gösterir.
  • tram, hesaplanan rotada tramvay ve hafif raylı sistemle seyahatin tercih edilmesi gerektiğini belirtir.
  • rail, hesaplanan rotanın tren, tramvay, hafif raylı sistem ve metro ile seyahati tercih etmesi gerektiğini gösterir. Bu, transit_mode=train|tram|subway değerine eşdeğerdir.

transit_routing_preference

Toplu taşıma rotalarıyla ilgili tercihleri belirtir. Bu parametreyi kullanarak, API tarafından seçilen varsayılan en iyi rotayı kabul etmek yerine döndürülen seçenekleri etkileyebilirsiniz. Bu parametre yalnızca toplu taşıma yol tarifi için belirtilebilir. Parametre aşağıdaki bağımsız değişkenleri destekler:

  • less_walking, hesaplanan rotada sınırlı miktarda yürüyüş tercih edilmesi gerektiğini gösterir.
  • fewer_transfers, hesaplanan rotada sınırlı sayıda aktarma tercih edilmesi gerektiğini gösterir.

birim

Sonuçlar gösterilirken kullanılacak birim sistemini belirtir.

Yol tarifi sonuçları, rotanın belirli bir "adımının" mesafesini belirtmek için kullanıcıya gösterilebilecek mesafe alanlarında metin içerir. Varsayılan olarak bu metinde, başlangıç noktasının bulunduğu ülke veya bölgenin birim sistemi kullanılır.

Örneğin, "Chicago, IL" ile "Toronto, ONT" arasındaki bir rotada sonuçlar mil cinsinden gösterilirken tersi rotada sonuçlar kilometre cinsinden gösterilir. İsteğin units parametresinde açıkça bir birim sistemi ayarlayarak ve aşağıdaki değerlerden birini ileterek bu birim sistemini geçersiz kılabilirsiniz:

  • metric, metrik sistemin kullanımını belirtir. Metin biçimindeki mesafeler, kilometre ve metre cinsinden döndürülür.
  • imperial, İngiliz ölçü sisteminin kullanımını belirtir. Metin tabanlı mesafeler mil ve fit cinsinden döndürülür.
Not: Bu birim sistemi ayarı yalnızca mesafe alanlarında gösterilen metni etkiler. Mesafe alanları da her zaman metre cinsinden ifade edilen değerler içerir.

referans noktaları

Dikkat: 10'dan fazla (11 ile 25 arasında) ara nokta veya ara nokta optimizasyonu kullanan istekler daha yüksek bir ücretle faturalandırılır. Google Haritalar Platformu ürünleri için faturalandırma hakkında daha fazla bilgi edinin.

Başlangıç ve varış noktaları arasındaki rotaya dahil edilecek ara konumlar dizisini geçiş veya mola konumları olarak belirtir. Ara noktalar, rotayı belirtilen konumlardan geçirerek değiştirir. API; sürüş, yaya ve bisiklet seyahat modları için ara noktaları destekler. Toplu taşıma için desteklemez. Yer kimliği, adres veya enlem/boylam koordinatları biçiminde, düşey çubuk karakteriyle (| veya %7C) ayrılmış bir veya daha fazla konum sağlayabilirsiniz. Varsayılan olarak Directions hizmeti, rotayı hesaplarken ara noktaları belirtilen sırayla kullanır. Ara nokta değerini ayrıştırma önceliği yer kimliği, enlem/boylam koordinatları ve ardından adrestir.

  • Bir yer kimliği iletirseniz önüne place_id: eklemeniz gerekir. Yer kimliklerini Geocoding API ve Places API'den (Yer Adı Otomatik Tamamlama dahil) alabilirsiniz. Yer Adı Otomatik Tamamlama'dan alınan yer kimliklerinin kullanıldığı bir örnek için Yer Adı Otomatik Tamamlama ve Yol Tarifi başlıklı makaleyi inceleyin. Yer kimlikleri hakkında daha fazla bilgi için Yer kimliğine genel bakış başlıklı makaleyi inceleyin.
    Verimlilik ve doğruluk için mümkün olduğunda yer kimliklerini kullanın. Bu kimlikler, enlem/boylam değer çifti gibi benzersiz bir şekilde açıktır ve erişim noktaları ile trafik değişkenleri gibi rotalama için coğrafi kodlama avantajları sağlar. Adreslerin aksine kimlikler, hizmetin arama yapmasını veya yer ayrıntıları için ara istek göndermesini gerektirmez. Bu nedenle performans daha iyidir.
  • Enlem/boylam koordinatlarını iletirseniz değerler, coğrafi kodlama olmadan yol tariflerini hesaplamak için doğrudan ön uç sunucusuna gider. Noktalar yollara sabitlenir ve uygulamanızın ihtiyaç duyduğu doğruluğu sağlamayabilir. Olası erişim noktaları veya ek coğrafi kodlama ayrıntıları dikkate alınmadan, değerlerin uygulamanızın rota oluşturma için ihtiyaç duyduğu noktaları gerçekten belirttiğinden emin olduğunuzda koordinatları kullanın. Enlem ve boylam değerlerini ayırmak için boşluk (%20) değil, virgül (%2C) kullanıldığından emin olun.
  • Bir adres iletirseniz Directions hizmeti, dizeyi coğrafi olarak kodlar ve yol tariflerini hesaplamak için enlem/boylam koordinatlarına dönüştürür. Adres değeri belirsizse değer, benzer adreslerden ayırt etmek için bir aramayı tetikleyebilir. Örneğin, "1. Cadde" tam bir değer veya "1. Cadde KB" ya da "1. Cadde GD" için kısmi bir değer olabilir. Bu sonuç, Geocoding API tarafından döndürülen sonuçtan farklı olabilir. Yer kimliklerini kullanarak olası yanlış yorumlamaları önleyebilirsiniz.
  • Alternatif olarak, Kodlanmış Çoklu Çizgi Algoritması'nı kullanarak kodlanmış bir nokta grubu sağlayabilirsiniz. URL çok daha kısa olduğundan, kodlanmış bir kümenin çok sayıda yol noktası için yararlı olduğunu göreceksiniz. Tüm web hizmetlerinde 16.384 karakterlik bir URL sınırı vardır.
    • Kodlanmış çoklu çizgilerin önüne enc: eklenmeli ve ardından iki nokta üst üste (:) gelmelidir. Örneğin: waypoints=enc:gfo}EtohhU:.
    • Dikey çizgi karakteriyle (|) ayrılmış birden fazla kodlanmış çoklu çizgi de ekleyebilirsiniz. Örneğin, waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

Mola ve geçiş noktalarıyla rotaları etkileme

Yol tarifi yanıtı, istekteki her ara nokta için legs dizisine bir giriş ekleyerek yolculuğun o ayağındaki duraklarla ilgili ayrıntıları sağlar.

Mola eklemeden ara noktaları kullanarak rotayı etkilemek istiyorsanız ara noktaya via: ön ekini ekleyin. via: ön ekiyle başlayan ara noktalar, legs dizisine bir giriş eklemez ancak yolculuğu ara noktadan geçirir.

Aşağıdaki URL, önceki isteği değiştirerek yolculuğun durmadan Lexington üzerinden yönlendirilmesini sağlar: 

https://maps.googleapis.com/maps/api/directions/json?
origin=Boston,MA&destination=Concord,MA
&waypoints=Charlestown,MA|via:Lexington,MA

via: ön eki, kullanıcının haritadaki ara noktaları sürüklemesine yanıt olarak rota oluştururken en etkili yöntemdir. Bu sayede kullanıcı, nihai rotanın gerçek zamanlı olarak nasıl görünebileceğini görebilir ve ara noktaların Directions API tarafından erişilebilen konumlara yerleştirilmesini sağlayabilir.

Dikkat: Ara noktaları önlemek için via: ön ekini kullanmak, ara noktayı yorumlamada katı olan yol tarifleriyle sonuçlanır. Bu yorum, rotada ciddi sapmalara veya Directions API bu noktadan yol tarifi oluşturamazsa yanıt durum kodunda ZERO_RESULTS hatasına neden olabilir.

Yol noktalarınızı optimize etme

Varsayılan olarak, Directions hizmeti, sağlanan yol noktaları üzerinden verilen sırayla bir rota hesaplar. İsteğe bağlı olarak, yol noktaları parametresindeki ilk bağımsız değişken olarak optimize:true değerini ileterek Yol Tarifi hizmetinin, yol noktalarını daha verimli bir sırada yeniden düzenleyerek sağlanan rotayı optimize etmesine izin verebilirsiniz. (Bu optimizasyon, gezgin satıcı probleminin bir uygulamasıdır.) Seyahat süresi, optimize edilen birincil faktördür ancak en verimli rotanın hangisi olduğuna karar verilirken mesafe, dönüş sayısı ve daha birçok faktör de dikkate alınabilir. Yol tarifi hizmetinin rotayı optimize edebilmesi için tüm ara noktaların mola yeri olması gerekir.

Yol tarifi hizmetine, ara noktalarının sırasını optimize etmesi talimatını verirseniz sıraları, rotalar nesnesindeki waypoint_order alanında döndürülür. waypoint_order alanı, sıfır tabanlı değerler döndürür.

Aşağıdaki örnekte, rota optimizasyonu kullanılarak Adelaide, Güney Avustralya'dan Güney Avustralya'nın ana şarap bölgelerinin her birine giden bir kara yolu yolculuğu hesaplanmaktadır. 

https://maps.googleapis.com/maps/api/directions/json?
origin=Adelaide,SA&destination=Adelaide,SA
&waypoints=optimize:true|Barossa+Valley,SA|Clare,SA|Connawarra,SA|McLaren+Vale,SA

Hesaplanan rotanın incelenmesi, hesaplamada aşağıdaki ara nokta sırasına göre ara noktaların kullanıldığını gösterir: 

"waypoint_order": [ 3, 2, 0, 1 ]
Dikkat: Ara nokta optimizasyonu kullanan istekler daha yüksek bir ücretle faturalandırılır. Google Haritalar Platformu ürünlerinin nasıl faturalandırıldığı hakkında daha fazla bilgi edinin.

Sırada ne var?

Yol tarifi örnekleri

Yol tarifi yanıtları