API ژئوکدینگ سرویسی است که یک مکان را به عنوان آدرس، مختصات طول و عرض جغرافیایی یا شناسه مکان میپذیرد. این سرویس آدرس را به مختصات طول و عرض جغرافیایی و شناسه مکان تبدیل میکند، یا مختصات طول و عرض جغرافیایی یا شناسه مکان را به یک آدرس تبدیل میکند.
کارهایی که میتوانید با API ژئوکدینگ انجام دهید
شما میتوانید از API مربوط به Geocoding برای دریافت دادههای Geocoding برای یک یا چند آدرس یا مکان، از جمله موارد زیر، استفاده کنید:
- مختصات جغرافیایی برای آدرسها.
- آدرسهایی برای مجموعه مختصات طول و عرض جغرافیایی.
- آدرسهای مربوط به شناسههای مکان.
شما میتوانید محل نمایش نتایج را کنترل کنید و نتایج را به یک منطقه، شهرستان یا کد پستی خاص محدود کنید.
نحوه عملکرد API ژئوکدینگ
API مربوط به Geocoding هم Geocoding و هم Geocoding معکوس را انجام میدهد:
- ژئوکدینگ : آدرسهایی مانند «۱۶۰۰ آمفیتئاتر پارکوی، مانتین ویو، کالیفرنیا» را به مختصات طول و عرض جغرافیایی یا شناسه مکان تبدیل میکند. میتوانید از این مختصات برای قرار دادن نشانگرها روی نقشه یا قرار دادن نقشه در مرکز یا تغییر موقعیت آن در قاب نمایش استفاده کنید.
- ژئوکدینگ معکوس : مختصات طول/عرض جغرافیایی یا یک شناسه مکان را به آدرسی قابل خواندن توسط انسان تبدیل میکند. میتوانید از آدرسها برای سناریوهای مختلفی از جمله تحویل یا دریافت کالا استفاده کنید.
دموی زیر از سرویس Geocoding از طریق Maps JavaScript API برای نمایش نحوهی عملکرد Geocoding API استفاده میکند. برای مشاهدهی گزینهها و جزئیات بیشتر، نقشه را در یک تب جداگانه باز کنید.
منابع
جدول زیر منابع موجود از طریق API ژئوکدینگ را به همراه دادههایی که هر نقطه پایانی برمیگرداند، خلاصه میکند.
| منابع داده | دادهها بازگردانده شدند | قالب بازگشتی |
|---|---|---|
| ژئوکدینگ | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. برای مشاهده نتایج به راهنمای درخواست و پاسخ Geocoding مراجعه کنید. |
|
| ژئوکدینگ معکوس | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به پاسخهای ژئوکدینگ معکوس در راهنمای درخواست و پاسخ ژئوکدینگ معکوس مراجعه کنید. | |
| مکانیابی جغرافیایی | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به پاسخهای معکوس geocoding در راهنمای درخواست و پاسخ geocoding مکان مراجعه کنید. |
نحوه استفاده از API ژئوکدینگ
| ۱ | آماده شوید. | با راهاندازی پروژه Google Cloud خود شروع کنید و دستورالعملهای راهاندازی که در ادامه آمده است را تکمیل کنید. |
| ۲ | یک درخواست جغرافیایی را امتحان کنید | وقتی کلید API را دارید، میتوانید مستقیماً از طریق curl یا مرورگر، API مربوط به Geocoding را آزمایش کنید. برای جزئیات بیشتر، باید پارامترهای جستجوی صحیح را برای جستجوی آدرس یا کامپوننت وارد کنید. |
| ۳ | یک درخواست جغرافیایی معکوس را امتحان کنید | مختصات طول و عرض جغرافیایی را به همراه کلید API خود ارائه دهید تا اجزای آدرس برای نزدیکترین آدرس قابل خواندن توسط انسان برای آن مکان را دریافت کنید. برای جزئیات بیشتر به درخواستهای معکوس کدگذاری جغرافیایی مراجعه کنید. |
| ۴ | اصول اولیه پاسخ را درک کنید | تمام نقاط پایانی در API مربوط به Geocoding دادههای یکسانی را چه در JSON و چه در XML برمیگردانند. برای توضیح دادهها، کدهای وضعیت و پیامهای خطا، به پاسخهای Geocoding مراجعه کنید. |
| ۵ | دادههای جغرافیایی را در برنامه خود بگنجانید! | شما میتوانید از دادههای ژئوکدینگ برای بدست آوردن آدرسها از نشانگرهای نقشه یا برای اضافه کردن نشانگرها روی نقشه بر اساس یک آدرس شناخته شده استفاده کنید. |
کتابخانههای کلاینت موجود
این API را به زبان دلخواه خود از طریق یکی از کتابخانههای کلاینت زیر فراخوانی کنید:
- کلاینت جاوا برای سرویسهای نقشه گوگل
- کلاینت پایتون برای سرویسهای نقشه گوگل
- کلاینت Go برای سرویسهای نقشه گوگل
- کلاینت Node.js برای سرویسهای نقشه گوگل
کلاینت جاوا، کلاینت پایتون، کلاینت گو و کلاینت نود.جیاس برای سرویسهای نقشههای گوگل، کتابخانههای کلاینتی هستند که توسط جامعه پشتیبانی میشوند و تحت مجوز آپاچی ۲.۰ متنباز میباشند. آنها را از گیتهاب دانلود کنید، جایی که میتوانید دستورالعملهای نصب و نمونه کد را نیز پیدا کنید.
قدم بعدی چیست؟
- شروع استفاده از API ژئوکدینگ : به بخش راهاندازی پروژه گوگل کلود خود بروید.
- با نمونه درخواستها و پاسخها شروع کنید : به درخواستها و پاسخهای Geocoding بروید
- از بهترین شیوهها پیروی کنید : به بهترین شیوههای آدرسهای جغرافیایی بروید.