Geocoding API سرویسی است که مکان را به‌صورت نشانی، مختصات طول و عرض جغرافیایی، یا «شناسه مکان» می‌پذیرد. این میانای برنامه‌سازی کاربردی نشانی را به مختصات عرض جغرافیایی و طول جغرافیایی و «شناسه مکان» تبدیل می‌کند، یا مختصات عرض جغرافیایی و طول جغرافیایی یا «شناسه مکان» را به نشانی تبدیل می‌کند.
Geocoding API v4 هم هوشمندی مقصد و ورود محلی و هم وضوح مختصات به نشانی اصلی را ارائه می‌دهد. چه درحال ساختن تجربه ناوبری گام‌به‌گام، هم‌سفری، یا تحویل در مقصد نهایی باشید، یا درحال تبدیل نشانی‌های خیابان به مختصات باشید، نسخه ۴ نقاط پایانی اختصاصی متناسب با مورد استفاده شما ارائه می‌دهد.
مطمئن نیستید کدام نقطه پایانی برای برنامه شما مناسب است؟ انتخاب روش زمین‌کدیابی را ببینید.
کارهایی که می‌توانید با Geocoding API انجام دهید
Geocoding API v4 شامل قابلیت‌ها و نقاط پایانی زیر است:
- جستجوی مقصد: جزئیات ورود بسیار محلی را برای مقصد از نشانی، شناسه مکان، یا مختصات بازیابی کنید—ازجمله ورودی‌های ساختمان، نشان‌های نقطه ناوبری قابل‌یابی، طرح‌های کلی ساختمان و زمین، زیرمقصدها، و نشانگرهای مکانی اطراف.
- زمین‌کدیابی نشانی: نشانی‌های خیابان را به مختصات جغرافیایی و «شناسه‌های مکان» تبدیل کنید (زمین‌کدیابی مستقیم).
- زمین‌کدیابی مکان: تبدیل مختصات طول و عرض جغرافیایی به نشانی‌های خیابان یا تقسیمات کشوری قابل‌خواندن برای انسان (زمین‌کدیابی معکوس).
- زمین‌کدیابی مکان: جزئیات نشانی قالب‌بندی‌شده و مختصات را برای «شناسه مکان» شناخته‌شده در Google Maps بازیابی کنید.
می‌توانید کنترل کنید نتایج کجا نشان داده شود و نتایج را به منطقه، کشور، یا کد پستی خاصی محدود کنید.
امتحان نسخه نمایشی
نحوه عملکرد Geocoding API
Geocoding API v4 از جستجوی مقصد درکنار زمین‌کدیابی پایه پشتیبانی می‌کند:
- جستجوی مقصد (
SearchDestinations): نشانی، شناسه مکان، یا جفت مختصات را به شیء غنیDestinationتبدیل می‌کند. وقتی رسیدن فیزیکی مهم است از این روش استفاده کنید—مثلاً برای شناسایی ورودی‌های ترجیحی ساختمان، هدایت رانندگان به نقاط سوار یا پیاده کردن تعیین‌شده بااستفاده از نشان‌های نقطه ناوبری، نمایش ردپای ساختمان روی نقشه، یا پیمایش مجتمع‌های چندساختمانی. - زمین‌کدیابی پایه: بین نشانی‌ها، مختصات، و شناسه‌های مکان تبدیل می‌کند:
- زمین‌کدیابی: نشانی‌های خیابان مانند «1600 Amphitheatre Parkway, Mountain View, CA» را به مختصات طول و عرض جغرافیایی یا «شناسه‌های مکان» تبدیل می‌کند تا نشانگرهای نقشه را قرار دهد یا قاب نمای نقشه را در مرکز قرار دهد.
- زمین‌کدیابی معکوس: مختصات طول و عرض جغرافیایی یا شناسه‌های مکان را به نشانی‌های خیابان قابل‌خواندن برای انسان تبدیل می‌کند تا برای سنجاق‌های نقشه که کاربر قرار داده است، انتخاب‌کننده‌های مکان، یا نمایش میانای کاربر استفاده شود.
- زمین‌کدیابی مکان: جزئیات نشانی و مختصات را برای «شناسه مکان» شناخته‌شده در Google Maps بازیابی می‌کند.
جدول زیر منابع دردسترس ازطریق Geocoding API v4 را به‌همراه داده‌هایی که هر روش برمی‌گرداند خلاصه می‌کند:
| منابع داده‌ها | داده‌های برگردانده‌شده | قالب برگشت |
|---|---|---|
| جستجوی مقصد ( POST /v4/geocode/destinations)
|
اطلاعات ورود محلی را برمی‌گرداند: چندضلعی‌های ساختمان و زمین (displayPolygon)، entrances فیزیکی، navigationPoints قابل‌مسیریابی (با کد)، containingPlaces و subDestinations سلسله‌مراتبی، landmarks رابطه‌ای، و جزئیات مکان اصلی. جستجوی مقصد را ببینید.
|
|
| زمین‌کدیابی نشانی ( GET /v4/geocode/address)
|
نشانی، مؤلفه‌های نشانی، و انواع نشانی را برمی‌گرداند. پاسخ زمین‌کدیابی را ببینید. | |
| زمین‌کدیابی مکان ( GET /v4/geocode/location)
|
نشانی، مؤلفه‌های نشانی، و انواع نشانی را برمی‌گرداند. پاسخ زمین‌کدیابی معکوس را ببینید. | |
| زمین‌کدیابی مکان ( GET /v4/geocode/places)
|
نشانی، مؤلفه‌های نشانی، و انواع نشانی را برمی‌گرداند. پاسخ زمین‌کدیابی مکان را ببینید. |
راه‌اندازی کانال‌های صحنه
نسخه ۴ 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 را از سرور زیرینه خودتان فراخوانی کنید. برای جزئیات بیشتر درباره الگوهای پیاده‌سازی امن و جایگزین‌های نیازهای سمت کارخواه، به ملاحظات امنیتی مراجعه کنید.