Skip to main content

API ژئوکدگذاری

تبدیل آدرس به مختصات و بالعکس

آدرس‌ها را به صورت یکپارچه به مختصات جغرافیایی (ژئوکدگذاری پیشرو) و مختصات را به آدرس‌های قابل خواندن (ژئوکدگذاری معکوس) با API قدرتمند ما تبدیل کنید.

ویژگی‌های کلیدی

ژئوکدگذاری دقیق برای هر مورد استفاده

ژئوکدگذاری پیشرو

آدرس‌ها و نام‌های مکان را به مختصات جغرافیایی دقیق تبدیل کنید (عرض جغرافیایی/طول جغرافیایی)

ژئوکدگذاری معکوس

مختصات را به آدرس‌های قابل خواندن با اطلاعات مکان دقیق تبدیل کنید

تکمیل خودکار

پیشنهادات مکان و آدرس در زمان واقعی را هنگام تایپ با فیلترینگ هوشمند مکان و کنترل‌های مرزی ارائه دهید

پوشش جهانی

آدرس‌ها را در سراسر جهان با پشتیبانی از فرمت‌های آدرس بین‌المللی ژئوکدگذاری کنید

دقت بالا

دقت سطح بام برای آدرس‌ها با مختصات خاص ساختمان

نتایج ثابت

ژئوکدگذاری قابل اعتماد و تکرارپذیر با نرخ موفقیت بالا و امتیازدهی کیفیت

ژئوکدگذاری معکوس: تبدیل مختصات به آدرس

ژئوکدگذاری معکوس یک جفت عرض و طول جغرافیایی را می‌گیرد و نزدیک‌ترین آدرس قابل خواندن برای انسان را برمی‌گرداند. این فرایند معکوس ژئوکدگذاری مستقیم است که در آن از یک آدرس شروع می‌کنید و مختصات می‌گیرید. ژئوکدگذاری معکوس پشتیبان هر اپلیکیشنی است که در آن کاربر از یک نقطه روی نقشه شروع می‌کند: یافتن فروشگاه‌ها، تأیید نقاط تحویل، چک‌این‌های GPS، عکس‌های دارای برچسب جغرافیایی و عامل‌های AI که برای مختصاتی که کاربر ارائه می‌دهد به یک آدرس خیابانی قابل تأیید نیاز دارند.

MapAtlas Geocoding API برای هر مختصاتی، تفکیک کامل آدرس را برمی‌گرداند: خیابان، شماره پلاک، محله، شهر، منطقه، کد پستی و کشور، در هر یک از قالب‌های آدرس جهان. پاسخ در میان کشورها سازگار است و آن‌قدر پایدار است که بتوان آن را با رکوردهای موجود شما مقایسه کرد.

نمونه درخواست

curl -X GET "https://api.mapatlas.xyz/v1/geocode/reverse?lat=52.3676&lon=4.9041" \
  -H "Authorization: Bearer YOUR_API_KEY"

پوشش جهانی با دقت دقیق

موتور ژئوکدینگ ما دقت پیشرو در صنعت را در بیش از 190 کشور و منطقه ارائه می‌دهد. با استفاده از داده‌های OpenStreetMap و تجزیه پیشرفته آدرس، ما امتیاز اطمینان و ابرداده دقیق برای هر نتیجه ارائه می‌دهیم.

190+
کشورهای پوشش داده شده
High
نرخ دقت
<100ms
زمان پاسخ متوسط
  • امتیاز اطمینان برای هر نتیجه ژئوکدینگ
  • اجزای آدرس دقیق (خیابان، شهر، کد پستی)
  • پشتیبانی از ورودی آدرس ساختاریافته و آزاد

ویژگی‌های پیشرفته برای هر مورد استفاده

فراتر از ژئوکدینگ پایه با ویژگی‌های قدرتمند طراحی شده برای برنامه‌های تولیدی بروید. از تجزیه آدرس ساختاریافته تا پشتیبانی چندزبانه، ما ابزارهای مورد نیاز برای ساخت خدمات پیچیده مبتنی بر مکان را فراهم می‌کنیم.

نرمال‌سازی آدرس

استاندارد کردن و پاک‌سازی فرمت‌های آدرس ناسازگار به اجزای ساختاریافته و تأیید شده

پشتیبانی چندزبانه

بازگرداندن نتایج به چندین زبان با پشتیبانی یونیکد برای برنامه‌های جهانی

تکمیل خودکار و پیشنهادات

پیشنهادات آدرس بلادرنگ در حین تایپ کاربران برای UX و دقت بهتر

سازگار با GDPR

معماری حریم خصوصی‌محور بدون نگهداری داده و زیرساخت میزبانی شده در اتحادیه اروپا

نرمال شده
"123 main st"
↓
123 Main Street
City, State ZIP
چندزبانه
?text=Tokyo Tower
&lang=ja

// 東京タワー
// 日本
تکمیل خودکار
/autocomplete
?text=Eiffe

// Eiffel Tower
// Eiffel 65
سازگار با GDPR
No data logsNo retentionEU servers

مشخصات فنی

قابلیت‌های اصلی

انواع ژئوکدگذاری
پیشرو و معکوس
دقت
دقت سطح بام

