Bu ürün eski durumdadır. Ekim 2026'dan itibaren Distance Matrix 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.

Distance Matrix API (eski) isteği ve yanıtı

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

Giriş

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

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

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

json (önerilir), JavaScript Object Notation (JSON) biçiminde çıkış yapılacağını belirtir.
xml, çıkışın XML biçiminde olduğunu gösterir.

Bazı parametreler zorunlu, bazıları ise isteğe bağlıdır. URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) karakteri kullanılarak ayrılır. Tüm ayrılmış karakterler (ör. artı işareti "+") URL olarak kodlanmalıdır. Parametrelerin listesi ve olası değerleri aşağıda sıralanmıştır.

Gerekli parametreler

hedefler

Seyahat mesafesini ve süresini hesaplamak için bitiş noktası olarak kullanılacak bir veya daha fazla konum. Hedefler parametresinin seçenekleri, başlangıç noktaları parametresiyle aynıdır.
origins

Seyahat mesafesini ve süresini hesaplamak için başlangıç noktası. Yer kimliği, adres veya enlem/boylam koordinatları biçiminde, düşey çubuk karakteriyle (|) ayrılmış bir veya daha fazla konum sağlayabilirsiniz:
- Yer kimliği: Bir yer kimliği sağlarsanız bunun önüne place_id: eklemeniz gerekir.
- Adres: Bir adres iletirseniz hizmet, dizeyi coğrafi olarak kodlar ve mesafeyi 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).
  Not: Adres 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. Adres kullanıldığında, binanın girişine olan mesafe yerine binanın merkezine olan mesafe gösterilir.
- Koordinatlar: Enlem/boylam koordinatlarını iletirseniz bunlar 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.
- 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 çıkış karakteri olarak %2B ve boşluklar URL çıkış karakteri olarak %20 şeklinde gösterilir):
  - global code, 4 karakterlik bir alan kodu ve 6 karakter veya daha uzun bir yerel koddur (849VCWC8+R9, 849VCWC8%2BR9 olarak kodlanır).
  - Bileşik kod, açık bir konuma sahip 6 karakter veya daha uzun bir yerel koddur (CWC8+R9 Mountain View, CA, USA, CWC8%2BR9%20Mountain%20View%20CA%20USA olarak kodlanır).
- Kodlanmış çoklu çizgi Alternatif olarak, kodlanmış çoklu çizgi algoritmasını kullanarak kodlanmış bir koordinat kümesi sağlayabilirsiniz. Bu, özellikle çok sayıda başlangıç noktanız varsa kullanışlıdır. Kodlanmış bir çoklu çizgi kullanıldığında URL önemli ölçüde daha kısadır.
  - Kodlanmış çoklu çizgilerin önüne enc: eklenmeli ve ardından iki nokta üst üste : gelmelidir. Örneğin: origins=enc:gfo}EtohhU:
  - Düşey çubuk karakteri | ile ayrılmış birden fazla kodlanmış çoklu çizgi de ekleyebilirsiniz. Örneğin:
```
origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:
```

İsteğe bağlı parametreler

arrival_time

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

Belirli kısıtlamalara uyan mesafeler hesaplanabilir. Kısıtlamalar, kaçınma parametresi ve bu parametre için kaçınılacak kısıtlamayı belirten bir bağımsız değişken kullanılarak belirtilir. Aşağıdaki kısıtlamalar desteklenir:
- 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 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ıtlamaların eklenmesi, kısıtlanmış özelliği içeren rotaları engellemez; sonucu daha uygun rotalara yönlendirir.
departure_time

Tercih edilen kalkış saatini belirtir. Zamanı, 1 Ocak 1970 UTC gece yarısından itibaren saniye cinsinden bir tam sayı olarak belirtebilirsiniz. 31.12.9999T23:59:59.999999999Z'den sonraki bir departure_time belirtilirse API, departure_time değerini 31.12.9999T23:59:59.999999999Z olarak ayarlar. Alternatif olarak, kalkış saatini geçerli saate (en yakın saniyeye göre doğru) ayarlayan bir now değeri belirtebilirsiniz. Kalkış saati iki durumda belirtilebilir:
- Seyahat modunun toplu taşıma olduğu istekler için: İsteğe bağlı olarak departure_time veya arrival_time değerlerinden birini belirtebilirsiniz. Hiçbir zaman belirtilmezse departure_time varsayılan olarak geçerli zamana ayarlanır (yani kalkış saati varsayılan olarak geçerli saate ayarlanır).
- Seyahat modunun sürüş olduğu istekler için: Trafik koşullarını dikkate alan bir rota ve seyahat süresi (yanıt alanı: duration_in_traffic) almak için departure_time değerini belirtebilirsiniz. departure_time, geçerli 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=driving olduğunda departure_time belirten Distance Matrix istekleri, istek başına en fazla 100 öğeyle sınırlıdır. Başlangıç noktası sayısı ile hedef sayısı çarpılarak öğe sayısı belirlenir.
language

