API ژئوکدینگ سرویسی است که یک مکان را به عنوان آدرس، مختصات طول و عرض جغرافیایی یا شناسه مکان میپذیرد. این سرویس آدرس را به مختصات طول و عرض جغرافیایی و شناسه مکان تبدیل میکند، یا مختصات طول و عرض جغرافیایی یا شناسه مکان را به یک آدرس تبدیل میکند.
کارهایی که میتوانید با API ژئوکدینگ انجام دهید
شما میتوانید از API مربوط به Geocoding برای دریافت دادههای Geocoding برای یک یا چند آدرس یا مکان، از جمله موارد زیر، استفاده کنید:
این نسخه از Geocoding API نسخه ۴ شامل انتشار نقاط پایانی زیر است:
- (پیشنمایش) ژئوکد کردن یک آدرس — مختصات جغرافیایی برای آدرسها. همچنین ژئوکدینگ رو به جلو نامیده میشود.
- (پیشنمایش) ژئوکد کردن یک مکان — آدرسهایی برای مجموعه مختصات طول و عرض جغرافیایی. همچنین ژئوکدینگ معکوس نامیده میشود.
- (پیشنمایش) کدگذاری جغرافیایی مکان — بازیابی آدرس از شناسه مکان.
- (پیشنمایش) جستجوی مقصدها — جستجوی یک مقصد از یک آدرس، شناسه مکان یا موقعیت مکانی.
شما میتوانید محل نمایش نتایج را کنترل کنید و نتایج را به یک منطقه، شهرستان یا کد پستی خاص محدود کنید.
نحوه عملکرد API ژئوکدینگ
API مربوط به Geocoding هم Geocoding و هم Geocoding معکوس را انجام میدهد:
- ژئوکدینگ : آدرسهایی مانند «۱۶۰۰ آمفیتئاتر پارکوی، مانتین ویو، کالیفرنیا» را به مختصات طول و عرض جغرافیایی یا شناسه مکان تبدیل میکند. میتوانید از این مختصات برای قرار دادن نشانگرها روی نقشه یا قرار دادن نقشه در مرکز یا تغییر موقعیت آن در قاب نمایش استفاده کنید.
- ژئوکدینگ معکوس : مختصات طول و عرض جغرافیایی یا یک شناسه مکان را به آدرسی قابل خواندن توسط انسان تبدیل میکند. میتوانید از آدرسها برای سناریوهای مختلفی از جمله تحویل یا دریافت کالا استفاده کنید.
جدول زیر منابع موجود از طریق API ژئوکدینگ را به همراه دادههایی که هر نقطه پایانی برمیگرداند، خلاصه میکند.
| منابع داده | دادهها بازگردانده شدند | قالب بازگشتی |
|---|---|---|
| ژئوکدینگ | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به مستندات پاسخ Geocode مراجعه کنید. |
|
| ژئوکدینگ معکوس | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به مستندات پاسخ ژئوکدینگ معکوس مراجعه کنید. | |
| مکانیابی جغرافیایی | آدرس، اجزای آدرس و انواع آدرس را برمیگرداند. به مستندات پاسخ مکانیابی جغرافیایی مراجعه کنید. | |
| جستجوی مقصد | اطلاعات دقیقی درباره مقاصد مختلف بر اساس معیارهای ورودی مختلف، مانند آدرس، شناسه مکان یا مختصات طول و عرض جغرافیایی، برمیگرداند. به مستندات جستجوی مقصد مراجعه کنید. |
ویژگیهای API ژئوکدینگ نسخه ۴
نسخه ۴ رابط برنامهنویسی کاربردی Geocoding این ویژگیهای جدید را ارائه میدهد.
نقطه پایانی جستجوی مقصد
نسخه ۴ یک نقطه پایانی جستجوی مقصد را معرفی میکند که به شما امکان میدهد اطلاعات دقیقی در مورد مقاصد مختلف را بر اساس معیارهای ورودی مختلف، مانند آدرس، شناسه مکان یا مختصات طول و عرض جغرافیایی، بازیابی کنید. پاسخ شامل خلاصههای مبتنی بر هوش مصنوعی و توکنهای نقطه ناوبری است که حاوی اطلاعات زمینهای هستند که میتوانند برای مسیریابی دقیق به SDK ناوبری منتقل شوند.
پیادهسازی شده بر روی پلتفرم استاندارد گوگل کلود
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 نسخه ۴ ژئوکدینگ در مرحله پیشنمایش قبل از انتشار عمومی است و هیچ هزینهای برای استفاده از API در طول پیشنمایش دریافت نمیشود. فراخوانیهای API در صفحه صورتحساب در کنسول ابری نمایش داده میشوند، اما هزینهها صفر دلار خواهد بود.
بازخورد
این یک ویژگی پیشنمایش است. ما از دریافت بازخورد در geocoding-feedback-channel@google.com استقبال میکنیم.