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 yanıtları

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

Örnek yanıtlar

Yol tarifi yanıtları, URL istek yolundaki output işaretiyle belirtilen biçimde döndürülür.

Aşağıda, Chicago, Illinois'den Los Angeles, Kaliforniya'ya Joplin, Missouri ve Oklahoma City, Oklahoma'daki iki ara nokta üzerinden rotayı hesaplayan örnek bir HTTP isteği gösterilmektedir.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

Yukarıdaki örnekte JSON çıkışı istenmektedir. XML çıkışı istemek de mümkündür. Örnek JSON ve XML yanıtlarını görmek için aşağıdaki sekmeleri seçin.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Bu dokümanın geri kalanında JSON söz dizimi kullanılacaktır. Çoğu durumda, dokümanlardaki kavramları veya alan adlarını göstermek için çıkış biçimi önemli değildir. Ancak aşağıdaki küçük farklara dikkat edin:

XML sonuçları, kök <DirectionsResponse> öğesiyle sarmalanır.
JSON, birden fazla öğe içeren girişleri çoğul dizilerle (ör. steps ve legs) belirtirken XML, bunları birden fazla tekil öğe (ör. <step> ve <leg>) kullanarak belirtir.
JSON, ara nokta sırasını waypoint_order alanı aracılığıyla belirtirken XML, bunları ayrı <waypoint_index> öğeleri kullanarak belirtir.
Boş öğeler, JSON'da boş dizilerle, XML'de ise bu tür öğelerin bulunmamasıyla belirtilir. Örneğin, sonuç üretmeyen bir yanıt, JSON'da boş bir routes dizisi döndürür ancak XML'de <route> öğesi döndürmez.

DirectionsResponse

Alan	Zorunlu	Tür	Açıklama
`routes`	required	Array<DirectionsRoute>	Başlangıç noktasından varış noktasına giden rotaların dizisini içerir. Rotalar, iç içe yerleştirilmiş kısımlardan ve adımlardan oluşur. Daha fazla bilgi için DirectionsRoute sayfasına bakın.
`status`	required	DirectionsStatus	İsteğin durumunu içerir ve isteğin neden başarısız olduğunu bulmanıza yardımcı olacak hata ayıklama bilgilerini içerebilir. Daha fazla bilgi için DirectionsStatus sayfasına bakın.
`available_travel_modes`	isteğe bağlı	Array<TravelMode>	Kullanılabilir seyahat modlarının dizisini içerir. Bu alan, bir istekte seyahat modu belirtildiğinde ve sonuç alınmadığında döndürülür. Dizi, belirli bir yol noktası grubunun ülkelerinde kullanılabilen seyahat modlarını içerir. Yol noktalarından biri veya daha fazlası "ara yol noktası" ise bu alan döndürülmez. Daha fazla bilgi için TravelMode sayfasına bakın.
`error_message`	isteğe bağlı	dize	Hizmet, `OK` dışında bir durum kodu döndürdüğünde yanıt nesnesinde ek bir `error_message` alanı olabilir. Bu alan, verilen durum kodunun nedenleri hakkında daha ayrıntılı bilgi içerir. Bu alan her zaman döndürülmez ve içeriği değişebilir.
`geocoded_waypoints`	isteğe bağlı	Dizi<DirectionsGeocodedWaypoint>	Başlangıç, varış ve ara noktaların coğrafi kodlamasıyla ilgili ayrıntıları içeren bir dizi içerir. geocoded_waypoints dizisindeki öğeler, sıfır tabanlı konumlarına göre başlangıç noktasına, belirtildikleri sırayla ara noktalara ve varış noktasına karşılık gelir. Hizmet herhangi bir sonuç döndürmezse metin biçiminde enlem/boylam değerleri olarak belirtilen ara noktalar için bu ayrıntılar gösterilmez. Bunun nedeni, bu tür ara noktaların yalnızca bir rota bulunduktan sonra temsilci adreslerini elde etmek için tersine coğrafi kodlanmasıdır. Boş bir JSON nesnesi, geocoded_waypoints dizisindeki ilgili yerleri kaplar. Daha fazla bilgi için DirectionsGeocodedWaypoint sayfasını inceleyin.

DirectionsRoute

Rotalar, iç içe yerleştirilmiş legs ve steps öğelerinden oluşur.

