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çerir. Her bir kalkış ve varış noktasının birleşiminden yola çıkarak seyahat mesafesini ve süresini döndürür.

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

Mesafe Matrisi API'sini kullanarak projenizin en verimli ve varış noktaları arasındaki seyahat rotalarını gösterir. Örneğin, Örneğin, hangi çalışanların iş sahasına veya hangi depolardan gönderileceği gibi bilgiler paketlerini ekleyebilirsiniz.

Mesafe Matrisi API'si ile neler yapabilirsiniz?

Mesafe Matrisi API'siyle her bir konum için seyahat mesafesi ve bir matristir. Şunlar dahil birkaç seçenek belirtebilirsiniz: araba, bisiklet, toplu taşıma veya yaya gibi ulaşım şekillerinin yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma modları.

Mesafe Matrisi API'si, önerilen rotaya göre bilgi sağlar ve bitiş noktaları arasında geçiş yapın. Aşağıdaki tür mesafe verileri 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'den D'ye

Aşağıdaki örnekte iki kaynak için bir istek gösterilmektedir: tek bir varış noktası olan Washington, DC ve Boston, New York City, NY JSON biçimi:

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 ile döndürdüğü veriler.

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

Başlangıç ve varış noktalarını yer kimlikleri, adresler, enlem/boylam koordinatlarını kullanabilirsiniz.

  • Her kalkış noktası arasındaki mesafe ve seyahat süresi hedef
  • Sürüş modunu belirttiyseniz ve kalkış saati
  • JSON
  • XML

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

1 Kurulumu tamamlayın. Ayarlarınızı Google Cloud projesi ve kurulumu tamamlayın lütfen unutmayın.
2 Mesafe matrisi isteğini deneme API anahtarınız olduğunda DISTANCE Matris API'sini doğrudan tarayıcınızdan test etmeye başlayabilirsiniz. Örnek istekler bölümünü inceleyin Başlarken kılavuzuna göz atın.
3 Daha karmaşık bir istek oluşturma Birden fazla kaynak ve hedef sağlayan bir isteği deneyin. Öğren hesaplamaları kısıtlamak için isteğe bağlı parametreler hakkında veya rota kısıtlamalarına dikkat edin. İ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 Bu verileri seyahat mesafesini ve süresini hesaplamak için 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ı. Bu uygulamaları GitHub'dan indirin. Burada yükleme talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?