Mesafe Matrisi API'sine genel bakış

Mesafe Matrisi API'si, belirli bir taşıma 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üresini döndürür.

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

Birden çok olası kalkış 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ş bölgelerine, hangi depolardan paket gönderileceği gibi.

Mesafe Matrisi API'si ile neler yapabilirsiniz?

Mesafe Matrisi API'siyle kalkış ve varış noktalarından oluşan bir matris 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

Harita üzerinde ve API yanıtında başlangıç ve 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 ilerleyerek her bir kaynak 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, hedef 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: Tek bir hedefe sahip Washington, DC ve Boston, New York City, NY biçiminde 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 aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Mesafe matrisi

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

  • Her bir kalkış noktası ile 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 işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Mesafe matrisi isteğini deneyin API anahtarınızı aldıktan 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ş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ız için mesafe matrisi verilerini kullanmaya hazırlanmak üzere veri yanıtlarını keşfedin. Ayrıntılar için Mesafe matrisi yanıtları bölümüne bakın.
5 Mesafe matrisi verilerini kendi uygulamanıza entegre 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ı altında sunulan, 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?