Alan	Zorunlu	Tür	Açıklama
`bounds`	required	Sınırlar	`overview_polyline` öğesinin görüntü alanı sınırlayıcı kutusunu içerir. Daha fazla bilgi için Sınırlar bölümüne bakın.
`copyrights`	required	dize	Bu rota için gösterilecek telif hakkı bildirimlerini içerir. Bu bilgileri kendiniz işlemeli ve göstermelisiniz. Bu içerik olduğu gibi okunmalıdır. Yalnızca görüntüleme amaçlı bu içeriği programatik olarak ayrıştırmayın.
`legs`	required	Dizi<DirectionsLeg>	Belirli bir rota içindeki iki konum arasında, rotanın bir ayağı hakkında bilgi içeren bir dizi. Belirtilen her ara nokta veya hedef için ayrı bir ayak bulunur. (Ara nokta içermeyen bir rota, bacaklar dizisinde tam olarak bir bacak içerir.) Her ayak bir dizi adımdan oluşur. Daha fazla bilgi için DirectionsLeg bölümüne bakın.
`overview_polyline`	required	DirectionsPolyline	Rotanın kodlanmış çoklu çizgi temsilini içeren bir nesne içerir. Bu çoklu çizgi, elde edilen yol tarifinin yaklaşık (düzeltilmiş) yoludur. Daha fazla bilgi için DirectionsPolyline sayfasına bakın.
`summary`	required	dize	Rotanın kısa bir metin açıklamasını içerir. Bu açıklama, rotayı adlandırmak ve alternatiflerden ayırt etmek için uygundur.
`warnings`	required	Dizi<string>	Bu yol tarifleri gösterilirken görüntülenecek uyarıların dizisini içerir. Bu uyarıları kendiniz yönetmeniz ve göstermeniz gerekir.
`waypoint_order`	required	Dizi<integer>	Hesaplanan rotadaki tüm ara noktaların sırasını gösteren bir dizi. İstek, ara noktalar parametresinde optimize:true olarak iletildiyse bu ara noktalar yeniden sıralanabilir.
`fare`	isteğe bağlı	Ücret	Mevcutsa bu rotadaki toplam ücreti (yani toplam bilet maliyetlerini) içerir. Bu özellik yalnızca toplu taşıma istekleri ve tüm toplu taşıma ayakları için ücret bilgilerinin mevcut olduğu rotalar için döndürülür. Daha fazla bilgi için Fare bölümüne bakın.

Sınırlar

Güneybatı ve kuzeydoğu köşelerindeki noktalardan coğrafi koordinatlarda bir dikdörtgen.

Alan	Zorunlu	Tür	Açıklama
`northeast`	required	LatLngLiteral	Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`southwest`	required	LatLngLiteral	Daha fazla bilgi için LatLngLiteral sayfasına bakın.

LatLngLiteral

Ondalık derece cinsinden enlem ve boylam ile belirli bir konumu açıklayan nesne.

Alan	Zorunlu	Tür	Açıklama
`lat`	required	sayı	Ondalık derece cinsinden enlem
`lng`	required	sayı	Ondalık derece cinsinden boylam

DirectionsLeg

