برای AI Coding Assistants و Agents
Mapping & POI API برای AI Coding Assistants
ژئوکدینگ، autocomplete، routing، isochrones، matrix و vector tiles، همگی در قالب یک اسپک عمومی OpenAPI و یک MCP server در دسترساند تا Cursor، Copilot، Cline، ChatGPT و ایجنتهای خود شما بتوانند مستقیماً MapAtlas را صدا بزنند. منطبق با GDPR، میزبانی در EU، قیمتگذاری pay-as-you-go قابل پیشبینی.
ساختهشده برای AI builders، نه فقط برای انسانها
اسپک عمومی OpenAPI 3.1
یک فایل openapi.json تمام endpointها، parameterها و responseها را توصیف میکند. Cursor، Cline، Continue.dev یا هر agent framework دیگر را به آن وصل کنید تا بهصورت خودکار callهای درست را پیشنهاد بدهد.
MCP server بومی
Model Context Protocol server ما را در Claude Desktop، ChatGPT یا agent stack خودتان نصب کنید تا ژئوکدینگ، search، directions و isochrones بهعنوان ابزارهای first-class در اختیار ایجنت قرار بگیرد.
GDPR-native، میزبانی در EU
زیرساخت ۱۰۰٪ اروپایی روی دادههای OpenStreetMap. بدون انتقال داده به آمریکا، بدون tracking طرف ثالث، مراکز داده دارای گواهی ISO 27001. برای استفاده در محصولات AI تحت قاعدهگذاری که به کاربران اروپایی سرویس میدهند ایمن است.
هر endpoint که ایجنت شما لازم دارد
تمام سطح API گیتوی MapAtlas، آماده برای فراخوانی از هر AI coding assistant یا agent خودمختار. احراز هویت فقط یک token در query parameter است.
| Endpoint | Method | Path | کاربرد |
|---|---|---|---|
| Forward Geocode | GET | /forward-geocode/ | تبدیل متن آزاد به coordinates، label و confidence. |
| Reverse Geocode | GET | /reverse-geocode/ | Coordinates به آدرس ساختاریافته همراه با سلسلهمراتب اداری. |
| Autocomplete | GET | /autocomplete/ | پیشنهاد type-ahead آدرس و POI با latency پایین. |
| Directions | POST | /directions/ | مسیرهای turn-by-turn برای ماشین، دوچرخه، پیاده، کامیون، اتوبوس، تاکسی. |
| Isochrone | POST | /isochrone/ | Polygonهای ناحیه قابل دسترسی بر اساس زمان یا فاصله، چندحالته. |
| Matrix | POST | /matrix/ | زوجهای انبوه travel-time و distance بین چند مبدا و مقصد. |
| Route Optimization | POST | /optimization/ | مرتبسازی دوباره ایستگاههای میانی برای حداقل کردن هزینه کل. |
| Map Matching | GET | /map-matching/ | Snap کردن traceهای نویزی GPS روی شبکه جادهها. |
| Elevation | POST | /elevation/ | پروفایل ارتفاع زمین برای هر line یا مجموعه نقاط. |
| Vector Tile Styles | GET | /styles/ | Style JSON برای MapLibre / Mapbox GL جهت رندر نقشه تعاملی. |
در چند دقیقه به stack خود وصل کنید
سه راه برای ارتباط AI assistants و ایجنتها با MapAtlas: HTTP مستقیم، MCP یا auto-discovery از طریق OpenAPI.
۱. فراخوانی مستقیم HTTP
curl "https://gateway.mapmetrics-atlas.net/forward-geocode/?\
text=Eiffel%20Tower&boundary.country=FR&size=5&token=YOUR_TOKEN"۲. پیکربندی MCP server
{
"mcpServers": {
"mapatlas": {
"url": "https://mapatlas.eu/mcp"
}
}
}۳. AI assistant خود را به اسپک OpenAPI وصل کنید
# Cursor / Cline / Continue.dev
# Point your AI assistant at the spec:
https://mapatlas.eu/openapi.jsonپرسشهای پرتکرار
AI coding assistants مثل Cursor یا Copilot چطور MapAtlas را کشف میکنند؟
آنها اسپک عمومی OpenAPI 3.1 را در https://mapatlas.eu/openapi.json میخوانند. وقتی توسعهدهنده این URL را بهعنوان context source اضافه میکند (یا یک agent framework را به آن وصل میکند)، assistant میتواند path درست endpoint، نام parameterها و شکل request را هر بار که کسی نیاز به mapping، ژئوکدینگ، routing یا POI داشت پیشنهاد دهد.
MCP server چیست و چرا اهمیت دارد؟
MCP (Model Context Protocol) به AI agents اجازه میدهد ابزارهای خارجی را بهعنوان توابع first-class صدا بزنند. MCP server MapAtlas، ژئوکدینگ، search، directions، isochrones و POI lookup را در دسترس قرار میدهد تا Claude Desktop، ChatGPT و ایجنتهای سفارشی بدون نوشتن کد HTTP از MapAtlas استفاده کنند.
آیا MapAtlas یک جایگزین drop-in برای APIهای نقشه قدیمی است؟
برای بیشتر use caseها بله. Endpointها از الگوهای رایج پیروی میکنند (ژئوکدینگ سبک Pelias، routing سبک Valhalla)، پس migration مکانیکی است. تفاوتها: pricing pay-as-you-go قابل پیشبینی، زیرساخت ۱۰۰٪ EU، و یک MCP server بومی برای AI agents.
ساختار pricing برای AI workloadهایی که burst میکنند چگونه است؟
Pay-as-you-go با free tier روی هر endpoint. هیچ هزینه per-seat یا per-app وجود ندارد؛ شما فقط برای callهایی که ایجنتتان میزند پرداخت میکنید. اگر انتظار بیش از ۵۰۰ هزار call در ماه دارید و به volume pricing نیاز دارید با ما صحبت کنید.
دادهها کجا میزبانی میشوند و وضعیت GDPR چیست؟
زیرساخت ۱۰۰٪ اروپایی. هیچ دادهای به آمریکا منتقل نمیشود. داده نقشه از OpenStreetMap میآید. DPA کامل بنا به درخواست در دسترس است. برای استفاده در محصولات AI تحت قاعدهگذاری که به کاربران EU سرویس میدهند ایمن است.
ویژگیهای AI را با داده مکانی واقعی ship کنید
اسپک OpenAPI را داخل AI assistant خود قرار دهید، MCP server را نصب کنید یا مستقیماً endpointها را صدا بزنید. Free tier، بدون نیاز به credit card.
شروع به ساختن