Distance Matrix API (Eski) genel bakış

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Giriş

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

Distance Matrix API'yi (eski) neden kullanmalısınız?

Olası birden fazla başlangıç ve varış noktası arasındaki en verimli seyahat rotalarını belirlemek için Distance Matrix API'yi (Eski) kullanabilirsiniz. Örneğin, hangi çalışanların iş yerlerine gönderileceği veya paketlerin hangi depolardan gönderileceği gibi.

Distance Matrix API (eski) ile yapabilecekleriniz

Distance Matrix API (Eski) ile başlangıç ve varış noktalarından oluşan bir matris için seyahat mesafesi ve süresi sağlayabilirsiniz. Sürüş, bisiklet, toplu taşıma veya yürüyüş gibi ulaşım modlarının yanı sıra otobüs, metro, tren, tramvay veya raylı sistem gibi toplu taşıma modları dahil olmak üzere çeşitli seçenekler belirtebilirsiniz.

Distance Matrix API (Eski), başlangıç ve bitiş noktaları arasındaki önerilen rotaya göre bilgi sağlar. Aşağıdaki mesafe verilerini isteyebilirsiniz:

  • Seçilen seyahat modunun mesafesi
  • Kilometre veya mil cinsinden mesafe
  • Trafikte tahmini seyahat süresi

Haritada ve API yanıtında başlangıç ve varış noktalarını gösteren harita

Distance Matrix API'nin (eski) işleyiş şekli

Distance Matrix API (Eski), herhangi bir sayıda başlangıç noktası ve hedef kullanır ve her başlangıç noktası ile istenen tüm hedefler arasındaki mesafeyi ve seyahat süresini döndürür. İstekteki ilk başlangıç noktasından başlayarak bir sonraki noktaya adım adım ilerler.

Örneğin, isteğinizde başlangıç noktası olarak A ve B, hedef olarak C ve D belirtiliyorsa mesafeler ve seyahat süresi şu sırayla döndürülür:

  • A - C
  • A'dan D'ye
  • B2C
  • B'den D'ye

Aşağıdaki örnekte, iki başlangıç noktası (Washington, DC ve Boston) ve tek bir varış noktası (New York City, NY) için JSON biçiminde bir istek gösterilmektedir:

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 (Eski) aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler ö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 girin.

  • Her başlangıç noktası ile her varış noktası arasındaki mesafe ve seyahat süresi
  • Sürüş modunu ve kalkış saatini belirttiyseniz trafikte geçen süre
  • JSON
  • XML

Distance Matrix API'yi (eski) kullanma

1 Kurulumu tamamlama Google Cloud projenizi ayarlama ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Mesafe matrisi isteği göndermeyi deneyin API anahtarınız olduğunda Distance Matrix API'yi (eski) 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ıç ve hedef noktası sağlayan bir istek deneyin. Hesaplamaları kısıtlamak için isteğe bağlı parametreler (ör. belirli bir kalkış saati veya rota kısıtlamaları) hakkında bilgi edinin. Distance Matrix (Eski) isteği 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ı 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ı

Bu API'yi, aşağıdaki istemci kitaplıklarından biri aracılığıyla istediğiniz dilde çağırabilirsiniz:

Google Haritalar Hizmetleri için Java İstemci Kitaplığı, Python İstemci Kitaplığı, Go İstemci Kitaplığı ve Node.js İstemci Kitaplığı, Apache 2.0 Lisansı kapsamında açık kaynaklı olan, topluluk destekli istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. Kurulum talimatlarını ve örnek kodu da GitHub'da bulabilirsiniz.

Sırada ne var?