Alan	Zorunlu	Tür	Açıklama
`end_address`	required	dize	Bu ayağın `end_location` değerinin tersine coğrafi kodlamasından elde edilen, kullanıcıların okuyabileceği adresi (genellikle açık adres) içerir. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın.
`end_location`	required	LatLngLiteral	Bu ayağın belirtilen varış noktasının enlem/boylam koordinatları. Directions API, başlangıç ve bitiş noktalarında en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak konumlar arasındaki yol tariflerini hesapladığından, örneğin varış noktasının yakınında bir yol yoksa `end_location`, bu ayağın sağlanan varış noktasından farklı olabilir. Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`start_address`	required	dize	Bu ayağın `start_location` değerinin tersine coğrafi kodlanmasıyla elde edilen, kullanıcıların okuyabileceği adresi (genellikle açık adres) içerir. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın.
`start_location`	required	LatLngLiteral	Bu ayağın başlangıç noktasının enlem/boylam koordinatları. Directions API, başlangıç ve bitiş noktalarında en yakın ulaşım seçeneğini (genellikle bir yol) kullanarak konumlar arasındaki rotayı hesapladığından, örneğin başlangıç noktasının yakınında bir yol yoksa `start_location`, bu ayağın sağlanan başlangıç noktasından farklı olabilir. Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`steps`	required	Array<DirectionsStep>	Yolculuk ayağının her bir ayrı adımıyla ilgili bilgileri gösteren bir adım dizisi. Daha fazla bilgi için DirectionsStep sayfasına bakın.
`traffic_speed_entry`	isteğe bağlı	Array<DirectionsTrafficSpeedEntry>	Desteği sonlandırıldı: Bu dizi her zaman boştur. Etap boyunca trafik hızıyla ilgili bilgiler. Daha fazla bilgi için DirectionsTrafficSpeedEntry sayfasını inceleyin.
`via_waypoint`	required	Dizi<DirectionsViaWaypoint>	Bu etap boyunca ara noktaların konumları. Daha fazla bilgi için DirectionsViaWaypoint sayfasına bakın.
`arrival_time`	isteğe bağlı	TimeZoneTextValueObject	Bu ayağın tahmini varış zamanını içerir. Bu özellik yalnızca toplu taşıma yol tarifleri için döndürülür. Daha fazla bilgi için TimeZoneTextValueObject bölümüne bakın.
`departure_time`	isteğe bağlı	TimeZoneTextValueObject	Bu ayağın tahmini kalkış saatini içerir ve Time nesnesi olarak belirtilir. `departure_time` yalnızca toplu taşıma yol tarifleri için kullanılabilir. Daha fazla bilgi için TimeZoneTextValueObject bölümüne bakın.
`distance`	isteğe bağlı	TextValueObject	Bu ayağın kapsadığı toplam mesafe. Daha fazla bilgi için TextValueObject bölümünü inceleyin.
`duration`	isteğe bağlı	TextValueObject	Bu ayağın toplam süresi. Daha fazla bilgi için TextValueObject bölümünü inceleyin.
`duration_in_traffic`	isteğe bağlı	TextValueObject	Bu ayağın toplam süresini gösterir. Bu değer, mevcut ve geçmiş trafik koşullarına göre trafikte geçirilen sürenin tahminidir. Döndürülen değerin iyimser, kötümser veya en iyi tahmin olmasını istemek için kullanabileceğiniz seçenekler hakkında bilgi edinmek üzere `traffic_model` istek parametresini inceleyin. Trafikteki süre yalnızca aşağıdaki koşulların tümü karşılandığında döndürülür: İstek, mola noktaları içermez. İstek, ara noktalar içeriyorsa mola vermemek için bu ara noktaların önüne `via:` eklenmelidir. İstek özellikle arabayla yol tarifi için gönderilmiştir. Mod parametresi `driving` olarak ayarlanmıştır. İstek, `departure_time` parametresini içerir. İstenen rota için trafik koşulları bilgisi mevcut. Daha fazla bilgi için TextValueObject bölümünü inceleyin.

DirectionsStep

steps dizisindeki her öğe, hesaplanan yol tarifinin tek bir adımını tanımlar. Adım, bir yol tarifinin en küçük birimidir ve yolculukla ilgili belirli bir talimatı açıklayan tek bir adım içerir. Ör. "W. 'den sola dönün. 4th St." Adım, yalnızca talimatı açıklamakla kalmaz, aynı zamanda bu adımın bir sonraki adımla nasıl ilişkili olduğuna dair mesafe ve süre bilgilerini de içerir. Örneğin, "I-80 Batı'ya girin" olarak belirtilen bir adım, "37 mil" ve "40 dakika" süresini içerebilir. Bu, bir sonraki adımın bu adımdan 37 mil/40 dakika uzaklıkta olduğunu gösterir.

Toplu taşıma yol tariflerini aramak için Directions API'yi kullanırken steps dizisi, transit_details dizisi biçiminde ek toplu taşıma ayrıntıları içerir. Yol tarifi birden fazla ulaşım modu içeriyorsa yürüme veya sürüş adımları için ayrıntılı yol tarifi, iç adımlar dizisinde sağlanır. Örneğin, bir yürüme adımı, başlangıç ve bitiş konumlarından yol tariflerini içerir: "Innes Ave ve Fitch St'ye yürüyün". Bu adım, iç adımlar dizisinde ilgili rotanın ayrıntılı yaya yol tarifini içerir. Örneğin: "Kuzeybatı yönünde ilerleyin", "Sola dönüp Arelious Walker yönüne girin" ve "Sola dönüp Innes Ave yönüne girin".

