Directions API hızlı referansı

Directions API (Eski), arabayla, yürüyerek, bisikletle ve toplu taşımayla yapılan yolculuklar için konumlar arasındaki yol tariflerini (ara noktalar içeren çok parçalı rotalar dahil) hesaplayan ve rotaları, ayakları ve adımları JSON veya XML biçiminde döndüren bir web hizmetidir. Eski durumundadır: Ekim 2026 itibarıyla yeni Google Cloud projeleri için etkinleştirilemez. Routes API'ye geçiş yapın.

Directions API: Temel bilgiler

  • Ürün: Directions API
  • Diğer adları: Directions API (Eski)
  • Kategori: Rotalar
  • Platform: Web hizmeti (REST)
  • Çalıştığı yer: Sunucu (arka uç kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Eski
  • Yerine geçen API: Routes API
  • Genel bakış: Directions API'ye genel bakış
  • Kullanılabildiği bölgeler: Dünya geneli. Kapsam, bölgeye ve seyahat moduna göre değişir (toplu taşıma, toplu taşıma sağlayıcılarından alınan verilere bağlıdır). (kapsam ayrıntıları)

Directions API: Ne zaman kullanılır?

Directions API'yi şu durumlarda kullanın:

  • Directions API'nin (eski) etkin olduğu ve maps/api/directions çağrısı yapan mevcut bir Google Cloud projeniz var.
  • Mevcut bir projede JSON veya XML biçiminde arabayla, yürüyerek, bisikletle ya da toplu taşımayla (yalnızca toplu taşıma dışı modlar için yol noktaları) yol tarifi almak için sunucu tarafı yol tariflerine ihtiyacınız vardır.

Directions API'yi şu durumlarda kullanmayın:

  • Yeni bir Google Cloud projesi başlatıyorsunuz. Ekim 2026'dan itibaren Directions API (Eski) yeni projeler için etkinleştirilemeyecek. Bunun yerine Routes API'yi kullanın.
  • Yeni yönlendirme özelliklerine ve daha iyi performansa ihtiyacınız varsa Bunun yerine Routes API'yi kullanın.
  • Tek bir istekte birçok başlangıç ve hedef noktası için seyahat sürelerine ve mesafelerine ihtiyacınız varsa. Bunun yerine Routes API'yi kullanın.

Directions API: kurulum

Directions API: Sık yapılan yanlışlar

  • Sorun: Eski API'nin etkinleştirilmediği bir projeden Directions API'ye (eski) gönderilen istekler LegacyApiNotActivatedMapError hatasıyla başarısız oluyor. Düzeltme: Uygulamanın sahibi sizseniz Routes API'ye geçiş yapın. Geçiş yaparken veya uygulama güncellemesini beklerken kısa vadeli bir çözüm olarak, eski API etkinleştirme formunu doldurarak eski API'yi etkinleştirebilirsiniz. /maps/legacy sayfasına bakın.
  • Sorun: Ara noktalarda via: önekini kullanmak, bu noktaları katı geçiş noktaları haline getirir. Bu da ciddi sapmalara veya ZERO_RESULTS durumuna neden olabilir. Düzeltme: Kesin bir geçiş noktası gerekmiyorsa mola noktaları (via: ön eki olmadan) kullanın. /maps/documentation/directions/get-directions sayfasına bakın.
  • Sorun: 11 ila 25 yol noktası, optimize:true, trafiğe duyarlı süreler (duration_in_traffic) veya side_of_road ya da heading konum değiştiricileri içeren istekler, daha yüksek ücretli Directions Advanced (Pro) SKU'su üzerinden faturalandırılır. Düzeltme: Bu özellikleri yalnızca ihtiyacınız olduğunda kullanın. Essentials SKU'sunda kalmak için ara noktaları 10 veya daha az sayıda tutun ve optimize:true, departure_time (sürüş için), side_of_road ve heading parametrelerini çıkarın. /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku adresini inceleyin.
  • Sorun: Sürüş için departure_time geçmişte olamaz (istek INVALID_REQUEST ile başarısız olur). departure_time olmadan rota ve süre, zamandan bağımsız ortalama trafiği kullanır ve duration_in_traffic döndürülmez. Düzeltme: duration_in_traffic elde etmek için departure_time değerini now veya mode=driving ile gelecekteki bir zamana ayarlayın. duration_in_traffic döndüren istekler, Directions Advanced (Pro) SKU'su üzerinden faturalandırılır. /maps/documentation/directions/get-directions sayfasına bakın.