Mesafe Matrisi API'sine genel bakış

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

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

Mesafe Matrisi API'sini kullanarak birden fazla olası kalkış ve varış noktası arasındaki en verimli seyahat rotalarını belirleyebilirsiniz. Örneğin, hangi çalışanların iş sitelerine veya hangi depolardan paket gönderileceğini belirleyebilirsiniz.

Mesafe Matrisi API'si ile neler yapabilirsiniz?

Mesafe Matrisi API'si ile başlangıç noktaları ve varış noktaları için seyahat mesafesi ve süresi bilgilerini sağlayabilirsiniz. Ulaşım modunun (araba, bisiklet, toplu taşıma veya yaya gibi) yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma modları gibi çeşitli seçenekler belirtebilirsiniz.

Mesafe Matrisi API'si, başlangıç ve bitiş noktaları arasında önerilen rotaya göre bilgi sağlar. 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 kaynak (başlangıç noktaları) ve hedef kullanır ve her bir başlangıç noktası ile talep edilen tüm hedefler arasındaki mesafe ve seyahat süresini döndürür. İstekteki ilk başlangıç noktasından başlayıp sonrakine adım adım devam eder.

Ö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 hedef olacak şekilde Washington, DC ve Boston, New York City, NY, JSON biçiminde:

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 ve döndürdüğü verilerle birlikte özetlenmiştir.

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

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

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

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

1 Kurulumu tamamlayın. Google Cloud projenizi oluşturun bölümüne geçin ve sonraki kurulum talimatlarını tamamlayı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. Örnekler için Başlarken 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 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ızda mesafe matrisi verilerini kullanmaya hazırlanmak için veri yanıtlarını keşfedin. Ayrıntılar için Mesafe matrisi yanıtları konusuna 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ı

Aşağıdaki istemci kitaplıklarından biri aracılığıyla 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ı kapsamında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu uygulamaları GitHub'dan indirin. Burada yükleme talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?