«میانای برنامه‌سازی کاربردی Geocoding» سرویسی است که مکان را به‌عنوان نشانی، مختصات طول و عرض جغرافیایی، یا «شناسه مکان» می‌پذیرد. این میانای برنامه‌سازی کاربردی نشانی را به مختصات عرض جغرافیایی و طول جغرافیایی و «شناسه مکان» تبدیل می‌کند، یا مختصات عرض جغرافیایی و طول جغرافیایی یا «شناسه مکان» را به نشانی تبدیل می‌کند.
کارهایی که می‌توانید با Geocoding API انجام دهید
می‌توانید از Geocoding API برای دریافت داده‌های زمین‌کدیابی برای یک یا چند نشانی یا مکان استفاده کنید، ازجمله موارد زیر:
- مختصات جغرافیایی برای نشانی‌ها.
- نشانی‌های مجموعه‌های مختصات طول و عرض جغرافیایی.
- نشانی‌های شناسه‌های مکان.
می‌توانید کنترل کنید نتایج در کجا نشان داده شود و نتایج را به منطقه، شهرستان، یا کد پستی خاصی محدود کنید.
نحوه عملکرد Geocoding API
Geocoding API هم زمین‌کدیابی و هم زمین‌کدیابی معکوس را انجام می‌دهد:
- زمین‌کدیابی: نشانی‌هایی مثل «1600 Amphitheatre Parkway, Mountain View, CA» را به مختصات طول و عرض جغرافیایی یا «شناسه‌های مکان» تبدیل می‌کند. می‌توانید از این مختصات برای قرار دادن نشانگر روی نقشه یا برای مرکز کردن یا تغییر دادن جایگاه نقشه در چارچوب نما استفاده کنید.
- زمین‌کدیابی معکوس: مختصات عرض/طول جغرافیایی یا «شناسه مکان» را به نشانی قابل‌خواندن برای انسان تبدیل می‌کند. می‌توانید از نشانی‌ها برای سناریوهای مختلف، ازجمله تحویل یا تحویل گرفتن، استفاده کنید.
نسخه نمایشی زیر از Geocoding Service ازطریق Maps JavaScript API استفاده می‌کند تا نحوه عملکرد Geocoding API را نشان دهد. برای دیدن گزینه‌ها و جزئیات بیشتر، نقشه را در برگه جداگانه‌ای باز کنید.
منابع
جدول زیر منابع دردسترس ازطریق «میانای برنامه‌سازی کاربردی» «مکان‌یابی جغرافیایی» را به‌همراه داده‌هایی که هر روش برمی‌گرداند خلاصه می‌کند.
| منابع داده | داده‌های برگردانده‌شده | قالب برگشت |
|---|---|---|
| زمین‌کدیابی | نشانی برگشتی، عناصر نشانی، و انواع نشانی را برمی‌گرداند. در راهنمای نتایج در راهنمای درخواست و پاسخ زمین‌کدیابی ببینید. |
|
| زمین‌کدیابی معکوس | نشانی برگشتی، عناصر نشانی، و انواع نشانی را برمی‌گرداند. در راهنمای درخواست و پاسخ «زمین‌کدیابی معکوس»، پاسخ‌های زمین‌کدیابی معکوس را ببینید. | |
| زمین‌کدیابی مکان | نشانی برگشتی، عناصر نشانی، و انواع نشانی را برمی‌گرداند. در راهنمای درخواست و پاسخ «مکان‌یابی جغرافیایی مکان»، پاسخ‌های مکان‌یابی جغرافیایی معکوس را ببینید. |
نحوه استفاده از Geocoding API
| ۱ | راه‌اندازی کنید. | با راه‌اندازی پروژه Google Cloud شروع کنید و دستورالعمل‌های راه‌اندازی را که در ادامه می‌آید تکمیل کنید. |
| ۲ | امتحان کردن درخواست زمین‌کدیابی | پس‌از دریافت کلید API، می‌توانید آزمایش Geocoding API را مستقیماً از curl یا مرورگر شروع کنید. باید پارامترهای جستجوی صحیح را برای جستجوی نشانی یا مؤلفه ارائه دهید. برای جزئیات بیشتر، پارامترهای زمین‌کدگذاری را ببینید. |
| 3 | درخواست معکوس کدگذاری جغرافیایی را امتحان کنید | برای دریافت عناصر نشانی برای نزدیک‌ترین نشانی قابل‌خواندن توسط انسان برای آن مکان، مختصات طول/عرض جغرافیایی را همراه با کلید API خود ارائه دهید. برای جزئیات بیشتر، درخواست‌های زمین‌کد معکوس را ببینید. |
| ۴ | آشنایی با اصول اولیه پاسخ | همه روش‌های «میانای برنامه‌سازی کاربردی Geocoding» داده‌های یکسانی را در قالب JSON یا XML برمی‌گردانند. برای توضیح داده‌ها، کدهای وضعیت، و پیام‌های خطا، پاسخ‌های زمین‌کدیابی را ببینید. |
| ۵ | داده‌های زمین‌کدگذاری را در برنامه خودتان بگنجانید! | می‌توانید از داده‌های زمین‌کدگذاری برای دریافت نشانی از نشانگرهای نقشه یا برای ارائه نشانگر در نقشه براساس نشانی شناخته‌شده استفاده کنید. |
کتابخانه‌های کارخواه دردسترس
این «میانای برنامه‌سازی کاربردی» را به زبان دلخواهتان ازطریق یکی از کتابخانه‌های مشتری زیر فراخوانی کنید:
- Java Client for Google Maps Services
- Python کارخواه سرویس‌های Google Maps
- Go Client for Google Maps Services
- Node.js Client for Google Maps Services
«کارخواه جاوا»، «کارخواه پایتون»، «کارخواه Go»، و «کارخواه Node.js» برای «سرویس‌های Google Maps» کتابخانه‌های کارخواه با پشتیبانی انجمن هستند که تحت پروانه Apache 2.0 به‌صورت متن‌باز ارائه شده‌اند. آن‌ها را از GitHub بارگیری کنید، در آنجا می‌توانید دستورالعمل‌های نصب و کد نمونه را نیز پیدا کنید.
قدم بعدی چیست
- شروع استفاده از Geocoding API: به راه‌اندازی پروژه Google Cloud بروید.
- شروع به کار با درخواست‌ها و پاسخ‌های نمونه: به درخواست‌ها و پاسخ‌های زمین‌کدیابی بروید
- روال‌های مطلوب را دنبال کنید: به روال‌های مطلوب برای زمین‌کدگذاری نشانی‌ها بروید.