Mesafe Matrisi API'sine genel bakış

Mesafe Matrisi API'si, belirli bir taşıma modu için başlangıç noktalarını ve hedefleri içeren HTTPS isteğini kabul eden bir hizmettir. Her bir kalkış ve varış kombinasyonu için seyahat mesafesi 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ındaki en verimli seyahat rotalarını belirlemenize yardımcı olması için Uzaklık Matrisi API'sini kullanabilirsiniz. Örneğin, hangi çalışanların iş sahalarına veya hangi depolardan paket gönderileceği gibi.

Mesafe Matrisi API'si ile neler yapabilirsiniz?

Mesafe Matrisi API'si ile kalkış ve varış noktaları matrisi için seyahat mesafesi ve süresi sağlayabilirsiniz. Araba, bisiklet, toplu taşıma veya yürüyüş gibi ulaşım şeklinin yanı sıra otobüs, metro, tren, tramvay veya demiryolu gibi toplu taşıma modlarını da 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çili 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 varış noktalarını gösteren harita

Mesafe Matrisi API'sinin işleyiş şekli

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

Örneğin, isteğiniz başlangıç noktası 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 istek gösterilmektedir: Washington, DC ve Boston, tek hedef olarak New York City, NY ve JSON biçimindedir:

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 aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte ö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 bir 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'sini kullanma

1 Hazırlanın. Google Cloud projenizi oluşturma ile başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Mesafe matrisi isteğini deneme API anahtarınız hazır 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 başlangıç noktası ve hedef sağlayan bir isteği deneyin. Belirtilen kalkış saati veya rota kısıtlamaları gibi hesaplamaları sınırlandırmak için kullanılan isteğe bağlı parametreler hakkında bilgi edinin. Mesafe Matrisi istek ve yanıt kılavuzundaki İsteğe bağlı parametreler'e bakın.
4 Yanıtlarla ilgili temel bilgileri anlama Uygulamanız için mesafe matrisi verilerini kullanmaya hazırlanmak amacıyla veri yanıtlarını inceleyin. Ayrıntılar için Mesafe matrisi yanıtları bölümüne bakın.
5 Mesafe matrisi verilerini kendi uygulamanıza ekleyin! 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:

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

Sırada ne var?