سرویس تعیین قطعه خیابان
سرویس تعیین قطعه خیابان، مقطعی از خیابان که نقاط (یک یا دو نقطه) درخواستی در آن قرار دارند را تعیین می‌کند. قطعه به بخشی از خیابان گفته می‌شود که بین دو تقاطع و تا فاصله مشخصی از آنها واقع شده است. سرویس دارای دو امکان مجزا به شرح زیر است:
مختصات جغرافیایی یک نقطه به سرویس ارسال شود، مقطعی که نقطه در آن واقع شده است (دو تقاطعی که نقطه مورد نظر بین آنها قرار دارد) را برمی‌گرداند. در صورتیکه موقعیت درخواستی فقط به یک تقاطع نزدیک باشد، در پاسخ تنها نام تقاطع فوق ارسال می‌شود.
مختصات جغرافیایی دو نقطه به سرویس ارسال شوند، قطعه‌ای که دو نقطه در آن قرار دارند را برمی‌گرداند.
سرویس پیش‌رو وضعیت کامل بودن یک قطعه را نیز تعیین می‌کند. قطعه کامل به قطعه‌ای گفته می‌شود که بین دو تقاطع واقع شده باشد. اگر موقعیت‌های درخواستی تنها به یک تقاطع نزدیک باشند، قطعه یافت شده کامل نیست.
قابلیت‌های سرویس
| تعیین قطعه‌ای از خیابان که نقطه مورد نظر در آن واقع شده است. |
| تعیین قطعه‌ای که دو نقطه مورد نظر در آن واقع شده اند. |
| تشخیص کامل بودن قطعه. |
ساختار کلی سرویس
get/geocode/street-segment?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
location1 |
مختصات جغرافیایی نقطه درخواستی را مشخص می‌کند. طول و عرض جغرافیایی این نقطه با , از هم تفکیک می‌شوند. درهنگام وارد کردن مختصات نقطه درخواستی، ابتدا طول جغرافیایی و سپس عرض جغرافیایی وارد شود. |
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آنها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش‌فرض |
|---|---|---|
location2 |
مختصات جغرافیایی دومین نقطه درخواستی را مشخص می‌کند. | پیش‌فرض فرستادن تنها یک موقعیت جغرافیایی است. |
request_id |
در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش‌فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست تعیین قطعه خیابان در یک موقعیت جغرافیایی
با ارسال مختصات جغرافیایی یک نقطه، مقطعی که موقعیت فوق در آن واقع شده است به همراه وضعیت کامل بودن قطعه، در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/geocode/street-segment?key=PMI_API_TOKEN&location1=51.41075,35.76554
نمونه پاسخ
{
"title": "خ. ولیعصر نرسیده به خ. سرو",
"complete_segment": false,
"status": "OK"
}
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
title |
عنوان قطعه‌ی تعیین شده است. |
complete_segment |
وضعیت کامل بودن قطعه است. اگر قطعه فوق بین دو تقاطع واقع شده باشد مقدار این پارامتر true خواهد بود. در صورتیکه نقطه و یا نقاط درخواستی در مجاورت تنها یک تقاطع باشند، قطعه یافت شده کامل نبوده و این پارامتر false را برمی‌گرداند. |
status |
نتیجه درخواست را نشان می‌دهد. برای مثال نتیجه این درخواست OK است که به معنی موفق بودن درخواست است. نتیجه پاسخ به درخواست ارسالی توسط کاربر در قالب جدول زیر ارائه شده است: جدول |
درخواست تعیین قطعه خیابان در دو موقعیت جغرافیایی
با ارسال مختصات جغرافیایی دو نقطه، مقطعی که موقعیت فوق در آن واقع شده است به همراه وضعیت کامل بودن آن در پاسخ برگردانده می‌شوند.
https://api.parsimap.ir/geocode/street-segment?key=PMI_API_TOKEN&location1=551.41076,35.75432,location2=51.41054,35.75514
نمونه پاسخ
{
"title": "خ. ولیعصر بین خ. چهاردهم و خ. شانزدهم",
"complete_segment": true,
"status": "OK"
}