پرش به محتوا

ماتریس فاصله

زمان و فاصلهٔ رانندگی چند مبدأ تا چند مقصد در یک درخواست.

POST https://api.uttamap.ir/v1/matrix

curl -X POST https://api.uttamap.ir/v1/matrix -H "X-Api-Key: um_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"sources":[[35.6997,51.3380]],"targets":[[35.7575,51.4100],[35.7219,51.3347]],"mode":"car"}'
{ "durations_s": [[586, 304]], "distances_m": [[11645, 4751]] }
  • هر نقطه [lat, lng] است.
  • حداکثر ۲۵ مبدأ × ۲۵ مقصد (۶۲۵ جفت) در هر درخواست.
  • شمارش به‌ازای هر جفت است: ۲ مبدأ × ۳ مقصد = ۶ درخواست.
  • جفتی که مسیر ندارد null برمی‌گرداند.

کاربرد رایج: پیدا کردن نزدیک‌ترین پیک یا شعبه، و محاسبهٔ هزینهٔ ارسال بر اساس مسیر واقعی به‌جای فاصلهٔ هوایی.