
با استفاده از این سرویس مشخصات مکانی (آدرس پستی) یک مختصات جغرافیایی به شما ارائه میگردد. برای استفاده از این روش، دو پارامتر طول و عرض جغرافیایی (latitude, longitude) از شما به عنوان ورودی گرفته و یک سری اطلاعات (استان، شهرستان، شهر، نزدیکترین معابر به آن مکان و ...) در مورد مختصات مورد نظرتان به عنوان پارامتر خروجی به شما داده میشود.
توجه: در تمام وبسرویسهای سفارشی پارسیجو، اطلاعات ورودی از طریق پارامترها، به شیوه GET یا POST دریافت و خروجی در قالب فرمت JSON برگشت داده میشود.
توجه: جهت اعتبارسنجی لازم است رشته api-key دریافت شده را در Header درخواست خود با پارامتر api-key قرار دهید. (راهنمای دریافت API Key) (نحوه ارسال api-key در هدر درخواست)
ساختار ورودی
http(s)://developers.parsijoo.ir/web-service/v1/map/?type=address
نمونه
https://developers.parsijoo.ir/web-service/v1/map/?type=address&x=Longitude&y=Latitude
پارامترهای ورودی
عنوان | مشخصات | نوع متغیر | لزوم استفاده | نام متغیر در پارامتر ورودی | توضیحات |
Longitude | طول جغرافیایی | Integer | اجباری | x | longitude |
Latitude | عرض جفرافیایی | Integer | اجباری | y | latitude |
پارامترهای خروجی
مشخصات | نوع | نام متغیر در پارامتر خروجی | توضیحات |
استان | String | state |
|
شهرستان | String | county |
|
شهر | String | city |
|
بخش | String | region |
|
منطقه | String | zone |
|
محله | String | district |
|
روستا | String | village |
|
بیشتر | String | other | آبادی، شهرک، مجتمع مسکونی و ... |
نزدیکترین معابر
| String | ways |
آدرس پستی مختصات جغرافیایی مورد نظر را نمایش می دهد. |
کدهای مربوط به پاسخ درخواست:
200 ارسال و دریافت اطلاعات به خوبی انجام شده است.
400 پارامترها ناقص هستند.
404 متدی با این نام پیدا نشده است.
405 متد فراخوانی Get یا Post اشتباه است.
500 خطا در انجام عملیات، بعدا تلاش کنید.
مثال:
ارسال مختصات جغرافیایی (51.34832,35.68880) با ساختار آدرس یابی نقشه
https://developers.parsijoo.ir/web-service/v1/map/?type=address&x=51.34832&y=35.68880
پاسخ دریافت شده از سرور به صورت زیر است:
{
"reqStatus": {
"statusCode": 200,
"message": null
},
"result": {
"state": "تهران",
"county": "تهران",
"city": "تهران",
"region": "مركزي تهران",
"zone": "منطقه 9",
"district": "شهيد دستغيب",
"village": "",
"other": "",
"ways": " بزرگراه يادگار امام, خیابان هاشمي , کوچه مطهري نژاد "
}
}