Mesafe Matrisi API'sine genel bakış

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

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

Birden fazla olası başlangıç ve varış noktası arasında en verimli seyahat rotalarını belirlemek için Distance Matrix API'yi kullanabilirsiniz. Örneğin, hangi işçilerin iş alanlarına gönderileceği veya hangi depolardan paket gönderileceği.

Distance Matrix API ile neler yapabilirsiniz?

Distance Matrix API ile bir başlangıç ve varış noktaları matrisi için seyahat mesafesini ve süresini sağlayabilirsiniz. Araba, bisiklet, toplu taşıma veya yürüyüş gibi ulaşım yöntemlerinin yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma yöntemleri de dahil olmak üzere çeşitli seçenekler belirleyebilirsiniz.

Distance Matrix API, başlangıç ve bitiş noktaları arasındaki önerilen rotaya göre bilgi sağlar. Aşağıdaki mesafe verilerini isteyebilirsiniz:

  • Seçilen ulaşım şekli için mesafe
  • Mesafe (kilometre veya mil)
  • Trafikte tahmini seyahat süresi

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

Distance Matrix API'nin işleyiş şekli

Distance Matrix API, herhangi bir sayıda başlangıç noktası (başlangıç noktası) ve varış noktası kullanır ve istekteki ilk başlangıç noktasından başlayıp bir sonrakine adım adım ilerleyerek her başlangıç noktası ile istenen tüm varış noktaları arasındaki mesafeyi ve seyahat süresini döndürür.

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

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

Aşağıdaki örnekte, JSON biçiminde iki kaynak (Washington, DC ve Boston) ve tek bir hedef (New York, NY) için 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 üzerinden kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.

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

Başlangıç ve varış noktalarını yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde sağlayın.

  • Her kalkış noktası ile her varış noktası arasındaki mesafe ve seyahat süresi
  • Sürüş modunu ve bir yola çıkma saati belirttiyseniz trafikte geçirilen süre
  • JSON
  • XML

Distance Matrix API'yi kullanma

1 Kurulum yapın. Google Cloud projenizi oluşturma ile başlayın ve sonraki kurulum talimatlarını uygulayın.
2 Mesafe matrisi isteği deneyebilirsiniz API anahtarınız olduğunda Distance Matrix API'yi 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 kaynak ve hedef sağlayan bir istek deneyin. Hesaplamaları kısıtlamak için isteğe bağlı parametreler (ör. belirtilen bir kalkış saati veya rota kısıtlamaları) hakkında bilgi edinin. Mesafe matrisi isteği ve yanıtı kılavuzundaki İsteğe bağlı parametreler bölümünü inceleyin.
4 Yanıtların temel özelliklerini anlama Uygulamanız için mesafe matrisi verilerini kullanmaya hazırlanmak amacıyla veri yanıtlarını keşfedin. Ayrıntılar için Mesafe matrisi yanıtları başlıklı makaleyi inceleyin.
5 Mesafe matrisi verilerini kendi uygulamanıza dahil edin. Seyahat mesafesini ve süresini hesaplamak için bu verileri kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:

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

Sırada ne var?