Alan	Zorunlu	Tür	Açıklama
`duration`	required	TextValueObject	Adımın gerçekleştirilmesi için gereken normal süreyi (bir sonraki adıma kadar) içerir. Süre bilinmiyorsa bu alan tanımlanmamış olabilir. Daha fazla bilgi için TextValueObject bölümünü inceleyin.
`end_location`	required	LatLngLiteral	Bu adımın son noktasının konumunu içerir. Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`html_instructions`	required	dize	Bu adım için HTML metin dizesi olarak sunulan biçimlendirilmiş talimatlar içerir. Bu içerik, olduğu gibi okunmak üzere tasarlanmıştır. Yalnızca görüntüleme amaçlı bu içeriği programatik olarak ayrıştırmayın.
`polyline`	required	DirectionsPolyline	Adımın kodlanmış çoklu çizgi temsilini içeren tek bir nokta nesnesi içerir. Bu çoklu çizgi, adımın yaklaşık (düzleştirilmiş) yoludur. Daha fazla bilgi için DirectionsPolyline sayfasına bakın.
`start_location`	required	LatLngLiteral	Bu adımın başlangıç noktasının konumunu içerir. Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`travel_mode`	required	TravelMode	Kullanılan seyahat modu türünü içerir. Daha fazla bilgi için TravelMode sayfasına bakın.
`distance`	isteğe bağlı	TextValueObject	Bu adımın bir sonraki adıma kadar kapsadığı mesafeyi içerir. Mesafe bilinmiyorsa bu alan tanımlanmamış olabilir. Daha fazla bilgi için TextValueObject bölümünü inceleyin.
`maneuver`	isteğe bağlı	dize	Mevcut adımda yapılacak işlemi (sola dönün, katılın, düz devam edin vb.) içerir. Değerler değişebilir ve önceden bildirimde bulunulmadan yeni değerler eklenebilir. The allowed values include: `turn-slight-left`, `turn-sharp-left`, `turn-left`, `turn-slight-right`, `turn-sharp-right`, `keep-right`, `keep-left`, `uturn-left`, `uturn-right`, `turn-right`, `straight`, `ramp-left`, `ramp-right`, `merge`, `fork-left`, `fork-right`, `ferry`, `ferry-train`, `roundabout-left`, and `roundabout-right`
`steps`	isteğe bağlı		Toplu taşıma yol tariflerindeki yürüme veya sürüş adımları için ayrıntılı yol tarifleri içerir. Alt adımlar yalnızca travel_mode "transit" olarak ayarlandığında kullanılabilir. İç adımlar dizisi, adımlarla aynı türdedir.
`transit_details`	isteğe bağlı	DirectionsTransitDetails	Seyahat modu `transit` ise bu adımla ilgili ayrıntılar. Daha fazla bilgi için DirectionsTransitDetails sayfasına bakın.

TextValueObject

Sayısal bir değer ve bu değerin biçimlendirilmiş metin gösterimini içeren bir nesne.

Alan	Zorunlu	Tür	Açıklama
`text`	required	dize	Dize değeri.
`value`	required	sayı	Sayısal değer.

DirectionsPolyline

Çoklu çizgi kodlama, bir dizi koordinatı tek bir dize olarak depolamanıza olanak tanıyan kayıplı bir sıkıştırma algoritmasıdır. Nokta koordinatları, işaretli değerler kullanılarak kodlanır. Yalnızca birkaç statik noktanız varsa etkileşimli çoklu çizgi kodlama yardımcı programını da kullanabilirsiniz.

Kodlama işlemi, bilinen base64 kodlama şemasını kullanarak ikili değeri ASCII karakterleri için bir dizi karakter koduna dönüştürür: Bu karakterlerin düzgün şekilde gösterilmesini sağlamak için kodlanmış değerler ASCII'ye dönüştürülmeden önce 63 (ASCII karakteri "?") ile toplanır. Algoritma, her bayt grubunun en önemsiz bitini kontrol ederek belirli bir nokta için ek karakter kodlarını da kontrol eder. Bu bit 1 olarak ayarlanırsa nokta henüz tam olarak oluşturulmamıştır ve ek verilerin gelmesi gerekir.

Ayrıca, yerden tasarruf etmek için noktalar yalnızca önceki noktadan olan farkı içerir (ilk nokta hariç). Enlem ve boylamlar işaretli değerler olduğundan tüm noktalar Base64'te işaretli tam sayılar olarak kodlanır. Çoklu çizgi içindeki kodlama biçimi, enlem ve boylamı makul bir hassasiyetle temsil eden iki koordinatı temsil etmelidir. Maksimum boylamın +/- 180 derece ve 5 ondalık basamak hassasiyetinde (180,00000 ila -180,00000) olduğu varsayıldığında, 32 bit işaretli ikili tamsayı değeri gerekir.

Alan	Zorunlu	Tür	Açıklama
`points`	required	dize	Çoklu çizginin tek bir dize gösterimi.

TravelMode

DRIVING (varsayılan), hesaplamanın yol ağı kullanılarak yapıldığını gösterir.
BICYCLING, bisiklet yollarını ve tercih edilen sokakları (varsa) kullanarak bisikletle seyahat için hesaplama yapılmasını ister.
TRANSIT, toplu taşıma rotalarını (mümkünse) kullanarak hesaplama yapılmasını ister.
WALKING, yaya yolları ve kaldırımları (varsa) kullanarak yürüyüş için hesaplama yapılmasını ister.

DirectionsTransitDetails

Diğer ulaşım modlarıyla ilgili olmayan ek bilgiler.

