Directions API'ye (eski) genel bakış

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Directions API (Eski), bir HTTP isteğini kabul eden ve konumlar arasında JSON veya XML biçimli yol tarifleri döndüren bir hizmettir.

Directions API'yi neden kullanmalısınız?

Directions API ile toplu taşıma, araba, yaya veya bisiklet gibi çeşitli ulaşım modları için yol tarifi alabilirsiniz.

Directions API ile neler yapabilirsiniz?

Directions API ile konumlar arasındaki yol tariflerini hesaplayabilir ve aşağıdaki ayrıntıları alabilirsiniz:

  • Toplu taşıma, araba, yaya veya bisiklet gibi çeşitli ulaşım yöntemleri için yol tarifleri
  • Bir dizi ara nokta kullanarak çok parçalı yol tarifleri.
  • Kaynakları, hedefleri ve ara noktaları metin dizeleri (örneğin, "Chicago, IL" veya "Darwin, NT, Avustralya"), yer kimlikleri ya da enlem/boylam koordinatları gibi birden fazla şekilde belirtebilirsiniz.

Directions API'nin işleyiş şekli

Yol Tarifi API'si, yol tariflerini hesaplarken en verimli rotaları döndürür. Ürün, en verimli rotayı belirlerken aşağıdaki seyahat unsurlarını dikkate alır:

  • Seyahat süresi (birincil)
  • Mesafe
  • Dönüş sayısı

Aşağıdaki örnek istek, Toronto, Ontario'dan Montreal, Quebec'e giden sürüş yol tariflerini JSON biçiminde döndürür:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

Kaynaklar

Aşağıdaki tabloda, Directions API aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmektedir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Yol tarifi

Yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde tedarik kaynakları ve hedefleri. Ayrıntılar için gerekli parametreler konusuna bakın.

Rotalara, bölümlere ve adımlara ayrılmış ayrıntılı yol tarifleri. Ayrıntılar için Yol tarifi yanıtları bölümüne bakın.
  • JSON
  • XML

Directions API'yi kullanma

1 Kurulumu yapın. Google Cloud projenizi oluşturarak başlayın ve kurulum talimatlarını tamamlayın.
2 Demoyu deneyin API anahtarınız ve denemek istediğiniz bir bulut projeniz olduğunda yol tarifi demosunu ücretsiz olarak deneyebilirsiniz. Directions API demosuna bakın.
3 İstek oluşturma Örnek isteklere göz atın ve seyahat modları, ara noktalar ve rota kısıtlamaları gibi sağlayabileceğiniz seçenekler hakkında bilgi edinin. Yol tarifi örneklerine bakın.
4 Yanıtlarla ilgili temel bilgileri öğrenme Uygulamanızda yol tarifi verilerini kullanmaya hazırlanmak için veri yanıtlarını inceleyin. Ayrıntılar için Yol tarifi yanıtları bölümüne bakın.
5 Yön verilerini kendi uygulamanıza dahil edin. Bu verileri kullanarak seyahat mesafesini ve süresini hesaplayabilirsiniz.

Kullanılabilir istemci kitaplıkları

Bu API'yi aşağıdaki istemci kitaplıklarından birini kullanarak tercih ettiğiniz dilde çağırın:

Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı olarak sunulan ve topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?