ماتریس فاصله

درخواست#

GET /v1/matrix زمان و فاصله سفر میان چند مبدا و چند مقصد را در یک درخواست می‌دهد؛ مثلا نزدیک‌ترین پیک یا شعبه به یک سفارش. دسترسی maps:routing، سرویس maps.matrix.

curl -sS "https://maps.namayek.com/v1/matrix?coordinates=51.41,35.757;51.338,35.6997;51.389,35.6892&sources=0&annotations=duration,distance" \  -H "X-Namayek-Key: $NAMAYEK_SECRET_KEY"

const m = await NamayekMaps.matrix(  [[51.41, 35.757], [51.338, 35.6997], [51.389, 35.6892]],  { key: "nmk_pk_YOUR_PUBLISHABLE_KEY", sources: [0], annotations: ["duration", "distance"] },);console.log(m.durations[0]); // ثانیه تا هر مقصد؛ null یعنی راه نیست

پارامترها#

محدودیت‌ها#

• نقطه‌ها: ۲ تا سقف (پیش‌فرض ۱۰۰).
• مبدا و مقصد: هر کدام حداکثر ۵۰ (پیش‌فرض).
• خانه‌ها (مبدا × مقصد): حداکثر ۲۵۰۰ (پیش‌فرض)؛ بیشتر از آن MATRIX_TOO_LARGE با سقف‌ها در جزئیات خطا.

هزینه#

واحد ماتریس تعداد مبدا × تعداد مقصد است و پیش از تماس با مسیریاب حساب می‌شود؛ همان عدد در سرآیند X-Namayek-Units پاسخ هم می‌آید.

پاسخ و خانه‌های خالی#

{  "code": "OK",  "profile": "car",  "dataVersion": "2026-10-20",  "durations": [[0, 612.8, 431.5]],  "distances": [[0, 5230.4, 3890.1]],  "sources": [{ "location": [51.41, 35.757], "snapDistance": 3.2 }],  "destinations": [    { "location": [51.41, 35.757], "snapDistance": 3.2 },    { "location": [51.338, 35.6997], "snapDistance": 0 },    { "location": [51.389, 35.6892], "snapDistance": 1.1 }  ],  "attribution": "© مشارکت کنندگان OpenStreetMap"}

ردیف = مبدا و ستون = مقصد؛ زمان به ثانیه و فاصله به متر با یک رقم اعشار. null یعنی میان آن دو نقطه راهی نیست. نقطه‌ای که به هیچ راهی نزدیک نیست POINT_NOT_ROUTABLE با شماره همان نقطه می‌گیرد.