Sonuçların döndürüleceği dil.
- Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste kapsamlı olmayabilir.
- language sağlanmazsa API, Accept-Language başlığında belirtilen tercih edilen dili kullanmaya çalışır.
- API, hem kullanıcı hem de yerel halk tarafından okunabilen bir açık adres sağlamak için elinden geleni yapar. Bu amaca ulaşmak için 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, sokak kelimesinin eş anlamlılarıdır.
mod

Mesafelerin ve yol tariflerinin hesaplanması için kullanılacak ulaşım modunu belirtebilirsiniz. Varsayılan olarak DRIVING modu kullanılır. Varsayılan olarak, yol tarifleri arabayla yol tarifi olarak hesaplanır. Aşağıdaki seyahat modları desteklenir:
- driving (varsayılan), standart arabayla yol tarifini veya yol ağını kullanan mesafeyi belirtir.
- walking, yaya yollarını ve kaldırımları (varsa) kullanarak yaya yol tarifi veya mesafe ister.
- bicycling bisiklet yollarını ve tercih edilen sokakları (varsa) kullanarak bisiklet için yol tarifi veya mesafe ister.
- transit, toplu taşıma rotalarını (varsa) kullanarak yol tarifi veya mesafe bilgisi ister. Modu toplu taşıma olarak ayarlarsanız isteğe bağlı olarak departure_time veya arrival_time belirtebilirsiniz. Hiçbir zaman belirtilmezse departure_time varsayılan olarak geçerli zamana ayarlanır (yani kalkış saati varsayılan olarak geçerli saate ayarlanır). İsteğe bağlı olarak 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 uyarılar döndürür.

Not: 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.
bölge

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

Trafikte geçen süreyi hesaplarken kullanılacak varsayımları belirtir. Bu ayar, yanıttaki duration_in_traffic alanında döndürülen değeri etkiler. Bu alan, geçmiş ortalamalara göre trafikte geçirilen tahmini süreyi içerir. traffic_model parametresi yalnızca isteğin departure_time içerdiği arabayla yol tarifi için belirtilebilir. Bu parametre için kullanılabilen değerler şunlardır:
- best_guess (varsayılan), döndürülen duration_in_traffic değerinin, hem geçmiş trafik koşulları hem de canlı trafik hakkında bilinenler göz önünde bulundurularak seyahat süresinin en iyi tahmini olması gerektiğini 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_guess varsayılan değeri, kullanım alanlarının büyük çoğunluğu için en faydalı tahminleri sağlar. best_guess tahmin modelinin canlı trafik bilgilerini entegre etme şekli nedeniyle best_guess seyahat süresi tahmini optimistic süresinden daha kısa veya pessimistic sü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|subway değerine eşdeğerdir.
transit_routing_preference

Toplu taşıma rotalarıyla ilgili tercihleri belirtir. Bu parametreyi kullanarak, API tarafından seçilen varsayılan en iyi rotayı kabul etmek yerine döndürülen seçenekleri etkileyebilirsiniz. Bu parametre yalnızca toplu taşıma yol tarifi için belirtilebilir. Parametre aşağıdaki bağımsız değişkenleri destekler:
- less_walking, hesaplanan rotada sınırlı miktarda yürüyüşü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.

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.

İstek örnekleri

Bu örnekte, hedef koordinatları belirtmek için enlem/boylam koordinatları kullanılmaktadır:

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=40.659569%2C-73.933783%7C40.729029%2C-73.851524%7C40.6860072%2C-73.6334271%7C40.598566%2C-73.7527626&key=YOUR_API_KEY'

Bu örnekte, hedef koordinatları belirtmek için Plus Code'lar kullanılmıştır:

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco
  &origins=849VCWC8%2BR9
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=849VCWC8%2BR9&destinations=San%20Francisco&key=YOUR_API_KEY'