Alan	Zorunlu	Tür	Açıklama
`arrival_stop`	isteğe bağlı	DirectionsTransitStop	Varış toplu taşıma durağı. Daha fazla bilgi için DirectionsTransitStop sayfasına bakın.
`arrival_time`	isteğe bağlı	TimeZoneTextValueObject	Daha fazla bilgi için TimeZoneTextValueObject bölümüne bakın.
`departure_stop`	isteğe bağlı	DirectionsTransitStop	Kalkış toplu taşıma durağı. Daha fazla bilgi için DirectionsTransitStop sayfasına bakın.
`departure_time`	isteğe bağlı	TimeZoneTextValueObject	Daha fazla bilgi için TimeZoneTextValueObject bölümüne bakın.
`headsign`	isteğe bağlı	dize	Araçta veya kalkış durağında işaretlendiği şekilde, bu hatta seyahat edilecek yönü belirtir. Bu genellikle son istasyon olur.
`headway`	isteğe bağlı	tam sayı	Bu saatte aynı duraktan kalkan araçlar arasında beklenen süreyi saniye cinsinden belirtir. Örneğin, `headway` değeri 600 ise otobüsünüzü kaçırdığınızda on dakika beklemeniz gerekir.
`line`	isteğe bağlı	DirectionsTransitLine	Bu adımda kullanılan toplu taşıma hattı hakkında bilgi içerir. Daha fazla bilgi için DirectionsTransitLine sayfasına bakın.
`num_stops`	isteğe bağlı	tam sayı	Kalkış durağından varış durağına kadar olan durak sayısı. Varış durağı buna dahildir ancak kalkış durağı dahil değildir. Örneğin, yol tarifiniz A durağından ayrılmayı, B ve C duraklarından geçmeyi ve D durağına varmayı içeriyorsa `num_stops`, 3 değerini döndürür.
`trip_short_name`	isteğe bağlı	dize	Yolcuların toplu taşıma yolculuğunu tanımlamak için programlarda ve tabelalarda görünen metin. Metin, bir hizmet günü içindeki bir seferi benzersiz şekilde tanımlamalıdır. Örneğin, "538", hafta içi günlerde saat 15:10'da San Jose, Kaliforniya'dan Sacramento, Kaliforniya'ya giden Amtrak treninin `trip_short_name` değeridir.

DirectionsTransitStop

Alan	Zorunlu	Tür	Açıklama
`location`	required	LatLngLiteral	Durağın konumu. Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`name`	required	dize	Toplu taşıma durağının adı.

TimeZoneTextValueObject

Unix epoch zamanı, saat dilimi ve biçimlendirilmiş metin gösterimini içeren bir nesne.

Alan	Zorunlu	Tür	Açıklama
`text`	required	dize	Saat diliminde dize olarak belirtilen saat.
`time_zone`	required	dize	Saat dilimini içerir. Değer, IANA Saat Dilimi Veritabanı'nda tanımlandığı şekliyle saat diliminin adıdır (ör. "America/New_York").
`value`	required	sayı	Unix epoch zamanı veya 1 Ocak 1970 UTC gece yarısından itibaren saniye cinsinden belirtilen zaman.

DirectionsTransitLine

Alan	Zorunlu	Tür	Açıklama
`agencies`	required	Array<DirectionsTransitAgency>	Bu toplu taşıma hattını işleten toplu taşıma kuruluşu (veya kuruluşları). Daha fazla bilgi için DirectionsTransitAgency sayfasına bakın.
`name`	required	dize	Bu toplu taşıma hattının tam adı (ör. "8 Avenue Local").
`color`	isteğe bağlı	dize	Bu hat için tabelalarda yaygın olarak kullanılan renk.
`icon`	isteğe bağlı	dize	Bu satırla ilişkili simgenin URL'sini içerir.
`short_name`	isteğe bağlı	dize	Bu toplu taşıma hattının kısa adı. Bu genellikle "M7" veya "355" gibi bir hat numarasıdır.
`text_color`	isteğe bağlı	dize	Bu hat için tabelalarda yaygın olarak kullanılan renk.
`url`	isteğe bağlı	dize	Transit operatörü tarafından sağlanan bu toplu taşıma hattının URL'sini içerir.
`vehicle`	isteğe bağlı	DirectionsTransitVehicle	Bu toplu taşıma hattında çalışan araç türü. Daha fazla bilgi için DirectionsTransitVehicle sayfasına bakın.

DirectionsTransitAgency

Alan	Zorunlu	Tür	Açıklama
`name`	isteğe bağlı	dize	Bu transit operatörünün adı.
`phone`	isteğe bağlı	dize	Toplu taşıma şirketinin telefon numarası.
`url`	isteğe bağlı	dize	Toplu taşıma şirketinin URL'si.

