Mesafe Matrisi API'sine genel bakış

Mesafe Matrisi API'si, belirli bir ulaşım modu için kaynakları ve hedefleri içeren HTTPS isteğini kabul eden bir hizmettir. Her bir kalkış ve varış kombinasyonu için seyahat mesafesi ve süresi döndürülür.

Mesafe Matrisi API'sini neden kullanmalısınız?

Birden çok olası başlangıç ve varış noktası arasındaki en verimli seyahat rotalarını belirlemenize yardımcı olması için Mesafe Matrisi API'sini kullanabilirsiniz. Örneğin, hangi çalışanların iş sahalarına gönderileceği veya hangi depolardan paket gönderileceği gibi.

Mesafe Matrisi API'si ile neler yapabilirsiniz?

Mesafe Matrisi API'sini kullanarak kalkış ve varış noktaları için seyahat mesafesi ve süresi sağlayabilirsiniz. Araba, bisiklet, toplu taşıma veya yürüyüş gibi ulaşım şekillerinin yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma modları da dahil olmak üzere çeşitli seçenekleri belirtebilirsiniz.

Mesafe Matrisi API'si, başlangıç ve varış noktaları arasındaki önerilen rotaya göre bilgi sağlar. Aşağıdaki tür mesafe verilerini isteyebilirsiniz:

  • Seçilen ulaşım şekli için mesafe
  • Kilometre veya mil cinsinden mesafe
  • Trafikteki tahmini seyahat süresi

Haritada ve API yanıtında başlangıç noktası ile hedefleri gösteren harita

Mesafe Matrisi API'sinin işleyiş şekli

Mesafe Matrisi API'si istediğiniz sayıda kalkış (başlangıç noktası) ve varış noktası kullanır. İstekteki ilk kalkış noktasından başlayıp sonrakine adım adım devam ederek her bir kalkış noktası ile istenen tüm hedefler arasındaki mesafe ve seyahat süresini döndürür.

Örneğin, isteğiniz kaynak olarak A ve B, varış noktası olarak C ve D'yi belirtiyorsa mesafeleri ve seyahat süresini şu sırayla döndürür:

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

Aşağıdaki örnekte iki kaynak için bir istek gösterilmektedir: Tek hedefli Washington, DC ve Boston, JSON biçiminde New York City, NY:

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, Mesafe Matrisi API'si üzerinden kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler İade biçimi
Mesafe matrisi

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

  • Kalkış ve varış noktaları arasındaki mesafe ve seyahat süresi
  • Sürüş modunu ve kalkış saatini belirttiyseniz trafikteki süre
  • JSON
  • XML

Mesafe Matrisi API'sini kullanma

1 Hazırlanın. Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Mesafe matrisi isteğini deneyin API anahtarınızı oluşturduktan sonra Mesafe Matrisi API'sini 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şturun Birden fazla kalkış ve hedef sağlayan bir isteği deneyin. Hesaplamaları sınırlandırmak için kullanılan, belirtilen kalkış saati veya rota kısıtlamaları gibi isteğe bağlı parametreler hakkında bilgi edinin. Mesafe Matrisi 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ız için mesafe matrisi verilerini kullanmaya hazırlanmak üzere veri yanıtlarını inceleyin. Ayrıntılı bilgi için Mesafe matrisi yanıtları bölümüne bakın.
5 Mesafe matrisi verilerini kendi uygulamanıza dahil edin! Bu verileri kullanarak seyahat mesafesini ve süresini hesaplayabilirsiniz.

Kullanılabilir istemci kitaplıkları

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

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

Sırada ne var?