شروع سریع
در چند دقیقه حساب بسازید، پروژه و کلید بگیرید و اولین درخواست را به نقشه نمایک بفرستید.
در این صفحه
ساخت حساب
با شماره موبایل وارد شوید؛ حساب در همان ورود اول ساخته میشود. برای امنیت بیشتر از پنل کاربری ورود دومرحلهای را روشن کنید؛ ساخت کلید محرمانه و وبهوک تایید دوباره هویت میخواهد.
پروژه
هر حساب یک پروژه پیشفرض دارد. برای جدا کردن مصرف سایت و اپ، یا محیط آزمایش و تولید، پروژه تازه بسازید. سقف هزینه، وبهوکها و گزارش مصرف برای هر پروژه جداست.
ساخت کلید
نوع کلید را انتخاب کنید
برای مرورگر و اپ «کلید عمومی»، برای سرور «کلید محرمانه».دامنهها یا IPها را محدود کنید
کلید عمومی دستکم یک دامنه مجاز میخواهد (مثلاhttps://www.example.com). کلید محرمانه را به IP سرورتان ببندید.دسترسیها را کم کنید
فقط سرویسهایی را بدهید که لازم دارید (مثلا فقطmaps:tilesوmaps:search).کلید را نگه دارید
کلید محرمانه فقط همان یک بار نمایش داده میشود؛ آن را در مدیر رازها یا متغیر محیطی سرور بگذارید.
جزئیات در کلیدهای API.
اولین درخواست
روی سرور، کلید محرمانه را از متغیر محیطی بخوانید و در سرآیند بفرستید. این درخواست سه نتیجه برای «میدان آزادی» برمیگرداند:
curl -sS "https://maps.namayek.com/v1/search?q=%D9%85%DB%8C%D8%AF%D8%A7%D9%86%20%D8%A2%D8%B2%D8%A7%D8%AF%DB%8C&limit=3" \ -H "X-Namayek-Key: $NAMAYEK_SECRET_KEY"// Node.js 18+ (fetch داخلی) — فقط روی سرورconst res = await fetch("https://maps.namayek.com/v1/search?" + new URLSearchParams({ q: "میدان آزادی", limit: "3" }), { headers: { "X-Namayek-Key": process.env.NAMAYEK_SECRET_KEY },});if (!res.ok) { const err = await res.json(); // { success: false, statusCode, code, message } throw new Error(`${err.code}: ${err.message}`);}const { items } = await res.json();console.log(items.map((i) => i.title));import os, requests res = requests.get( "https://maps.namayek.com/v1/search", params={"q": "میدان آزادی", "limit": 3}, headers={"X-Namayek-Key": os.environ["NAMAYEK_SECRET_KEY"]}, timeout=10,)res.raise_for_status()print([item["title"] for item in res.json()["items"]])در مرورگر فقط کلید عمومی و فقط از دامنهای که به کلید دادهاید:
const url = new URL("https://maps.namayek.com/v1/autocomplete");url.search = new URLSearchParams({ q: "ونک", lat: "35.757", lng: "51.41", limit: "5", key: "nmk_pk_YOUR_PUBLISHABLE_KEY" });const res = await fetch(url, { credentials: "omit" });const body = await res.json();if (!res.ok) throw new Error(body.code); // مثلا ORIGIN_NOT_ALLOWEDconsole.log(body.items);قدم بعدی
- نقشه روی سایت: شروع سریع نقشه
- دریافت رویدادها: وبهوکها
- مصرف و هزینه: مصرف و صورتحساب
- رسیدگی به خطا: خطاها و محدودیتها
آخرین بهروزرسانی: