ماتریس فاصله
زمان و فاصلهٔ رانندگی چند مبدأ تا چند مقصد در یک درخواست.
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برمیگرداند.
کاربرد رایج: پیدا کردن نزدیکترین پیک یا شعبه، و محاسبهٔ هزینهٔ ارسال بر اساس مسیر واقعی بهجای فاصلهٔ هوایی.