Distance Matrix API (Eski) genel bakış

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

Giriş

Distance Matrix API (Eski), belirli bir ulaşım modu için başlangıç ve varış noktalarını içeren bir HTTPS isteğini kabul eden bir hizmettir. Her başlangıç ve varış noktası kombinasyonu için seyahat mesafesini ve süresini döndürür.

Distance Matrix API'yi (eski) neden kullanmalısınız?

Birden fazla olası başlangıç ve varış noktası arasındaki en verimli seyahat rotalarını belirlemek için Distance Matrix API'yi (Eski) kullanabilirsiniz. Örneğin, hangi çalışanların iş yerlerine gönderileceği veya hangi depolardan paket gönderileceği.

Distance Matrix API (eski) ile yapabilecekleriniz

Distance Matrix API (Eski) ile başlangıç ve varış noktaları matrisi için seyahat mesafesi ve süresi sağlayabilirsiniz. Sürüş, bisiklet, toplu taşıma veya yürüyüş gibi ulaşım modlarının yanı sıra otobüs, metro, tren, tramvay veya raylı sistem gibi toplu taşıma modları dahil olmak üzere çeşitli seçenekler belirtebilirsiniz.

Distance Matrix API (Eski), başlangıç ve bitiş noktaları arasındaki önerilen rotaya göre bilgi sağlar. Aşağıdaki türlerde mesafe verileri isteyebilirsiniz:

  • Seçilen seyahat modunun mesafesi
  • Kilometre veya mil cinsinden mesafe
  • Trafikteki tahmini seyahat süresi

Haritada ve API yanıtında başlangıç ve varış noktalarını gösteren harita

Distance Matrix API'nin (eski) işleyiş şekli

Distance Matrix API (Eski), herhangi bir sayıda başlangıç noktası ve hedef kullanır. İstekteki ilk başlangıç noktasından başlayıp adım adım bir sonrakiyle devam ederek her başlangıç noktası ile istenen tüm hedefler arasındaki mesafeyi ve seyahat süresini döndürür.

Örneğin, isteğinizde başlangıç noktası olarak A ve B, hedef olarak C ve D belirtiliyorsa mesafeler ve seyahat süresi şu sırayla döndürülür:

  • A'dan C'ye
  • A'dan D'ye
  • B2C
  • B'den D'ye

Aşağıdaki örnekte, JSON biçiminde tek bir hedef (New York City, NY) ile iki kaynak (Washington, DC ve Boston) için yapılan bir istek gösterilmektedir: 

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Kaynaklar

Aşağıdaki tabloda, Distance Matrix API (Eski) aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Mesafe matrisi

Yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde tedarik kaynakları ve hedefleri.

  • Her başlangıç noktası ile her varış noktası arasındaki mesafe ve seyahat süresi
  • Sürüş modunu ve kalkış saatini belirttiyseniz trafikteki süre
  • JSON
  • XML

Distance Matrix API'yi (Eski) kullanma

1 Kurulumu tamamlama Google Cloud projenizi ayarlama ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Mesafe matrisi isteği göndermeyi deneme API anahtarınız olduğunda Distance Matrix API'yi (Eski) doğrudan tarayıcınızdan test etmeye başlayabilirsiniz. Örnekler için Başlangıç kılavuzundaki Örnek istekler bölümüne bakın.
3 Daha karmaşık bir istek oluşturma Birden fazla başlangıç ve hedef içeren bir istek deneyin. Hesaplamaları kısıtlamak için isteğe bağlı parametreler (ör. belirli bir kalkış saati veya rota kısıtlamaları) hakkında bilgi edinin. Mesafe Matrisi (Eski) istek ve yanıtı kılavuzundaki İsteğe bağlı parametreler bölümüne bakın.
4 Yanıtlarla ilgili temel bilgileri anlama Uygulamanızda mesafe matrisi verilerini kullanmaya hazırlanmak için veri yanıtlarını inceleyin. Ayrıntılar için Mesafe matrisi yanıtları bölümüne bakın.
5 Mesafe matrisi verilerini kendi uygulamanıza dahil edin. Bu verileri seyahat mesafesini ve süresini hesaplamak için kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Bu API'yi, aşağıdaki istemci kitaplıklarından birini kullanarak istediğiniz dilde çağırabilirsiniz:

Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı ve topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. Kurulum talimatlarını ve örnek kodu da GitHub'da bulabilirsiniz.

Sırada ne var?