پوشش و مقیاس

پوشش
جهانی، همه کشورها
تکمیل خودکار
پیشنهادات زمان واقعی

فرمت داده

فرمت پاسخ
JSON با جزئیات کامل
رمزگذاری
UTF-8، همه زبان‌ها

قیمت‌گذاری

سطح رایگان
10,000 ژئوکد/ماه
محدودیت‌های نرخ
نامحدود

آماده شروع هستید؟

امروز با MapAtlas شروع به ساخت کنید. رایگان ثبت‌نام کنید و دسترسی فوری به تمام API های نقشه‌برداری ما با محدودیت‌های سخاوتمندانه سطح رایگان دریافت کنید.

سوالات متداول درباره API ژئوکدگذاری

همه چیزی که باید قبل از ادغام API ژئوکدگذاری MapAtlas بدانید.

با AI می‌سازید؟ این API را مستقیماً از agent خود فراخوانی کنید.

Cursor، Copilot، Cline و agent های خودکار می‌توانند این endpoint را از طریق OpenAPI 3.1 spec عمومی یا MapAtlas MCP server استفاده کنند. Auto-discovery، بدون glue code.

مشاهده راهنمای ادغام AI

سوالات متداول درباره API ژئوکدگذاری

همه چیزی که باید قبل از ادغام API ژئوکدگذاری MapAtlas بدانید.

تفاوت بین ژئوکدگذاری مستقیم و معکوس چیست؟
ژئوکدگذاری مستقیم یک آدرس متنی را به مختصات (عرض و طول جغرافیایی) تبدیل می‌کند. ژئوکدگذاری معکوس برعکس عمل می‌کند: مختصات را می‌گیرد و نزدیک‌ترین آدرس را برمی‌گرداند. API ژئوکدگذاری MapAtlas هر دو را در یک ادغام واحد پشتیبانی می‌کند.
ژئوکدگذاری MapAtlas چقدر دقیق است؟
ژئوکدگذاری MapAtlas از ترکیبی از پایگاه‌داده‌های آدرس رسمی، داده‌های OpenStreetMap و غنی‌سازی داده‌های اختصاصی برای ارائه دقت در سطح خیابان در سراسر اروپا و جهان استفاده می‌کند. امتیازات اطمینان با هر نتیجه بازگردانده می‌شوند تا برنامه شما بتواند تطابق‌های نامطمئن را به شیوه مناسب مدیریت کند.
آیا می‌توانم به صورت دسته‌ای ژئوکد کنم؟
بله. MapAtlas از ژئوکدگذاری دسته‌ای از طریق API ما با حداکثر 1,000 آدرس در هر درخواست پشتیبانی می‌کند. این برای مهاجرت پایگاه‌داده‌های آدرس، غنی‌سازی داده‌های CRM یا پردازش آدرس‌های تحویل ایده‌آل است.
آیا API ژئوکدگذاری با GDPR مطابقت دارد؟
همه درخواست‌های ژئوکدگذاری روی سرورهای مبتنی بر اتحادیه اروپا پردازش می‌شوند و هیچ آدرس یا مختصاتی فراتر از چرخه حیات درخواست ذخیره نمی‌شود. MapAtlas در مراکز داده اروپایی دارای گواهی ISO 27001 اجرا می‌شود و با GDPR مطابقت دارد.
API ژئوکدگذاری چه فرمت‌هایی را برمی‌گرداند؟
نتایج به صورت JSON با اجزای آدرس ساختاریافته (خیابان، شهر، کد پستی، کشور)، مختصات و امتیاز اطمینان بازگردانده می‌شوند. خروجی GeoJSON نیز پشتیبانی می‌شود.
چطور طول و عرض جغرافیایی را به آدرس تبدیل کنم؟
از endpoint ژئوکدینگ معکوس استفاده کنید. lat و lng را به‌عنوان query parameter بفرستید و API نزدیک‌ترین آدرس پستی را با فیلدهای ساختاریافته برای خیابان، شهر، کد پستی و کشور برمی‌گرداند. این endpoint در پلن رایگان rate limit نسبتاً سخاوتمندانه‌ای دارد و در پلن‌های پولی از batch lookup هم پشتیبانی می‌کند.
چطور یک آدرس را به مختصات تبدیل کنم؟
endpoint ژئوکدینگ مستقیم را با آدرس به‌صورت یک رشته متنی صدا بزنید. API یک یا چند مکان کاندید برمی‌گرداند که هر کدام طول و عرض جغرافیایی دقیق، یک امتیاز اطمینان و اجزای منطبق‌شده دارند. خودتان تصمیم می‌گیرید نتیجه اول را بپذیرید یا یک picker به کاربر نشان بدهید.
آیا این یک بررسی‌کننده آدرس است؟
بله. ژئوکدینگ مستقیم در عمل به‌عنوان اعتبارسنجی آدرس هم عمل می‌کند: اگر API یک تطبیق با اطمینان بالا در سطح rooftop یا خیابان برگرداند، آدرس معتبر و قابل حل است. اگر بهترین تطبیق به centroid شهر یا کد پستی برسد، این سیگنالی است که در فرآیند checkout یا onboarding آدرس را مشکوک علامت‌گذاری کنید.