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çin.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Yol tarifi örnekleri

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

Ö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, ana 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şmaması 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, Hindistan'ın Kalküta şehrinde H8MW+WP ile GCG2+3M arasındaki arabayla yol tarifini 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 tarifi 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 kişi 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 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 warnings değerini 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):

Seyahat mode parametresi driving veya belirtilmemiş (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'yi (Eski) kullanarak rota hesaplarken ara konumlardan geçişleri veya ara konumlarda duraklamaları 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. 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.
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 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. 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ğerlerinin boşlukla (%20) değil, virgülle (%2C) ayrı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 giriş eklemez ancak yolculuğu ara nokta üzerinden yönlendirir.

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ı, nihai 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.

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

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'

Aşağıda, kodlanmış bir çoklu çizgi kullanan aynı istek gösterilmektedir:

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'

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, 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 isteğinde bulunabilirsiniz. Örneğin: avoid=tolls|highways|ferries.

Not: Kısıtlamaların 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. Varsayılan olarak bu metinde, çıkış 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 ağırlıklandırma

region parametresini kullanarak Directions Service'i belirli bir bölgeden sonuç döndürecek şekilde ayarlayabilirsiniz. Bu parametre, bölge tercihini belirten iki karakterli bir ccTLD (ülke kodu üst düzey alanı) bağımsız değişkeni alır. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 alfa-2 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). 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, "Toledo"dan "Madrid"e yol tarifi isteği, region es olarak ayarlandığında 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 belirtebilirsiniz. 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ından geçeceğini isteyebilirsiniz. Örneğin, bu yol tarifi isteği, aracın ara noktanın eğimli olduğu yolun kenarı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:

Seyahat mode parametresi driving veya belirtilmemiş (driving varsayılan seyahat modudur).

Rotaların belirli bir başlığa 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ştirici aynı konum için belirtilmemiş.
Konum, enlem/boylam değeriyle belirtilir. heading adresler, yer kimlikleri veya kodlanmış çoklu çizgilerle kullanılamaz.

Yol tarifi örnekleri Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Örnek istekler

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

Seyahat modları

Trafik bilgileri

URL

curl

Referans Noktaları

waypoints parametresinde konumları belirtin.

URL

curl

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

URL

curl

URL

curl

URL

curl

URL

curl

Ara noktalarınızı optimize etme

URL

curl

Kısıtlamalar

Birim sistemleri

Bölgeye göre ağırlıklandırma

URL

curl

JSON

XML

URL

curl

JSON

XML

Konum Değiştiriciler

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

URL

curl

Rotaların belirli bir başlığa sahip olması gerektiğini belirtme

URL

curl

Yol tarifi örnekleri

`waypoints` parametresinde konumları belirtin.