API ژئوکدینگ سرویسی است که یک مکان را به عنوان آدرس، مختصات طول و عرض جغرافیایی یا شناسه مکان میپذیرد. این سرویس آدرس را به مختصات طول و عرض جغرافیایی و شناسه مکان تبدیل میکند، یا مختصات طول و عرض جغرافیایی یا شناسه مکان را به یک آدرس تبدیل میکند.
کارهایی که میتوانید با API ژئوکدینگ انجام دهید
شما میتوانید از API مربوط به Geocoding برای دریافت دادههای Geocoding برای یک یا چند آدرس یا مکان، از جمله موارد زیر، استفاده کنید:
این نسخه از Geocoding API نسخه ۴ شامل انتشار نقاط پایانی زیر است:
- ژئوکد یک آدرس — مختصات جغرافیایی برای آدرسها. همچنین ژئوکدینگ رو به جلو نامیده میشود.
- ژئوکد یک مکان — آدرسهایی برای مجموعه مختصات طول و عرض جغرافیایی. همچنین ژئوکدینگ معکوس نامیده میشود.
- کدگذاری جغرافیایی مکان - بازیابی آدرس از یک شناسه مکان.
- جستجوی مقصدها — از روی آدرس، شناسه مکان یا موقعیت مکانی، مقصدی را جستجو کنید.
شما میتوانید محل نمایش نتایج را کنترل کنید و نتایج را به یک منطقه، شهرستان یا کد پستی خاص محدود کنید.
نسخه آزمایشی را امتحان کنید
نحوه عملکرد API ژئوکدینگ
API مربوط به Geocoding هم Geocoding و هم Geocoding معکوس را انجام میدهد:
- ژئوکدینگ : آدرسهایی مانند «۱۶۰۰ آمفیتئاتر پارکوی، مانتین ویو، کالیفرنیا» را به مختصات طول و عرض جغرافیایی یا شناسه مکان تبدیل میکند. میتوانید از این مختصات برای قرار دادن نشانگرها روی نقشه یا قرار دادن نقشه در مرکز یا تغییر موقعیت آن در قاب نمایش استفاده کنید.
- ژئوکدینگ معکوس : مختصات طول و عرض جغرافیایی یا یک شناسه مکان را به آدرسی قابل خواندن توسط انسان تبدیل میکند. میتوانید از آدرسها برای سناریوهای مختلفی از جمله تحویل یا دریافت کالا استفاده کنید.
جدول زیر منابع موجود از طریق API مربوط به Geocoding را به همراه دادههایی که هر روش برمیگرداند، خلاصه میکند.
| منابع داده | دادهها بازگردانده شدند | قالب بازگشتی |
|---|---|---|
| ژئوکدینگ | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به مستندات پاسخ Geocode مراجعه کنید. |
|
| ژئوکدینگ معکوس | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به مستندات پاسخ ژئوکدینگ معکوس مراجعه کنید. | |
| مکانیابی جغرافیایی | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به مستندات پاسخ مکانیابی جغرافیایی مراجعه کنید. | |
| جستجوی مقصد | اطلاعات دقیقی درباره مقاصد مختلف بر اساس معیارهای ورودی مختلف، مانند آدرس، شناسه مکان یا مختصات طول و عرض جغرافیایی، برمیگرداند. به مستندات جستجوی مقصد مراجعه کنید. |
ویژگیهای API ژئوکدینگ نسخه ۴
نسخه ۴ رابط برنامهنویسی کاربردی Geocoding این ویژگیهای جدید را ارائه میدهد.
روش جستجوی مقصد
نسخه ۴ یک روش جستجوی مقصد را معرفی میکند که به شما امکان میدهد اطلاعات دقیقی در مورد مقاصد مختلف را بر اساس معیارهای ورودی مختلف، مانند آدرس، شناسه مکان یا مختصات طول و عرض جغرافیایی، بازیابی کنید. پاسخ شامل خلاصههای مبتنی بر هوش مصنوعی و توکنهای نقطه ناوبری است که حاوی اطلاعات زمینهای هستند که میتوانند برای مسیریابی دقیق به SDK ناوبری منتقل شوند.
بر روی پلتفرم استاندارد Google Cloud پیادهسازی شده است
Geocoding API نسخه ۴ بر روی زیرساخت سرویس در Google Cloud پیادهسازی شده است. این پیادهسازی، پلتفرمی امنتر و قابل اعتمادتر با گزینههای امنیتی پیشرفته مانند OAuth را به ارمغان میآورد. این طراحی استاندارد API، سطحی از سازگاری را در بین APIها ایجاد میکند که کارایی توسعه را با Geocoding API نسخه ۴ بهبود میبخشد.
پشتیبانی از OAuth اضافه شد
API ژئوکدینگ نسخه ۴ از استفاده از OAuth 2.0 برای احراز هویت پشتیبانی میکند. گوگل از سناریوهای رایج OAuth 2.0 مانند سناریوهای مربوط به یک وب سرور پشتیبانی میکند.
پشتیبانی از ماسک میدانی اضافه شد
از ماسکهای فیلد برای مشخص کردن اطلاعاتی که پاسخ باید برگرداند استفاده کنید. برای متدهای Geocode an address ، Geocode a location و Place geocoding ، تمام فیلدهای موجود در شیء پاسخ به طور پیشفرض برگردانده میشوند. برای متد Search for destinations ، باید یک ماسک فیلد در درخواست API مشخص کنید.
امنیت API
رابط برنامهنویسی کاربردی Geocoding نسخه ۴ به عنوان یک رابط برنامهنویسی کاربردی (API) سرور به سرور طراحی شده است. فراخوانیهای مستقیم سمت کلاینت از طریق مرورگر، کلیدهای API را در معرض خطر قابل توجه سرقت و سوءاستفاده قرار میدهد، زیرا محدودیتهای ارجاعدهنده HTTP برای نقاط پایانی سرویس وب، محافظت کافی را ارائه نمیدهد.
ما اکیداً توصیه میکنیم که API نسخه ۴ ژئوکدینگ را از سرور بکاند خود فراخوانی کنید. برای جزئیات بیشتر در مورد الگوهای پیادهسازی امن و جایگزینها برای نیازهای سمت کلاینت، به ملاحظات امنیتی مراجعه کنید.