Bu örnekte, kodlanmış bir çoklu çizgi kullanan aynı istek gösterilmektedir:

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A
  &origins=40.6655101%2C-73.89188969999998
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=40.6655101%2C-73.89188969999998&destinations=enc%3A_kjwFjtsbMt%60EgnKcqLcaOzkGari%40naPxhVg%7CJjjb%40cqLcaOzkGari%40naPxhV%3A&key=YOUR_API_KEY'

Trafik bilgileri

Trafik bilgileri, aşağıdaki koşulların tümü geçerli olduğunda kullanılır (bunlar, Distance Matrix 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 saate veya gelecekteki bir zamana ayarlanabilir. Geçmişte olamaz.

İ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 veya Charlestown, MA ile Lexington, MA ve Concord, MA arasındaki sürüş mesafeleri için bir Distance Matrix isteği başlatır. İstek, Distance Matrix 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/distancematrix/json
  ?departure_time=now
  &destinations=Lexington%2CMA%7CConcord%2CMA
  &origins=Boston%2CMA%7CCharlestown%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Boston%2CMA%7CCharlestown%2CMA&destinations=Lexington%2CMA%7CConcord%2CMA&departure_time=now&key=YOUR_API_KEY'

JSON

{
  "destination_addresses": ["Lexington, MA, USA", "Concord, MA, USA"],
  "origin_addresses": ["Boston, MA, USA", "Charlestown, Boston, MA, USA"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "33.3 km", "value": 33253 },
              "duration": { "text": "27 mins", "value": 1620 },
              "duration_in_traffic": { "text": "34 mins", "value": 2019 },
              "status": "OK",
            },
            {
              "distance": { "text": "41.5 km", "value": 41491 },
              "duration": { "text": "33 mins", "value": 1981 },
              "duration_in_traffic": { "text": "39 mins", "value": 2342 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "31.1 km", "value": 31100 },
              "duration": { "text": "26 mins", "value": 1543 },
              "duration_in_traffic": { "text": "29 mins", "value": 1754 },
              "status": "OK",
            },
            {
              "distance": { "text": "39.3 km", "value": 39338 },
              "duration": { "text": "32 mins", "value": 1904 },
              "duration_in_traffic": { "text": "35 mins", "value": 2077 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

XML


 OK
 Boston, MA, USA
 Charlestown, Boston, MA, USA
 Lexington, MA, USA
 Concord, MA, USA
 
  
   OK
   
    1620
    27 mins
   
   
    33253
    33.3 km
   
   
    2018
    34 mins
   
  
  
   OK
   
    1981
    33 mins
   
   
    41491
    41.5 km
   
   
    2342
    39 mins
   
  
 
 
  
   OK
   
    1543
    26 mins
   
   
    31100
    31.1 km
   
   
    1759
    29 mins
   
  
  
   OK
   
    1904
    32 mins
   
   
    39338
    39.3 km
   
   
    2077
    35 mins

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. Yolun hangi tarafının kullanılacağını belirtmek için side_of_road değiştiricisini kullanabilir veya doğru seyahat yönünü belirtmek için bir yön belirtebilirsiniz.

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

Bir konum belirtirken side_of_road: ön ekini kullanarak hesaplanan rotanın, ara noktanın eğilimli olduğu yolun hangi tarafında olursa olsun geçmesini isteyebilirsiniz. Örneğin, bu istek uzun bir rota için mesafeyi döndürür. Böylece araç, ara noktanın eğimli olduğu yolun tarafında biter:

URL

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

curl

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

side_of_road:, kodlanmış çoklu çizgilerle kullanıldığında değiştirici, çoklu çizgi boyunca her konuma uygulanır. Örneğin, bu istekteki iki hedef de parametreyi kullanır:

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A
  &origins=San%20Francisco%20City%20hall
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=San%20Francisco%20City%20hall&destinations=side_of_road%3Aenc%3A%7BoqeF%60fejV%5BnC%3A&key=YOUR_API_KEY'

side_of_road: değiştiricisi yalnızca şu kısıtlamayla kullanılabilir:

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

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

Bir konum belirtirken hesaplanan rotanın belirli bir yöndeki konumdan 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ü Kuzey'i, 90 yönü Doğu'yu gösterir ve saat yönünde devam eder. Örneğin, bu istekte hesaplanan rota başlangıç noktasından doğuya doğru gider ve ardından U dönüşü yapar:

URL

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

curl

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

heading=X: değiştiricisi yalnızca şu 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.

Distance Matrix isteği ve yanıtları

Aşağıda, Vancouver, BC, Kanada ve Seattle, WA, ABD'den San Francisco, CA, ABD ve Victoria, BC, Kanada'ya olan mesafe ve süreyi isteyen örnek bir HTTP isteği gösterilmektedir.

URL

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=San%20Francisco%7CVictoria%20BC
  &language=fr-FR
  &mode=bicycling
  &origins=Vancouver%20BC%7CSeattle
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/distancematrix/json?origins=Vancouver%20BC%7CSeattle&destinations=San%20Francisco%7CVictoria%20BC&mode=bicycling&language=fr-FR&key=YOUR_API_KEY'

Bu istek, iki başlangıç noktası ve iki varış noktası olmak üzere dört öğe döndürür:

Vancouver'dan San Francisco'ya	Vancouver'dan Victoria'ya
Seattle'dan San Francisco'ya	Seattle'dan Victoria'ya

Sonuçlar satırlar halinde döndürülür. Her satırda, her bir hedefle eşleştirilmiş bir kaynak bulunur.

JSON

{
  "destination_addresses":
    ["San Francisco, Californie, États-Unis", "Victoria, BC, Canada"],
  "origin_addresses":
    ["Vancouver, BC, Canada", "Seattle, Washington, États-Unis"],
  "rows":
    [
      {
        "elements":
          [
            {
              "distance": { "text": "1 712 km", "value": 1711765 },
              "duration": { "text": "3 jours 16 heures", "value": 318119 },
              "status": "OK",
            },
            {
              "distance": { "text": "140 km", "value": 139695 },
              "duration": { "text": "6 heures 49 minutes", "value": 24567 },
              "status": "OK",
            },
          ],
      },
      {
        "elements":
          [
            {
              "distance": { "text": "1 452 km", "value": 1451704 },
              "duration": { "text": "3 jours 2 heures", "value": 266680 },
              "status": "OK",
            },
            {
              "distance": { "text": "146 km", "value": 146500 },
              "duration": { "text": "2 heures 53 minutes", "value": 10374 },
              "status": "OK",
            },
          ],
      },
    ],
  "status": "OK",
}

XML


 OK
 Vancouver, BC, Canada
 Seattle, Washington, États-Unis
 San Francisco, Californie, États-Unis
 Victoria, BC, Canada
 
  
   OK
   
    318119
    3 jours 16 heures
   
   
    1711765
    1 712 km
   
  
  
   OK
   
    24567
    6 heures 49 minutes
   
   
    139695
    140 km
   
  
 
 
  
   OK
   
    266680
    3 jours 2 heures
   
   
    1451704
    1 452 km
   
  
  
   OK
   
    10374
    2 heures 53 minutes
   
   
    146500
    146 km

DistanceMatrixResponse

Alan	Zorunlu	Tür	Açıklama
`destination_addresses`	required	Dizi<string>	API tarafından orijinal isteğinizden döndürülen adres dizisi. `origin_addresses` gibi, bunlar da uygunsa yerelleştirilir. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresleri programatik olarak ayrıştırmayın.
`origin_addresses`	required	Dizi<string>	Orijinal isteğinizden API tarafından döndürülen adres dizisi. Bunlar, coğrafi kodlayıcı tarafından biçimlendirilir ve istekle birlikte iletilen dil parametresine göre yerelleştirilir. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresleri programatik olarak ayrıştırmayın.
`rows`	required	Array<DistanceMatrixRow>	Her biri `status`, `duration` ve `distance` öğesi içeren bir öğe dizisi. Daha fazla bilgi için DistanceMatrixRow bölümüne bakın.
`status`	required	DistanceMatrixStatus	İ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 DistanceMatrixStatus sayfasına bakın.
`error_message`	isteğe bağlı	dize	İstek işlenirken karşılaşılan hataların okunabilir metnini içeren bir dize.

DistanceMatrixStatus

Hizmet tarafından döndürülen durum kodları.

OK, yanıtın geçerli bir sonuç içerdiğini gösterir.
INVALID_REQUEST, sağlanan isteğin geçersiz olduğunu gösterir.
MAX_ELEMENTS_EXCEEDED, kalkış ve varış noktalarının çarpımının sorgu başına sınırı aştığını gösterir.
MAX_DIMENSIONS_EXCEEDED, başlangıç veya varış noktası sayısının sorgu başına sınırı aştığını gösterir.
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)
OVER_QUERY_LIMIT, hizmetin izin verilen süre içinde uygulamanızdan çok fazla istek aldığını gösterir.
REQUEST_DENIED, uygulamanızın Distance Matrix hizmetini kullanmasının reddedildiğini gösterir.
UNKNOWN_ERROR, bir sunucu hatası nedeniyle Distance Matrix isteğinin işlenemediğini gösterir. Tekrar denerseniz istek başarılı olabilir.

DistanceMatrixRow

Alan	Zorunlu	Tür	Açıklama
`elements`	required	Dizi<DistanceMatrixElement>	Distance Matrix API, sonuçları döndürürken JSON satır dizisine yerleştirir. Sonuç döndürülmese bile (ör. başlangıç ve/veya varış noktaları mevcut olmadığında) boş bir dizi döndürür. Satırlar, isteğin origin parametresindeki değerlere göre sıralanır. Her satır bir başlangıç noktasına karşılık gelir ve bu satırdaki her öğe, başlangıç noktasının bir hedef değerle eşleşmesine karşılık gelir. Her satır dizisi, bir veya daha fazla öğe girişi içerir. Bu girişler de tek bir başlangıç-varış noktası eşleşmesiyle ilgili bilgileri içerir. Daha fazla bilgi için DistanceMatrixElement sayfasına bakın.

DistanceMatrixElement

Alan	Zorunlu	Tür	Açıklama
`status`	required	DistanceMatrixElementStatus	Öğenin durumu. Daha fazla bilgi için DistanceMatrixElementStatus sayfasına bakın.
`distance`	isteğe bağlı	TextValueObject	Bu rotanın metre cinsinden (değer) ve metin olarak ifade edilen toplam mesafesi. Metin değeri, orijinal isteğin birim parametresiyle belirtilen birim sistemini veya kaynağın bölgesini kullanır. Daha fazla bilgi için TextValueObject bölümüne bakın.
`duration`	isteğe bağlı	TextValueObject	Bu rotada seyahat etmek için gereken sürenin saniye cinsinden (değer alanı) ve metin olarak ifadesi. Metin gösterimi, sorgunun dil parametresine göre yerelleştirilir. Daha fazla bilgi için TextValueObject bölümüne bakın.
`duration_in_traffic`	isteğe bağlı	TextValueObject	Mevcut ve geçmiş trafik koşullarına göre bu rotada seyahat etmenin ne kadar süreceği. 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. Süre, saniye cinsinden (değer alanı) ve metin olarak ifade edilir. Metin gösterimi, sorgunun dil parametresine göre yerelleştirilir. Trafikteki süre yalnızca aşağıdaki koşulların tümü karşılandığında döndürülür: İstek, `departure_time` parametresini içerir. İstenen rota için trafik koşulları bilgisi mevcut. Mod parametresi, sürüş olarak ayarlanır. Daha fazla bilgi için TextValueObject bölümüne bakın.
`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 ücret bilgilerinin mevcut olduğu toplu taşıma sağlayıcıları için döndürülür. Daha fazla bilgi için Fare bölümüne bakın.

Ü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ı.

DistanceMatrixElementStatus

OK, yanıtın geçerli bir sonuç içerdiğini gösterir.
NOT_FOUND, bu eşlemenin kaynağının ve/veya hedefinin coğrafi kodunun oluşturulamadığını gösterir.
ZERO_RESULTS, başlangıç ve varış noktası arasında rota bulunamadığını gösterir.
MAX_ROUTE_LENGTH_EXCEEDED, istenen rotanın çok uzun olduğunu ve işlenemediğini gösterir.

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.

Distance Matrix API (eski) isteği ve yanıtı Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Giriş

Gerekli parametreler

hedefler

origins

İsteğe bağlı parametreler

arrival_time

kaçınma

departure_time

language

mod

bölge

traffic_model

transit_mode

transit_routing_preference

birim

İstek örnekleri

URL

curl

URL

curl

URL

curl

Trafik bilgileri

URL

curl

JSON

XML

Konum Değiştiriciler

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

URL

curl

URL

curl

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

URL

curl

Distance Matrix isteği ve yanıtları

URL

curl

JSON

XML

DistanceMatrixResponse

destination_addresses

origin_addresses

rows

status

error_message

DistanceMatrixStatus

DistanceMatrixRow

elements

DistanceMatrixElement

status

distance

duration

duration_in_traffic

fare

Ücret

currency

text

value

DistanceMatrixElementStatus

TextValueObject

text

value

Distance Matrix API (eski) isteği ve yanıtı

`destination_addresses`

`origin_addresses`

`rows`

`status`

`error_message`

`elements`

`status`

`distance`

`duration`

`duration_in_traffic`

`fare`

`currency`

`text`

`value`

`text`

`value`