سرویس درخواست عکس
سرویس درخواست عکس، تصویری استاتیک از نقشه برای یک یا چند نقطه با سایز دلخواه را تولید می‌کند. برای تولید عکس در موقعیت و یا موقعیت‌های درخواستی باید مختصات جغرافیایی نقطه و یا نقاط، طول و عرض تصویر و مقدار بزرگنمایی آن مشخص شود.
قابلیت‌های سرویس
| درخواست عکس از یک نقطه |
| درخواست عکس از چند نقطه |
| درخواست عکس با رسم خط مستقیم و کمان بین نقاط |
| در خواست عکس در یک نقطه با بزگنمایی‌های مختلف |
ساختار کلی سرویس
get/tile/snapshot?parameters
پارامترهای ورودی
پارامترهای مورد نیاز
| پارامتر | توضیحات |
|---|---|
provider |
لایه رستر نقشه را مشخص می‌کند. می‌توانید نقشه رستر پارسی‌مپ با عنوان parsimap و یا نقشه‌های گوگل با نام googlesat و googlemap را به عنوان نقشه پس‌زمینه تصویر درخواستی خود انتخاب نمایید. |
labeled_locations |
مختصات جغرافیایی نقطه و یا نقاط درخواستی را مشخص می‌کند. این نقاط با | از هم جدا می‌شوند. هر نقطه دارای طول و عرض جغرافیایی است و با , از هم تفکیک می‌شوند.. |
height |
ارتفاع عکس درخواستی را مشخص می‌کند. |
width |
طول عکس درخواستی را مشخص می‌کند. |
zoom |
مقدار بزرگنمایی عکس درخواستی را مشخص می‌کند. عدد بزرگنمایی از 1 تا 18 است. |
exact_size |
اندازه عکس بازگشتی را مشخص می‌کند. سایز عکس بازگشتی می‌تواند به دو صورت زیر تعیین شود: - اندازه تصویر استاتیک دقیقا برابر با اندازه height و width تعیین شده در ورودی باشد. در این حالت مقدار این پارامتر باید true باشد. - سایز تصویر درخواستی برابر است با حداقل سایزی که نقاط درخواستی را در آن سایز نمایش داده می‌شوند. در این حالت مقدار این پارامتر باید false باشد. |
پارامترهای اختیاری
پارامترهای اختیاری آپشن‌ها و امکانات مختلف سرویس را ارائه می‌دهند. ارسال آن‌ها جهت استفاده از سرویس اجباری نیست.
| پارامتر | توضیحات | مقدار پیش‌فرض |
|---|---|---|
draw_arc |
کمان بین نقاط درخواستی را رسم می‌کند و در عکس بازگشتی نمایش می‌دهد. | مقدار پیش‌فرض، عدم ترسیم کمان (false) است. |
draw_line |
خط بین نقاط درخواستی را به‌ترتیب از اولین نقطه تا آخرین نقطه ورودی ترسیم می‌کند و در عکس بازگشتی نمایش می‌دهد. | مقدار پیش‌فرض، عدم ترسیم کمان (false) است. |
request_id |
در صورت ست شدن پارامتر فوق، به صورت یکتا در روز می‌توان برای پیگیری استفاده نمود. | به صورت پیش‌فرض، عدم پیگیری در روز است. |
نمونه درخواست
درخواست عکس از یک نقطه
با ارسال مختصات جغرافیایی نقطه درخواستی، ابعاد طول و عرض عکس و مقدار بزرگنمایی، عکس استاتیک موقعیت مورد نظر در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/tile/snapshot?key=PMI_API_TOKEN&provider=parsimap&labeled_locations=51.33775, 35.69975&height=500&width=500&draw_arc=false&draw_line=false&zoom=16&request_id=false
نمونه پاسخ
نتیجه درخواست
نتیجه پاسخ به درخواست از سرویس در header ست شده است و در جدول پیش‌رو ارائه شده است.
درخواست عکس از دو نقطه همراه با ترسیم کمان بین دو نقطه
با ارسال مختصات جغرافیایی دو نقطه و فعال کردن گزینه draw_arc، پس از تعیین طول و عرض تصویر، عکس از نقاط درخواستی در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/tile/snapshot?key=PMI_API_TOKEN&provider=parsimap&labeled_locations=51.33775, 35.69975|51.34298, 35.69989&height=550&width=550&draw_arc=true&draw_line=false&exact_size=true&request_id=false
نمونه پاسخ
درخواست عکس از چند نقطه همراه با ترسیم خط بین نقاط
با ارسال مختصات جغرافیایی نقاط و فعال کردن گزینه draw_line، پس از تعیین طول و عرض تصویر، عکس از نقاط درخواستی در پاسخ برگردانده می‌شود.
https://api.parsimap.ir/tile/snapshot?key=PMI_API_TOKEN&provider=googlesat&labeled_locations=51.33324, 35.70140|51.33374, 35.69679|51.34169, 35.69711|51.34164,35.70192&height=500&width=500&draw_arc=false&draw_line=true&exact_size=true&request_id=false
نمونه پاسخ