DirectionsTransitVehicle

Alan	Zorunlu	Tür	Açıklama
`name`	required	dize	Bu aracın adı (büyük harfle yazılır).
`type`	required	dize	Kullanılan aracın türü. `BUS` - Otobüs. `CABLE_CAR`: Genellikle yerde, kablo üzerinde çalışan bir araç. Hava kablolu arabalar GONDOLA_LIFT türünde olabilir. `COMMUTER_TRAIN` - Banliyö treni. `FERRY` - Feribot. `FUNICULAR`: Kabloyla dik bir yokuşa çekilen araç. Füniküler genellikle iki vagondan oluşur ve her vagon diğerinin karşı ağırlığı olarak işlev görür. `GONDOLA_LIFT` - Havada asılı bir teleferik. `HEAVY_RAIL` - Ağır raylı sistem. `HIGH_SPEED_TRAIN` - Yüksek hızlı tren. `INTERCITY_BUS` - Şehirler arası otobüs. `LONG_DISTANCE_TRAIN` - Şehirler arası tren. `METRO_RAIL` - Hafif raylı sistem. `MONORAIL` - Monoray. `OTHER` - Diğer tüm araçlar bu türü döndürür. `RAIL` - Raylı sistem. `SHARE_TAXI` - Dolmuş, güzergahı üzerinde herhangi bir yerde yolcu indirip bindirebilen bir tür otobüstür. `SUBWAY` - Yeraltı hafif raylı sistemi. `TRAM` - Yer üstü hafif raylı sistem. `TROLLEYBUS` - Troleybüs. The allowed values include: `BUS`, `CABLE_CAR`, `COMMUTER_TRAIN`, `FERRY`, `FUNICULAR`, `GONDOLA_LIFT`, `HEAVY_RAIL`, `HIGH_SPEED_TRAIN`, `INTERCITY_BUS`, `LONG_DISTANCE_TRAIN`, `METRO_RAIL`, `MONORAIL`, `OTHER`, `RAIL`, `SHARE_TAXI`, `SUBWAY`, `TRAM`, and `TROLLEYBUS`
`icon`	isteğe bağlı	dize	Bu araç türüyle ilişkili bir simgenin URL'sini içerir.
`local_icon`	isteğe bağlı	dize	Yerel ulaşım tabelalarına göre bu araç türüyle ilişkili simgenin URL'sini içerir.

DirectionsTrafficSpeedEntry

Alan	Zorunlu	Tür	Açıklama
`offset_meters`	required	sayı	Bu hız kategorisinin geçerli olduğu yol boyunca olan ofset (metre cinsinden).
`speed_category`	required	dize	Yolun bu bölümündeki mevcut trafik/hız koşulları.

DirectionsViaWaypoint

Alan	Zorunlu	Tür	Açıklama
`location`	isteğe bağlı	LatLngLiteral	Ara noktanın konumu. Daha fazla bilgi için LatLngLiteral sayfasına bakın.
`step_index`	isteğe bağlı	tam sayı	Ara noktayı içeren adımın dizini.
`step_interpolation`	isteğe bağlı	sayı	Ara noktanın, adımın çoklu çizgisi boyunca konumu. 0 ile 1 arasında bir oran olarak ifade edilir.

Ücret

Rotanın toplam ücreti.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

Alan	Zorunlu	Tür	Açıklama
`currency`	required	dize	Tutarı ifade eden para birimini gösteren ISO 4217 para birimi kodu.
`text`	required	dize	İstenen dilde biçimlendirilmiş toplam ücret tutarı.
`value`	required	sayı	Belirtilen para biriminde toplam ücret tutarı.

DirectionsStatus

Directions yanıt nesnesindeki durum alanı, isteğin durumunu içerir ve Directions hizmetinin neden başarısız olduğunu bulmanıza yardımcı olacak hata ayıklama bilgileri içerebilir. Durum alanı aşağıdaki değerleri içerebilir:

