Directions API'ye genel bakış

Directions API, bir HTTP isteğini kabul eden ve konumlar arasındaki yol tariflerini JSON veya XML biçiminde döndüren bir hizmettir.

Directions API'yi kullanmanın avantajları

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 hesaplayabilirsiniz. Bu hesaplamalarda aşağıdaki ayrıntılar da yer alır:

  • Toplu taşıma, araba, yürüyüş veya bisiklet gibi çeşitli ulaşım yöntemleri için yol tarifleri.
  • Bir dizi yol noktası kullanan çok parçalı yol tarifleri.
  • Başlangıç noktalarını, varış noktalarını ve yol noktalarını metin dizeleri (ör. "Chicago, IL" veya "Darwin, NT, Avustralya"), yer kimlikleri ya da enlem/boylam koordinatları dahil olmak üzere birden çok şekilde belirtebilirsiniz.

Directions API'nin işleyiş şekli

Directions API, yol tariflerini hesaplarken en verimli rotaları döndürür. Ürün, en verimli rotayı belirlerken aşağıdaki seyahat öğelerini dikkate alır:

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

Aşağıdaki örnek istek, Toronto, Ontario'dan Montreal, Quebec'e giden sürüş rotasını 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, döndürdüğü verilerle birlikte Directions API üzerinden kullanılabilen kaynaklar özetlenmiştir.

Veri kaynakları Döndürülen veriler Döndürülen biçim
Yol tarifi

Kaynakları ve hedefleri yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde sağlayın. Ayrıntılar için gerekli parametrelere bakın.

Rotalara, etaplara 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 Hazırlanın. Google Cloud projenizi oluşturma ile başlayın ve sonraki kurulum talimatlarını uygulayın.
2 Demoyu deneyin API anahtarınız ve bulut projeniz olduğunda, yol tarifi demosunu ücretsiz olarak deneyebilirsiniz. Directions API demosunu inceleyin.
3 İstek oluşturma Örnek isteklere göz atın ve seyahat modları, yol işaretleri ve rota kısıtlamaları gibi sağlayabileceğiniz seçenekler hakkında bilgi edinin. Yol tarifi örnekleri bölümüne bakın.
4 Yanıtla ilgili temel bilgileri anlama Uygulamanızda yol tarifi verilerini kullanmaya hazırlanmak için veri yanıtlarını keşfedin. Ayrıntılar için Yol tarifi yanıtları başlıklı makaleye göz atın.
5 Yön verilerini kendi uygulamanıza dahil edin. Seyahat mesafesini ve süresini hesaplamak için bu verileri kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından birini kullanarak 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ı kapsamında açık kaynaklı, topluluk destekli istemci kitaplıklarıdır. Bunları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?