Menu
Menu
سرویس تبدیل آدرس به موقعیت
از سرویس تبدیل آدرس به موقعیت (Geocoding API) میتوانید برای تبدیل یک آدرس نوشتاری به یک مختصات جغرافیایی استفاده کنید.
شیوهی فراخوانی:
GET:
https://api.neshan.org/v4/geocoding?address=ADDRESS
Headers:
Api-Key: YOUR_API_KEY
پارامتر های وروردی:
- address: عبارت جستجو
فرمت پاسخ:
{
"location": {
"x": 59.58030012321334,
"y": 36.30608816378243
},
"status": "OK"
}
اجزای این پاسخ بصورت زیر میباشند:
- status: وضعیت کلی پاسخ را نشان میدهد.
- location: مختصات معادل با آدرس وارد شده را نشان میدهد که شامل اجزای زیر است
- x: طول جغرافیایی
- y: عرض جغرافیایی
جهت دریافت نقاط دقیق تر در نسخه فعلی geocoding نکات زیر را تا حد امکان رعایت فرمایید :
-
تا جایی که ممکن است ترتیب قرار گرفتن اجزا آدرس به صورت زیر باشد
استان + شهر / روستا + میدان + خیابان + کوچه + پلاک
نکته: شماره پلاک در شهرهای تهران، مشهد، تبریز، کرج قابل استفاده است. -
حتما همه اجزا آدرس با جدا کننده space از هم جدا شده باشند.
متال : شهیدبابایی بهتر است با جدا کننده به صورت شهید بابایی ارسال شود. -
مشخصات مربوط به poi ها مانند نام ساختمان طبقات و برجها تا جایی که ممکن است از آدرس حذف شود.
مثال: آذربایجان شرقی تبریز خیابان ارتش شمالی کوچه بازارچه رنگی ساختمان رضوی
به آدرس زیر تغییر یابد
آذربایجان شرقی تبریز خیابان ارتش شمالی کوچه بازارچه رنگی - اگر مقصد آدرس روستا است بعد از استان بلافاصله نام روستا آورده شود و دیگر نیازی به نام شهر نیست
نمونه کد برای وب سرویس تبدیل آدرس به نقطه جغرافیایی :
این نمونه کد ها برای دو زبان PHP و JavaScript طراحی شده اند شما برای استفاده از نمونه کد ها نیاز به دو کلید دسترسی مخصوص سرویس تبدیل آدرس به نقطه جغرافیایی و کیت توسعه نقشه وب نشان دارید.
کلید دسترسی سرویس (api-key)
برای ساخت کلید دسترسی (api-key) مناسب برای این سرویس شما باید در پنل ساخت کلید دسترسی گزینه سرویس ها و سپس سرویس تبدیل ادرس به نقطه را انتخاب کنید.
این را هم در نظر داشته باشید برای امنیت بیشتر کلید دسترسی خود و جلو گیری از سواستفاده شدن از آن IP سرور خود را نیز میتوانید در فیلد دامنه/Ip های مجاز وارد کنید.