OK, yanıtın geçerli bir sonuç içerdiğini gösterir.
NOT_FOUND, isteğin başlangıç noktası, varış noktası veya referans noktalarında belirtilen konumlardan en az birinin coğrafi kodunun oluşturulamadığını gösterir.
ZERO_RESULTS, başlangıç ve varış noktası arasında rota bulunamadığını gösterir.
MAX_WAYPOINTS_EXCEEDED, istekte çok fazla yol noktası sağlandığını gösterir. Directions API'yi web hizmeti olarak kullanan uygulamalar veya Maps JavaScript API'deki yol tarifi hizmeti için izin verilen maksimum ara nokta sayısı 25'tir (başlangıç ve varış noktası hariç).
MAX_ROUTE_LENGTH_EXCEEDED, istenen rotanın çok uzun olduğunu ve işlenemediğini gösterir. Bu hata, daha karmaşık yol tarifleri döndürüldüğünde oluşur. Yol noktası, dönüş veya talimat sayısını azaltmayı deneyin.
INVALID_REQUEST, gönderilen isteğin geçersiz olduğunu gösterir. Bu durumun yaygın nedenleri arasında geçersiz bir parametre veya parametre değeri yer alır.
OVER_DAILY_LIMIT aşağıdakilerden herhangi birini gösterir:
- API anahtarı eksik veya geçersiz.
- Hesabınızda faturalandırma etkinleştirilmemiştir.
- Kullanıcının kendisi için belirlediği kullanım sınırı aşıldı.
- Sağlanan ödeme yöntemi artık geçerli değilse (ör. kredi kartının süresi dolmuşsa)
Bu sorunu nasıl çözülür? Haritalar SSS sayfasına bakın.
OVER_QUERY_LIMIT, hizmetin izin verilen süre içinde uygulamanızdan çok fazla istek aldığını gösterir.
REQUEST_DENIED, hizmetin, uygulamanızın yol tarifi hizmetini kullanmasını reddettiğini gösterir.
UNKNOWN_ERROR, bir sunucu hatası nedeniyle yol tarifi isteğinin işlenemediğini gösterir. Tekrar denerseniz istek başarılı olabilir.

DirectionsGeocodedWaypoint

Alan	Zorunlu	Tür	Açıklama
`geocoder_status`	isteğe bağlı	dize	Coğrafi kodlama işleminden kaynaklanan durum kodunu gösterir. Bu alan aşağıdaki değerleri içerebilir. The allowed values include: `OK`, and `ZERO_RESULTS`
`partial_match`	isteğe bağlı		Coğrafi kodlayıcının, istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmediğini gösterir. Orijinal istekte yazım hataları ve/veya eksik adres olup olmadığını inceleyebilirsiniz. Kısmi eşleşmeler genellikle istekte ilettiğiniz bölgede bulunmayan açık adresler için gerçekleşir. Bir istek aynı bölgedeki iki veya daha fazla konumla eşleştiğinde de kısmi eşleşmeler döndürülebilir. Örneğin, "21 Henr St, Bristol, UK" araması hem Henry Street hem de Henrietta Street için kısmi eşleşme döndürür. Bir istekte yanlış yazılmış bir adres bileşeni varsa coğrafi kodlama hizmetinin alternatif bir adres önerebileceğini unutmayın. Bu şekilde tetiklenen öneriler de kısmi eşleşme olarak işaretlenir.
`place_id`	isteğe bağlı	dize	Diğer Google API'leriyle kullanılabilen benzersiz bir tanımlayıcı. Yer kimliğine genel bakış bölümünü inceleyin.
`types`	isteğe bağlı	Dizi<string>	Yol tariflerini hesaplamak için kullanılan coğrafi kodlama sonucunun adres türünü belirtir. `administrative_area_level_1`, ülke düzeyinin altındaki birinci dereceden idari bölgeyi belirtir. Amerika Birleşik Devletleri'nde bu idari düzeyler eyaletlerdir. Bu idari düzeyler bazı ülkelerde kullanılmaz. Çoğu durumda administrative_area_level_1 kısa adları, ISO 3166-2 alt bölümleri ve yaygın olarak kullanılan diğer listelerle büyük ölçüde eşleşir. Ancak coğrafi kodlama sonuçlarımız çeşitli sinyallere ve konum verilerine dayandığından bu durum garanti edilmez. `administrative_area_level_2`, ülke düzeyinin altındaki ikinci dereceden idari bölgeyi gösterir. Amerika Birleşik Devletleri'nde bu idari düzeyler ilçelerdir. Bu idari düzeyler bazı ülkelerde kullanılmaz. `administrative_area_level_3`, ülke düzeyinin altındaki üçüncü düzey idari bölgeyi gösterir. Bu tür, küçük bir idari bölümü gösterir. Bu idari düzeyler bazı ülkelerde kullanılmaz. `administrative_area_level_4`, ülke düzeyinin altındaki dördüncü düzey idari bölgeyi gösterir. Bu tür, küçük bir idari birimi gösterir. Bu idari düzeyler bazı ülkelerde kullanılmaz. `administrative_area_level_5`, ülke düzeyinin altındaki beşinci düzey idari bölgeyi gösterir. Bu tür, küçük bir idari birimi gösterir. Bu idari düzeyler bazı ülkelerde kullanılmaz. `airport` bir havaalanını gösterir. `colloquial_area`, tüzel kişi için yaygın olarak kullanılan alternatif bir adı belirtir. `country`, ulusal siyasi varlığı gösterir ve genellikle Geocoder tarafından döndürülen en yüksek düzeydeki türdür. `intersection`, genellikle iki ana yolun kesiştiği büyük bir kavşağı gösterir. `locality`, tüzel kişiliğe sahip bir şehir veya kasaba siyasi tüzel kişisini gösterir. `natural_feature`, belirgin bir doğal özelliği gösterir. `neighborhood`, adlandırılmış bir mahalleyi belirtir. `park`, adı olan bir parkı gösterir. `plus_code`, enlem ve boylamdan türetilen kodlanmış bir konum referansını gösterir. Plus Code'lar, açık adreslerin bulunmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerler) açık adreslerin yerine kullanılabilir. Ayrıntılar için https://plus.codes adresini ziyaret edin. `point_of_interest`, adlandırılmış bir önemli yeri gösterir. Genellikle bu "ÖY"ler, "Empire State Binası" veya "Eyfel Kulesi" gibi başka bir kategoriye kolayca uymayan, öne çıkan yerel öğelerdir. `political`, siyasi bir tüzel kişiyi gösterir. Genellikle bu tür, bir sivil idarenin poligonunu gösterir. `postal_code`, ülke içinde posta göndermek için kullanılan posta kodunu belirtir. `premise`, adlandırılmış bir konumu (genellikle bir bina veya ortak adı olan bir bina grubu) belirtir. `route`, adlandırılmış bir rotayı (ör. "US 101") gösterir. `street_address`, tam açık adresi gösterir. `sublocality`, bir yerleşim yerinin altındaki birinci derece sivil tüzel kişiyi gösterir. Bazı konumlar için ek türlerden biri alınabilir: sublocality_level_1 - sublocality_level_5. Her alt idari bölge düzeyi bir sivil tüzel kişidir. Daha büyük sayılar daha küçük bir coğrafi alanı gösterir. `subpremise`, adlandırılmış bir konumun altındaki birinci dereceden bir öğeyi belirtir. Bu genellikle ortak bir adı olan bir bina koleksiyonundaki tek bir binadır. `tourist_attraction`, turistik yerleri gösterir. `train_station`, tren istasyonunu gösterir. `transit_station`, toplu taşıma istasyonunu gösterir. Boş bir tür listesi, belirli adres bileşeni için bilinen bir tür olmadığını gösterir (ör. Fransa'da Lieu-dit).

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

