Geocoding API سرویسی است که مکان را به‌صورت نشانی، مختصات طول و عرض جغرافیایی، یا «شناسه مکان» می‌پذیرد. این میانای برنامه‌سازی کاربردی نشانی را به مختصات عرض جغرافیایی و طول جغرافیایی و «شناسه مکان» تبدیل می‌کند، یا مختصات عرض جغرافیایی و طول جغرافیایی یا «شناسه مکان» را به نشانی تبدیل می‌کند.
کارهایی که می‌توانید با Geocoding API انجام دهید
می‌توانید از Geocoding API برای دریافت داده‌های زمین‌کدیابی برای یک یا چند نشانی یا مکان استفاده کنید، ازجمله موارد زیر:
این نسخه از Geocoding API v4 شامل انتشار نقاط پایانی زیر است:
- زمین‌کدیابی نشانی — مختصات جغرافیایی برای نشانی‌ها. زمین‌کدیابی مستقیم نیز نامیده می‌شود.
- زمین‌کدیابی مکان — نشانی‌های مجموعه‌های مختصات عرض جغرافیایی و طول جغرافیایی. به آن زمین‌کدیابی معکوس نیز می‌گویند.
- زمین‌کدیابی مکان — بازیابی نشانی از شناسه مکان.
- جستجوی مقصد — جستجوی مقصد ازطریق نشانی، شناسه مکان، یا موقعیت مکانی.
می‌توانید کنترل کنید نتایج کجا نشان داده شود و نتایج را به منطقه، کشور، یا کد پستی خاصی محدود کنید.
امتحان نسخه نمایشی
نحوه عملکرد Geocoding API
Geocoding API هم زمین‌کدیابی و هم زمین‌کدیابی معکوس را انجام می‌دهد:
- زمین‌کدیابی: نشانی‌هایی مثل «1600 Amphitheatre Parkway, Mountain View, CA» را به مختصات طول و عرض جغرافیایی یا «شناسه مکان» تبدیل می‌کند. می‌توانید از این مختصات برای قرار دادن نشانگرها روی نقشه، یا برای قرار دادن نقشه در مرکز یا تغییر موقعیت آن در قاب نما استفاده کنید.
- زمین‌کدیابی معکوس: مختصات طول و عرض جغرافیایی یا «شناسه مکان» را به نشانی قابل‌خواندن برای انسان تبدیل می‌کند. می‌توانید از نشانی‌ها برای سناریوهای مختلفی استفاده کنید، ازجمله تحویل یا دریافت.
جدول زیر منابع دردسترس ازطریق Geocoding API را به‌همراه داده‌هایی که هر روش برمی‌گرداند خلاصه می‌کند.
| منابع داده‌ها | داده‌های برگردانده‌شده | قالب برگشت |
|---|---|---|
| زمین‌کدیابی | نشانی، مؤلفه‌های نشانی، و انواع نشانی را برمی‌گرداند. سند پاسخ زمین‌کدیابی را ببینید. |
|
| زمین‌کدیابی معکوس | نشانی، مؤلفه‌های نشانی، و انواع نشانی را برمی‌گرداند. سند پاسخ زمین‌کدیابی معکوس را ببینید. | |
| زمین‌کدیابی مکان | نشانی، مؤلفه‌های نشانی، و انواع نشانی را برمی‌گرداند. به سند پاسخ زمین‌کدیابی مکان مراجعه کنید. | |
| جستجوی مقصد | اطلاعات دقیقی درباره مقصدهای مختلف براساس معیارهای ورودی متفاوت، مانند نشانی، شناسه مکان، یا مختصات طول و عرض جغرافیایی، برمی‌گرداند. سند جستجوی مقصد را ببینید. |
راه‌اندازی کانال‌های صحنه
نسخه ۴ Geocoding API کانال‌های جداگانه‌ای برای ویژگی‌های GA، «پیش‌نمایش»، و «آزمایشی» دارد. اگر می‌خواهید از ویژگی‌های «پیش‌نمایش» یا «آزمایشی» استفاده کنید، حتماً کانال صحیح را در درخواستتان مشخص کنید. برای مثال، برای دسترسی به ویژگی‌های نقطه پایان «مقصدها» در «آزمایشی»، از این درخواست HTTP استفاده کنید: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| مرحله راه‌اندازی | نام کانال |
|---|---|
| دسترس‌پذیری عمومی | /v4/ |
| پیش‌نمایش | /v4beta/ |
| آزمایشی | /v4alpha/ |
- برای مشاهده فهرست و شرح همه منابع REST دردسترس، به مرجع REST مراجعه کنید.
- برای اطلاعات بیشتر درباره هر مرحله، به مراحل راه‌اندازی مراجعه کنید.
ویژگی‌های Geocoding API نسخه ۴
نسخه ۴ از Geocoding API این ویژگی‌های جدید را ارائه می‌دهد.
روش جستجوی مقصد
نسخه ۴ روش جستجوی مقصد را معرفی می‌کند که به شما امکان می‌دهد اطلاعات دقیقی درباره مقصدهای مختلف براساس معیارهای ورودی متفاوت، مانند نشانی، شناسه مکان، یا مختصات طول و عرض جغرافیایی، بازیابی کنید. پاسخ شامل خلاصه‌های مبتنی بر هوش مصنوعی و نشان‌های نقطه ناوبری است که حاوی اطلاعات زمینه‌ای هستند که می‌توانند برای مسیریابی دقیق به کیت توسعه نرم‌افزار ناوبری ارسال شوند.
پیاده‌سازی‌شده در پلاتفرم استاندارد Google Cloud
Geocoding API v4 در زیرساخت سرویس در Google Cloud پیاده‌سازی شده است. این پیاده‌سازی پلاتفرم امن‌تر و قابل‌اعتمادتری را با گزینه‌های امنیتی بهبودیافته‌ای مثل OAuth به‌همراه دارد. این طراحی استاندارد میانای برنامه‌سازی کاربردی سطحی از سازگاری را در میاناهای برنامه‌سازی کاربردی ایجاد می‌کند که کارایی توسعه با Geocoding API v4 را بهبود می‌بخشد.
پشتیبانی OAuth اضافه شد
Geocoding API v4 از استفاده از OAuth 2.0 برای اصالت‌سنجی پشتیبانی می‌کند. Google از سناریوهای رایج OAuth 2.0 مانند سناریوهای سرور وب پشتیبانی می‌کند.
پشتیبانی از پوشش فیلد اضافه شد
از ماسک‌های فیلد برای مشخص کردن اطلاعاتی که پاسخ باید برگرداند استفاده کنید. برای روش‌های زمین‌کدیابی نشانی، زمین‌کدیابی مکان، و زمین‌کدیابی مکان، همه فیلدها در شیء پاسخ به‌طور پیش‌فرض برگردانده می‌شوند. برای روش جستجوی مقصدها، باید ماسک فیلد را در درخواست میانای برنامه‌سازی کاربردی مشخص کنید.
امنیت میانای برنامه‌سازی کاربردی
Geocoding API v4 به‌عنوان یک میانای برنامه‌سازی کاربردی سروربه‌سرور طراحی شده است. فراخوانی‌های مستقیم سمت کارخواه از مرورگر، کلیدهای میانای برنامه‌سازی کاربردی را درمعرض خطر جدی سرقت و سوءاستفاده قرار می‌دهد، زیرا محدودیت‌های ارجاع‌دهنده HTTP محافظت کافی برای نقاط پایانی سرویس وب نیست.
اکیداً توصیه می‌کنیم Geocoding API v4 را از سرور زیرینه خودتان فراخوانی کنید. برای جزئیات بیشتر درباره الگوهای پیاده‌سازی امن و جایگزین‌های نیازهای سمت کارخواه، به ملاحظات امنیتی مراجعه کنید.