Distance Matrix API hızlı referansı

Distance Matrix API (Eski), her bir çift arasındaki önerilen rotaya göre başlangıç ve varış noktaları matrisi için seyahat mesafesini ve süresini döndüren bir web hizmetidir. Seyahat modunu (sürüş, yürüme, bisiklet, toplu taşıma), toplu taşıma modlarını, birimleri ve trafiğe dayalı süreler için kalkış saatini ayarlayabilirsiniz. JSON veya XML döndürür.

Distance Matrix API: Temel bilgiler

  • Ürün: Distance Matrix API
  • Diğer adları: Distance Matrix API (Eski), Distance Matrix (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ış: Distance Matrix API'ye genel bakış

Distance Matrix API: Ne zaman kullanılır?

Distance Matrix API'yi şu durumlarda kullanın:

  • Distance Matrix API'nin (eski) etkin olduğu ve /maps/api/distancematrix yöntemini çağıran mevcut bir projeyi yönetiyorsunuz.
  • Bir sunucudan birden fazla başlangıç noktası ile birden fazla hedef arasındaki seyahat mesafesini ve süresini öğrenmeniz gerekir.
  • departure_time ve isteğe bağlı olarak traffic_model kullanarak sürüş için trafikteki süreleri öğrenmeniz gerekir.

Distance Matrix API'yi şu durumlarda kullanmayın:

  • Yeni bir Google Cloud projesi başlatıyorsunuz. Ekim 2026'dan itibaren Distance Matrix API (Eski) yeni projeler için etkinleştirilemeyecek. Bunun yerine Routes API'yi kullanın.
  • Yeni özelliklere veya akış yanıtları içeren en fazla 625 öğelik bir rota matrisine (computeRouteMatrix) ihtiyacınız varsa Routes API'yi kullanın.
  • Yalnızca mesafe ve süre değerleri değil, noktalar arasında adımlar ve çoklu çizgiler içeren tam bir rotaya ihtiyacınız vardır. Bunun yerine Routes API'yi kullanın.

Distance Matrix API: kurulum

Distance Matrix API: Sık yapılan hatalar

  • Sorun: Her sunucu tarafı isteği 100 öğe (başlangıç noktaları × varış noktaları) ve 25 başlangıç noktası veya 25 varış noktası ile sınırlıdır. Daha büyük istekler MAX_ELEMENTS_EXCEEDED veya MAX_DIMENSIONS_EXCEEDED döndürür. Düzeltme: Matrisi en fazla 100 öğe ve 25 başlangıç noktası veya hedef içeren isteklere bölün. /maps/documentation/distance-matrix/usage-and-billing#usage-limits adresini inceleyin.
  • Sorun: departure_time değerini belirtmezseniz rota ve süre, zamandan bağımsız ortalama trafiğe göre belirlenir ve duration_in_traffic döndürülmez. Sonuçlar zaman içinde değişiklik gösterebilir. Düzeltme: Trafiğe duyarlı süreler elde etmek için departure_time değerini now veya mode=driving ile gelecekteki bir zamana ayarlayın. Trafik isteklerinin daha yüksek bir ücretle faturalandırıldığını unutmayın. /maps/documentation/distance-matrix/distance-matrix adresini inceleyin.
  • Sorun: units parametresi yalnızca mesafe alanlarındaki metni değiştirir. Mesafe değeri her zaman metre cinsindendir. Düzeltme: distance.value ifadesini metre olarak okuyun veya görüntülemek için distance.text ifadesini kullanın. /maps/documentation/distance-matrix/distance-matrix adresini inceleyin.
  • Sorun: Distance Matrix API'yi (Eski) etkinleştirilmediği bir projeden çağırmak, status içinde REQUEST_DENIED ve LegacyApiNotActivatedMapError bağlantısı içeren bir error_message döndürür. Yapay zeka asistanları genellikle varsayılan olarak eski API kodu oluşturur. Düzeltme: Routes API'ye geçiş yapın computeRouteMatrix (X-Goog-FieldMask üstbilgisiyle). Eski API'yi form aracılığıyla yalnızca kısa vadeli bir önlem olarak etkinleştirin. /maps/legacy#LegacyApiNotActivatedMapError sayfasına bakın.