Örnek yanıtlar

URL

curl

JSON

XML

DirectionsResponse

routes

status

available_travel_modes

error_message

geocoded_waypoints

DirectionsRoute

bounds

copyrights

legs

overview_polyline

summary

warnings

waypoint_order

fare

Sınırlar

northeast

southwest

LatLngLiteral

lat

lng

DirectionsLeg

end_address

end_location

start_address

start_location

steps

traffic_speed_entry

via_waypoint

arrival_time

departure_time

distance

duration

duration_in_traffic

DirectionsStep

duration

end_location

html_instructions

polyline

start_location

travel_mode

distance

maneuver

steps

transit_details

TextValueObject

text

value

DirectionsPolyline

points

TravelMode

DirectionsTransitDetails

arrival_stop

arrival_time

departure_stop

departure_time

headsign

headway

line

num_stops

trip_short_name

DirectionsTransitStop

location

name

TimeZoneTextValueObject

text

time_zone

value

DirectionsTransitLine

agencies

name

color

icon

short_name

Yol tarifi yanıtları

`routes`

`status`

`available_travel_modes`

`error_message`

`geocoded_waypoints`

`bounds`

`copyrights`

`legs`

`overview_polyline`

`summary`

`warnings`

`waypoint_order`

`fare`

`northeast`

`southwest`

`lat`

`lng`

`end_address`

`end_location`

`start_address`

`start_location`

`steps`

`traffic_speed_entry`

`via_waypoint`

`arrival_time`

`departure_time`

`distance`

`duration`

`duration_in_traffic`

`duration`

`end_location`

`html_instructions`

`polyline`

`start_location`

`travel_mode`

`distance`

`maneuver`

`steps`

`transit_details`

`text`

`value`

`points`

`arrival_stop`

`arrival_time`

`departure_stop`

`departure_time`

`headsign`

`headway`

`line`

`num_stops`

`trip_short_name`

`location`

`name`

`text`

`time_zone`

`value`

`agencies`

`name`

`color`

`icon`

`short_name`

`text_color`

`url`

`vehicle`

`name`

`phone`

`url`

`name`

`type`

`icon`

`local_icon`

`offset_meters`

`speed_category`

`location`

`step_index`

`step_interpolation`

`currency`

`text`

`value`