Mesafe Matrisi API'sine genel bakış

Mesafe Matrisi API'si, HTTPS isteğini kabul eden bir hizmettir Belirli bir ulaşım modu için kalkış ve varış noktalarını içeren bir satır öğesi seçin. Her bir kalkış ve varış noktası kombinasyonu için seyahat mesafesini ve süresini döndürür.

Mesafe Matrisi API'sini 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, örnek olarak, hangi çalışanların iş sahalarına veya hangi depolardan gönderileceği gibi bilgiler paketlerini ekleyebilirsiniz.

Distance Matrix API ile neler yapabilirsiniz?

Mesafe Matrisi API'siyle her bir konum için seyahat mesafesi ve bir matristir. 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.

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

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

Haritada ve API yanıtında kalkış noktası ile varış noktalarını gösteren harita

Mesafe Matrisi API'sinin işleyiş şekli

Mesafe Matrisi API'si herhangi bir sayıda çıkış noktası (başlangıç noktaları) ve hedef kullanır ve bunların her biri arasındaki mesafeyi ve seyahat süresini döndürür başlangıç noktası ve tüm istenen hedefler, ve adım adım bir sonrakine ilerler.

Örneğin, isteğiniz kaynak olarak A ve B ve hedefler 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-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ı arasındaki mesafe ve seyahat süresi hedef
  • Sürüş modunu ve bir yola çıkma saati belirttiyseniz trafikte geçirilen süre
  • JSON
  • XML

Mesafe Matrisi API'si nasıl kullanılır?

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 Matris 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şturma Birden fazla kaynak ve hedef sağlayan bir isteği 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. İsteğe bağlı parametrelerbölümüne bakın. Mesafe Matrisi istek ve yanıt rehberine göz atın.
4 Yanıtlarla ilgili temel bilgileri anlama Uygulamanızda mesafe matrisi verilerini kullanmaya hazırlanmak için veri yanıtlarını keşfedin. Görüntüleyin Mesafe matrisi yanıtları inceleyebilirsiniz.
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ı

Bu API'yi şu dilde çağırın: aşağıdaki istemci kitaplıklarından birini kullanarak seçiminizi yapın:

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

Sırada ne var?