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 yön hesaplamaları için (örneğin, bir kullanıcı arayüzü öğesinde) Directions API'yi (Eski) veya Maps JavaScript API'yi kullanıyorsanız Directions Service'i 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ışı gösterir.xml, çıkışın XML biçiminde olduğunu gösterir.
Not: URL'lerin geçerli olması için doğru ş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 kimlikleri
place_id:ile başlamalıdır. Geocoding API ve Places API'den (Yer Adı Otomatik Tamamlama dahil) yer kimliklerini 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.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. binanın merkezi yerine girişi).
origin=24+Sussex+Drive+Ottawa+ONAdres veya enlem/boylam koordinatları yerine yer kimliklerinin kullanılması 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 kaçış karakteriyle
%2B, boşluklar ise URL kaçış karakteriyle%20olarak değiştirilir).-
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).
-
Global kod, 4 karakterlik bir alan kodu ve 6 karakter veya daha uzun bir yerel koddur (849VCWC8+R9,
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
trueolarak ayarlanırsa Directions hizmetinin yanıtta birden fazla rota alternatifi sunabileceğini belirtir. Alternatif rotalar sunmanın sunucudan yanıt 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_timeveyaarrival_timedeğerlerinden birini belirtebilirsiniz ancak ikisini birden belirtemezsiniz.arrival_timedeğ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_timebelirtilirse API,departure_timedeğ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_timeveyaarrival_timedeğerlerinden birini belirtebilirsiniz. Hiçbir zaman belirtilmezsedeparture_timevarsayı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_timedeğerini belirtebilirsiniz.departure_time, geçerli saate 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=drivingolduğundadeparture_timebelirten 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ı belirlenir. -
Seyahat modunun toplu taşıma olduğu istekler için: İsteğe bağlı olarak
-
language
Sonuçların döndürüleceği dil. Bu durumun yalnızca
start_addressveend_addressalanlarındaki coğrafi kodlu adresler,distancevedurationalanlarındaki (bacaklar ve adımlarda) yerelleştirilmiş metinler vehtml_instructionsalanındaki manevra açıklamaları için geçerli olduğunu unutmayın.html_instructionsalanı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.
-
languagesağlanmazsa API,Accept-Languagebaş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 açık adresleri yerel dilde döndürür ve gerekirse tercih edilen dili dikkate alarak kullanıcı tarafından okunabilir 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 buna dahildir. Örneğin, Macarcada utca ve tér kelimeleri "sokak" anlamına gelir.
-
mod
Mesafelerin ve yol tariflerinin hesaplanması için kullanılacak ulaşım modunu belirtebilirsiniz. Varsayılan olarak
drivingmodu 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ı kullanan mesafeyi belirtir. -
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 ister. -
transit, toplu taşıma rotalarını kullanarak yol tarifi veya mesafe bilgisi ister (mümkün olduğunda). Modu toplu taşıma olarak ayarlarsanız isteğe bağlı olarakdeparture_timeveyaarrival_timebelirtebilirsiniz. Hiçbir zaman belirtilmezsedeparture_timevarsayılan olarak geçerli zamana ayarlanır (yani kalkış saati varsayılan olarak geçerli saate ayarlanır). İsteğe bağlı olarak birtransit_modeve/veyatransit_routing_preferenceda 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 en fazla 7 gün veya gelecekte en fazla 100 gün için 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 tarifleri 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_modelparametresi yalnızca isteğindeparture_timeiç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 gösterir. 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_guessvarsayılan değeri, kullanım alanlarının büyük çoğunluğu için en faydalı tahminleri sağlar.best_guesstahmin modelinin canlı trafik bilgilerini entegre etme şekli nedeniylebest_guessseyahat süresi tahminioptimisticsüresinden daha kısa veyapessimisticsüresinden 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 rotada tren, tramvay, hafif raylı sistem ve metro ile seyahatin tercih edilmesi gerektiğini belirtir. Bu,transit_mode=train|tram|subwaydeğ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üşün 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ı, mesafe alanlarında kullanıcıya gösterilebilecek metinler içerir. Bu metinler, rotanın belirli bir "adımının" mesafesini gösterir. Bu metinde varsayılan olarak 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 rota için sonuçlar mil cinsinden gösterilirken tersi rota için 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ın dizisini geçiş veya mola konumları olarak belirtir. Ara noktalar, rotayı belirtilen konumlardan geçirerek değiştirir. API, şu seyahat modları için ara noktaları destekler: sürüş, yürüme ve bisiklet; toplu taşıma desteklenmez. 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ı verildikleri 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:
-
Kodlanmış çoklu çizgilerin önüne
Mola ve geçiş noktalarıyla rotaları etkileme
İstekteki her ara nokta için yol tarifi yanıtı, yolculuğun o ayağındaki mola yerlerinin ayrıntılarını sağlamak üzere
legsdizisine bir giriş ekler.Mola yeri eklemeden ara noktaları kullanarak rotayı etkilemek istiyorsanız ara noktaya
via:ön ekini ekleyin.via:ön ekine sahip ara noktalar,legsdizisine giriş eklemez ancak yolculuğu ara noktadan yönlendirir.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,MAvia:ö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ı, son rotanın gerçek zamanlı olarak nasıl görünebileceğini görebilir ve ara noktaların Directions API'nin erişebileceği konumlara yerleştirilmesini sağlayabilir.Dikkat: Ara noktaları önlemek içinvia:ön ekini kullanmak, ara noktayı yorumlama konusunda katı olan yol tarifleriyle sonuçlanır. Bu yorum, Directions API bu noktadan yol tarifi oluşturamazsa rotada ciddi sapmalara veya yanıt durum kodundaZERO_RESULTShatasına neden olabilir.Ara 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 Tarifi hizmetinin sağlanan rotayı daha verimli bir sırada yeniden düzenleyerek optimize etmesine olanak tanımak için ara noktalar parametresinin ilk bağımsız değişkeni olarak
optimize:truedeğerini iletebilirsiniz. (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_orderalanında döndürülür.waypoint_orderalanı, 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,SAHesaplanan 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: Yol noktası 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. -
Bir yer kimliği iletirseniz önüne
Sırada ne var?
Yol tarifi örnekleri
- Seyahat modları
- Trafik bilgileri
- Ara noktalar ve ara nokta optimizasyonu
- Rota kısıtlamaları
- Birim sistemleri
- Bölgeye göre yönlendirme
- Konum değiştiriciler
Yol tarifi yanıtları
- DirectionsResponse
- DirectionsRoute
- DirectionsLeg
- DirectionsStep ve DirectionsPolyline
- DirectionsTransitDetails
- DirectionsStatus
- DirectionsGeocodedWaypoint