نقشه ایستا

تصویر نقشه با یک نشانی: نشانگر، مسیر، دوربین خودکار، قالب تصویر، انتساب و کش.

در این صفحه

ساختار نشانی
پارامترها
نشانگر و مسیر
دوربین خودکار
قالب و کیفیت
انتساب
کش
محدودیت‌ها

ساختار نشانی

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

ساختار نشانی

https://maps.namayek.com/v1/static/{styleId}/{camera}/{width}x{height}[@2x].{png|jpg|webp}?markers=…&path6=…&key=… camera = auto       | lng,lat,zoom[,bearing[,pitch]]      zoom 0..20 · bearing 0..360 · pitch 0..60 markers = lng,lat[,rrggbb][,label] | lng,lat[,rrggbb][,label] | …

نمونه

<img  src="https://maps.namayek.com/v1/static/namayek-light/51.389,35.6892,13/600x400@2x.png?markers=51.389,35.6892,e11d48,1&key=nmk_pk_YOUR_PUBLISHABLE_KEY"  width="600" height="400" alt="نقشه موقعیت فروشگاه">

const src = NamayekMaps.staticUrl({  key: "nmk_pk_YOUR_PUBLISHABLE_KEY",  camera: "auto",  width: 600,  height: 400,  ratio: 2,  markers: [{ at: [51.389, 35.6892], color: "#e11d48", label: "1" }],  path: [[51.389, 35.6892], [51.4, 35.7], [51.42, 35.73]],});document.querySelector("img#map").src = src;

curl -sS "https://maps.namayek.com/v1/static/namayek-light/auto/600x400@2x.png?markers=51.389,35.6892,e11d48,1%7C51.42,35.73" \  -H "X-Namayek-Key: $NAMAYEK_SECRET_KEY" \  -o map.png

پارامترها

بخش‌های مسیر نقشه ایستا
پارامتر	نوع	لزوم	پیش‌فرض	توضیح
`styleId`	`string`	لازم	—	سبک سیستمی (namayek-light و…) یا سبک شما (u-…).
`camera`	`auto \| lng,lat,zoom[,bearing[,pitch]]`	لازم	—	zoom از ۰ تا ۲۰، bearing از ۰ تا ۳۶۰، pitch از ۰ تا ۶۰؛ auto قاب را از روی نشانگرها و مسیر می‌سازد.
`size`	`{w}x{h}[@2x].{png\|jpg\|webp}`	لازم	—	عرض و ارتفاع ۶۴ تا سقف (پیش‌فرض ۱۲۸۰)؛ @2x برای صفحه‌های پرتراکم.

پارامترهای نقشه ایستا
پارامتر	نوع	لزوم	پیش‌فرض	توضیح
`markers`	`lng,lat[,rrggbb][,label]\|…`	اختیاری	—	نشانگرها با \| جدا می‌شوند؛ برچسب ۱ یا ۲ نویسه از رقم و حرف لاتین یا رقم فارسی. حداکثر ۴۰۹۶ نویسه.
`path / path6`	`encoded polyline`	اختیاری	—	مسیر با دقت ۵ یا ۶ رقم، حداکثر ۶۰۰۰ نویسه.
`pathColor`	`rrggbb`	اختیاری	4f39cd	رنگ خط مسیر.
`pathWidth`	`1..12`	اختیاری	4	پهنای خط به پیکسل.
`pathOpacity`	`0.1..1`	اختیاری	0.9	شفافیت خط.
`padding`	`0..200`	اختیاری	40	حاشیه دوربین خودکار به پیکسل.
`lang`	`fa \| en \| fa-en`	اختیاری	fa	زبان برچسب‌های نقشه.
`tileset`	`string`	اختیاری	پیش‌فرض سبک	مجموعه کاشی (مثلا iran).
`attribution`	`1 \| 0`	اختیاری	1	۰ فقط وقتی مجاز است که شما خودتان انتساب را کنار تصویر نشان دهید.
`key`	`string`	یا سرآیند	—	فقط کلید عمومی nmk_pk_ در نشانی؛ روی سرور کلید را در سرآیند X-Namayek-Key بفرستید.

نشانگر و مسیر

نشانگر: lng,lat و به دلخواه رنگ (rrggbb بی #) و برچسب ۱ یا ۲ نویسه؛ رنگ پیش از برچسب می‌آید. چند نشانگر با | جدا می‌شوند.
مسیر: polyline رمزگذاری‌شده Google در path (دقت ۵) یا path6 (دقت ۶)، با رنگ، پهنا و شفافیت دلخواه. هندسه پاسخ مسیریابی با geometry=polyline6 مستقیم قابل استفاده است.
staticUrl() کیت توسعه نشانی یکتا می‌سازد: ترتیب ثابت پارامترها، رنگ کوچک بی #، مسیر با polyline6 و حذف مقدارهای پیش‌فرض تا کش بیشترین استفاده را داشته باشد.

با camera=auto سرور قاب را طوری می‌چیند که همه نشانگرها و مسیر با حاشیه padding (پیش‌فرض ۴۰ پیکسل) دیده شوند؛ یک نقطه تنها با زوم ۱۵ نمایش داده می‌شود. auto بی نشانگر و بی مسیر خطای INVALID_PARAM با دلیل auto_needs_overlay می‌دهد.

قالب و کیفیت

png برای کیفیت کامل، jpg و webp برای حجم کمتر (کیفیت را تیم نمایک تنظیم می‌کند).
@2x تصویر دوبرابر برای صفحه‌های پرتراکم می‌سازد و هزینه‌اش همان یک واحد است؛ عرض و ارتفاع ضربدر ۲ نباید از ۲۵۶۰ پیکسل بگذرد.
در HTML همیشه width و height تگ img را بدهید تا صفحه هنگام بارگذاری نپرد.

عرض و ارتفاع: ۶۴ تا سقف پروژه (پیش‌فرض ۱۲۸۰، بیشینه ۲۰۴۸).
نشانگر: پیش‌فرض تا ۵۰ (بیشینه ۱۰۰)؛ نقطه مسیر: پیش‌فرض تا ۱۰۰۰ (بیشینه ۵۰۰۰).
طول کل نشانی: ۸۱۹۲ بایت.

آخرین به‌روزرسانی: ۱ آبان ۱۴۰۵