Yol tarifi örnekleri

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.

Örnek istekler

Aşağıdaki istek, Toronto, Ontario'dan Montreal, Quebec'e arabayla yol tarifi döndürür.

URL

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

mode ve avoid parametrelerini değiştirerek ilk isteği, otoyollardan kaçınan manzaralı bir bisiklet yolculuğu için yol tarifi döndürecek şekilde değiştirebilirsiniz.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

Aşağıdaki istek, Brooklyn, New York'tan Queens, New York'a toplu taşıma yol tarifini arar. İstekte departure_time belirtilmediği için kalkış saati varsayılan olarak geçerli saat olur:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

Aşağıdaki toplu taşıma isteği belirli bir kalkış saati içeriyor.

Not: Bu örnekte kalkış saati 30 Temmuz 2012, 09:45 olarak belirtilmiştir. Hata oluşmasını önlemek için isteği göndermeden önce parametreyi gelecekteki bir zamana değiştirmeniz gerekir.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

Aşağıdaki istek, Kolkata, Hindistan'da H8MW+WP'den GCG2+3M'ye arabayla yol tarifi döndürmek için Plus Code'ları kullanır.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

Aşağıdaki istek, yer kimliklerini kullanarak Glasgow, Birleşik Krallık'tan Perth, Birleşik Krallık'a arabayla yol tarifini döndürür.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

Seyahat modları

Yol tariflerini hesaplarken kullanılacak ulaşım mode belirtebilirsiniz. Varsayılan olarak, yol tarifleri driving yol tarifleri olarak hesaplanır. Aşağıdaki seyahat modları desteklenir:

  • driving (varsayılan), yol ağını kullanan standart arabayla yol tarifini gösterir.
  • walking, yaya yolları ve kaldırımlar (varsa) üzerinden yaya yol tarifi ister.
  • bicycling, bisiklet yolları ve tercih edilen sokaklar (varsa) üzerinden bisiklet için yol tarifi ister.
  • transit kullanıcı, toplu taşıma rotaları üzerinden yol tarifi istedi (kullanılabildiği yerlerde). Modu transit 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 bir transit_mode ve/veya transit_routing_preference da ekleyebilirsiniz.

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 warnings döndürür.

Trafik bilgileri

Trafik bilgileri, aşağıdaki koşulların tümü geçerli olduğunda kullanılır (bunlar, Directions yanıtında duration_in_traffic alanını almak için gereken koşullardır):

  • travel mode parametresi driving ise veya belirtilmemişse (driving varsayılan seyahat modudur).
  • İstek, geçerli bir departure_time parametresi içeriyor. departure_time, geçerli zamana veya gelecekteki bir zamana ayarlanabilir. Geçmişte olamaz.
  • İstek, mola ara noktaları içermez. İstek, ara noktalar içeriyorsa rotayı etkilemek ancak mola vermemek için her ara noktanın önüne via: ekleyin. Örneğin, 
    &waypoints=via:San Francisco|via:Mountain View|...

İsteğe bağlı olarak, trafikte geçen süreyi hesaplarken kullanılacak varsayımları belirtmek için isteğinize traffic_model parametresini ekleyebilirsiniz.

Aşağıdaki URL, Boston, MA'dan Concord, MA'ya Charlestown ve Lexington üzerinden yapılacak bir yolculuk için yol tarifi isteği başlatır. İstek, Yol Tarifi yanıtında duration_in_traffic alanını döndürmek için tüm şartları karşılayan bir kalkış saati içerir.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

Referans Noktaları

Directions API (Eski) kullanarak rotaları hesaplarken ara konumlarda geçişler veya mola yerleri içeren bir rota döndürmek için ara noktalar belirtebilirsiniz. Arabayla, yürüyerek veya bisiklet için yol tariflerine ara nokta ekleyebilirsiniz ancak toplu taşıma yol tariflerine ekleyemezsiniz.

waypoints parametresinde konumları belirtin.

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ı verilen 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 bir arama veya yer ayrıntıları için ara istek gerçekleştirmesini 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. Değerlerin, olası erişim noktaları veya ek coğrafi kodlama ayrıntıları dikkate alınmadan 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 Yol Tarifi 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. Rota isteğimin sonuçlarıyla ilgili sorunları giderme başlıklı makaleyi inceleyin.

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:

Aşağıdaki URL, Boston, MA ile Concord, MA arasında, sırasıyla Charlestown ve Lexington'da mola verilen bir yolculuk için yol tarifi isteği başlatır. Örnekte şu adresler kullanılmıştır:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

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 legs dizisine bir giriş ekler.

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 Lexington üzerinden durmadan yönlendirilmesini sağlar:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

via: ön eki, kullanıcının haritadaki yol noktalarını 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 (Eski) tarafından erişilebilen konumlara yerleştirilmesini sağlayabilir.

Aşağıdaki URL, enlem/boylam koordinatlarını kullanarak ara nokta ister:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

Aynı isteğin kodlanmış bir çoklu çizgi kullanan hali aşağıda verilmiştir:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

