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