Mesafe Matrisi API'sine genel bakış

Distance Matrix API, belirli bir ulaşım şeklinin başlangıç ve varış noktalarını içeren bir HTTPS isteğini kabul eden bir hizmettir. Her kalkış ve varış noktası kombinasyonu için seyahat mesafesi ve süresini döndürür.

Distance Matrix API'yi 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 işçilerin iş alanlarına gönderileceği veya hangi depolardan paket gönderileceği.

Mesafe Matrisi API'si ile neler yapabilirsiniz?

Mesafe Matrisi API'si ile kalkış noktaları 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 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, 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
  • Mesafe (kilometre veya mil)
  • 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, Distance Matrix API üzerinden kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.

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

Başlangıç 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 bir yola çıkma saati belirttiyseniz trafikte geçirilen süre
  • JSON
  • XML

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

1 Kurulumu tamamlayın. Google Cloud projenizi oluşturma ile başlayın ve sonraki kurulum talimatlarını uygulayın.
2 Mesafe matrisi isteğini deneme API anahtarınızı edindikten sonra doğrudan tarayıcınızdan Mesafe Matrisi API'sini 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 istek 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. 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?