via: belirleyicisini konum değiştiricilerle dilediğiniz gibi karıştırabileceğinizi unutmayın. Örneğin:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

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 Tarifi hizmetinin, ara noktaları daha verimli bir sırada yeniden düzenleyerek sağlanan rotayı optimize etmesine izin vermek için waypoints parametresinde ilk bağımsız değişken olarak optimize:true değerini iletebilirsiniz. (Bu optimizasyon, gezgin satıcı problemi'nin 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. Directions hizmetinin rotayı optimize edebilmesi için tüm ara noktaların mola yeri olması gerekir.

Directions hizmetine, ara noktalarının sırasını optimize etmesi talimatını verirseniz bu noktaların sırası, routes 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.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

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

"waypoint_order": [ 3, 2, 0, 1 ]

Kısıtlamalar

Yol tarifleri, belirli kısıtlamalara uyacak şekilde hesaplanabilir. Kısıtlamalar, avoid parametresi ve bu parametre için kaçınılması gereken kısıtlamayı belirten bir bağımsız değişken kullanılarak belirtilir. Aşağıdaki kısıtlamalar desteklenir:

  • avoid=tolls
  • avoid=highways
  • avoid=ferries

Avoid parametresine her iki kısıtlamayı da ileterek ücretli geçiş, otoyol ve feribot kombinasyonlarından kaçınan bir rota isteyebilirsiniz. Örneğin: avoid=tolls|highways|ferries.

Not: Kısıtlama eklenmesi, kısıtlanmış özelliği içeren rotaları engellemez. Sonucu daha uygun rotalara yönlendirir.

Birim sistemleri

Yol tarifi sonuçları, rotanın belirli bir "adımının" mesafesini belirtmek için kullanıcıya gösterilebilecek distance alanlarında text içerir. 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ıldığını belirtir. Metin tabanlı mesafeler mil ve fit cinsinden döndürülür.

Not: Bu birim sistemi ayarı yalnızca distance alanlarında gösterilen text değerini etkiler. distance alanları, her zaman metre cinsinden ifade edilen values değerlerini de içerir.

Bölgeye göre yönlendirme

region parametresini kullanarak Yol Tarifi hizmetini belirli bir bölgeden sonuç döndürecek şekilde ayarlayabilirsiniz. Bu parametre, bölge yanlılığını belirten iki karakterli bir ccTLD (ülke kodu üst düzey alanı) bağımsız değişkeni alır. Çoğu ccTLD kodu, ISO 3166-1 alfa-2 kodlarıyla aynıdır ancak bazı önemli istisnalar vardı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). Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın.

Ana Google Haritalar uygulamasının arabayla yol tarifini kullanıma sunduğu tüm alan adlarını kullanabilirsiniz.

Örneğin, region parametresi es olarak ayarlandığında "Toledo"dan "Madrid"e yol tarifi isteği uygun sonuçlar döndürür ve "Toledo" İspanya'daki şehir olarak yorumlanır:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

"Toledo"dan "Madrid"e yol tarifi isteği region parametresi olmadan gönderildiğinde sonuç döndürmez. Bunun nedeni, "Toledo"nun İspanya'daki değil, Ohio'daki şehir olarak yorumlanmasıdır:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Konum Değiştiriciler

Sürücülerin belirli bir konuma nasıl yaklaşması gerektiğini belirtmek için konum değiştiricileri kullanabilirsiniz. Bunun için side_of_road parametresini kullanarak yolun hangi tarafının kullanılacağını belirtebilir veya doğru seyahat yönünü belirtmek için bir başlık belirleyebilirsiniz. Bu değiştiriciler, ara noktalar için via: değiştiricisiyle serbestçe karıştırılabilir.

Rotaların yolun belirli bir tarafından geçmesi gerektiğini belirtme

Bir ara nokta belirtirken side_of_road: ön ekini kullanarak rotanın, ara noktanın eğilimli olduğu yolun hangi tarafında ilerleyeceğini isteyebilirsiniz. Örneğin, bu yol tarifi isteği, aracın ara noktanın eğimli olduğu yolun tarafında bitmesi için uzun bir rota döndürür:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

side_of_road:, kodlanmış çoklu çizgilerle kullanıldığında parametre, çoklu çizgi boyunca her konuma uygulanır.

side_of_road: değiştiricisi yalnızca aşağıdaki kısıtlamalarla kullanılabilir:

  • travel mode parametresi driving olarak ayarlanmış veya belirtilmemiş (driving varsayılan seyahat modudur).

Rotaların belirli bir yöne sahip olması gerektiğini belirtme

Bir ara nokta belirtirken rotanın ara noktadan belirli bir yönde geçmesini isteyebilirsiniz. Bu yön, heading=X: önekiyle belirtilir. Burada X, 0 (dahil) ile 360 (hariç) arasında bir tam sayı derece değeridir. 0 yönü kuzeyi, 90 yönü doğuyu gösterir ve saat yönünde devam eder. Örneğin, bu yol tarifi isteğinde rota, başlangıç noktasından doğuya doğru gider ve ardından U dönüşü yapar:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

heading=X: değiştiricisi yalnızca aşağıdaki kısıtlamalarla kullanılabilir:

  • Seyahat mode parametresi driving, bicycling veya belirtilmemiş (driving varsayılan seyahat modudur).
  • side_of_road değiştiricisi aynı konum için belirtilmemiş.
  • Konum, enlem/boylam değeriyle belirtilir. heading adresler, yer kimlikleri veya kodlanmış çoklu çizgilerle kullanılamaz.