نمای کلی API کدگذاری جغرافیایی

Geocoding API سرویسی است که مکان را به عنوان آدرس، مختصات طول و عرض جغرافیایی یا شناسه مکان می پذیرد. آدرس را به مختصات طول و عرض جغرافیایی و شناسه مکان تبدیل می کند یا مختصات طول و عرض جغرافیایی یا شناسه مکان را به آدرس تبدیل می کند.

چرا از Geocoding API استفاده کنید

زمانی که می‌خواهید از داده‌های کدگذاری جغرافیایی در نقشه‌های ارائه‌شده توسط یکی از APIهای پلتفرم Google Maps استفاده کنید، از API Geocoding برای وب‌سایت یا برنامه تلفن همراه استفاده کنید. با استفاده از Geocoding API، از آدرس ها برای قرار دادن نشانگرها روی نقشه یا تبدیل نشانگر روی نقشه به آدرس استفاده می کنید. این سرویس برای geocoding آدرس های از پیش تعریف شده و ثابت برای قرار دادن محتوای برنامه بر روی نقشه طراحی شده است.

کارهایی که می توانید با Geocoding API انجام دهید

می‌توانید از Geocoding API برای به دست آوردن داده‌های رمزگذاری جغرافیایی برای یک یا چند آدرس یا مکان استفاده کنید، از جمله موارد زیر:

  • مختصات جغرافیایی برای آدرس ها
  • آدرس برای مجموعه مختصات طول و عرض جغرافیایی.
  • آدرس برای شناسه مکان.

می‌توانید مکان نمایش نتایج را کنترل کنید و نتایج را به یک منطقه، شهرستان یا کد پستی خاص محدود کنید.

نحوه عملکرد API Geocoding

Geocoding API هم ژئوکدینگ و هم ژئوکدینگ معکوس را انجام می دهد:

  • کدگذاری جغرافیایی : آدرس هایی مانند "1600 Amphitheatre Parkway, Mountain View, CA" را به مختصات طول و عرض جغرافیایی یا شناسه مکان تبدیل می کند. می توانید از این مختصات برای قرار دادن نشانگرها بر روی نقشه، یا مرکز یا تغییر مکان نقشه در چارچوب نمای استفاده کنید.
  • رمزگذاری جغرافیایی معکوس : مختصات طول و عرض جغرافیایی یا شناسه مکان را به یک آدرس قابل خواندن برای انسان تبدیل می کند. می‌توانید از آدرس‌ها برای سناریوهای مختلفی از جمله تحویل یا تحویل استفاده کنید.

نسخه ی نمایشی زیر از سرویس Geocoding از طریق Maps JavaScript API استفاده می کند تا نحوه عملکرد API Geocoding را نشان دهد. نقشه را در یک برگه جداگانه باز کنید تا گزینه ها و جزئیات بیشتر را ببینید.

منابع

جدول زیر منابع موجود از طریق Geocoding API را به همراه داده هایی که هر نقطه پایانی برمی گرداند، خلاصه می کند.

منابع داده داده ها برگردانده شد فرمت بازگشت
ژئوکدینگ آدرس، اجزای آدرس و انواع آدرس را برمی‌گرداند. نتایج را در راهنمای درخواست و پاسخ کدگذاری جغرافیایی ببینید.
  • JSON
  • XML
ژئوکدینگ معکوس آدرس، اجزای آدرس و انواع آدرس را برمی‌گرداند. پاسخ‌های رمزگذاری معکوس جغرافیایی را در راهنمای درخواست و پاسخ رمزگذاری معکوس جغرافیایی ببینید.
ژئوکدینگ مکان آدرس، اجزای آدرس و انواع آدرس را برمی‌گرداند. پاسخ‌های رمزگذاری معکوس جغرافیایی را در راهنمای درخواست و پاسخ کدگذاری جغرافیایی مکان ببینید.

نحوه استفاده از Geocoding API

1 راه اندازی شود. با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید.
2 یک درخواست geocoding را امتحان کنید هنگامی که یک کلید API دارید، می توانید آزمایش API Geocoding را مستقیماً از cURL یا یک مرورگر شروع کنید. شما باید پارامترهای جستجوی صحیح را برای جستجوی آدرس یا مؤلفه ارائه دهید. برای جزئیات بیشتر به پارامترهای Geocoding مراجعه کنید.
3 درخواست رمزگذاری جغرافیایی معکوس را امتحان کنید مختصات طول و عرض جغرافیایی را به همراه کلید API خود برای به دست آوردن اجزای آدرس برای نزدیکترین آدرس قابل خواندن توسط انسان برای آن مکان ارائه دهید. برای جزئیات بیشتر به درخواست های معکوس جغرافیایی مراجعه کنید.
4 اصول پاسخگویی را درک کنید همه نقاط پایانی در Geocoding API داده‌های یکسانی را در JSON یا XML برمی‌گردانند. برای توضیح داده ها، کدهای وضعیت و پیام های خطا به پاسخ های کدگذاری جغرافیایی مراجعه کنید.
5 داده های geocoding را در برنامه خود بگنجانید! می توانید از داده های کدگذاری جغرافیایی برای به دست آوردن آدرس از نشانگرهای نقشه یا برای ارائه نشانگرها بر روی نقشه بر اساس یک آدرس شناخته شده استفاده کنید.

کتابخانه های مشتری موجود

این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:

Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps، کتابخانه‌های مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.

بعدش چی