API مدیریت نقشه، یک API RESTful است که میتوانید از آن برای مدیریت برنامهریزیشدهی منابع طراحی نقشههای مبتنی بر ابر خود استفاده کنید. با استفاده از این API، میتوانید ظاهر بصری نقشههای خود را تعریف کنید، هویت نقشهها را مدیریت کنید و سبکها و مجموعه دادههای سفارشی را با انواع خاص نقشه مرتبط کنید - همه اینها بدون استفاده از کنسول ابری.
رابط برنامهنویسی کاربردی مدیریت نقشه (Map Management API) برای توسعهدهندگانی طراحی شده است که میخواهند مدیریت گستردهای بر پیکربندی نقشه انجام دهند یا سبکدهی نقشه را در گردشهای کاری خودکار و ابزارهای داخلی خود ادغام کنند.
منابع کلیدی
- StyleConfig : شامل نمایش JSON از یک سبک نقشه است. این مورد رنگها، میزان دید و تراکم ویژگیهای نقشه را تعریف میکند.
- MapConfig : نشاندهنده یک هویت منحصر به فرد نقشه (Map ID) است. این بخش به عنوان ظرفی برای تنظیمات استایلبندی و ویژگیهایی مانند افزایش POI یا مسطحسازی ساختمان عمل میکند.
- MapContextConfig : یک
StyleConfig(و به صورت اختیاری یک یا چند Dataset) را باMapVariantsخاص درون یکMapConfigمرتبط میکند.
کانالهای نسخهبندی API
رابط برنامهنویسی کاربردی مدیریت نقشه (Map Management API) از نسخهبندی مبتنی بر کانال استفاده میکند تا مسیری روشن از ویژگیهای آزمایشی به دسترسی پایدار و عمومی ارائه دهد.
- نسخه ۲ آلفا (آزمایشی) : شامل جدیدترین ویژگیهای آزمایشی است. ویژگیهای این کانال ممکن است بدون اطلاع قبلی تغییر کنند و برای استفاده در محیط عملیاتی توصیه نمیشوند.
- نسخه ۲ بتا (پیشنمایش) : شامل ویژگیهایی است که پایدار هستند و برای دسترسی عمومی آماده میشوند. این کانال برای پذیرش اولیه و آزمایش در محیطهای پیشتولید مناسب است.
- نسخه ۲ (دسترسی عمومی) : شامل ویژگیهای کاملاً پشتیبانیشده و آماده برای اجرا.
بیشتر ویژگیهای نسخه ۲ در هر دو نسخه v2alpha و v2beta در طول مراحل انتشار مربوطه در دسترس هستند. گوگل برای کاربران جدید توصیه میکند از نسخه v2beta شروع کنند.
احراز هویت
شما فقط میتوانید از OAuth 2.0 برای احراز هویت با Map Management API استفاده کنید، که از کلیدهای API پشتیبانی نمیکند. برای اطلاعات بیشتر، به Use OAuth مراجعه کنید.
محدودیتها
- نقشهای توسعهدهنده : برای استفاده از API مدیریت نقشه، باید مجوزهای لازم IAM را برای مدیریت منابع پلتفرم نقشههای گوگل در پروژه گوگل کلود خود داشته باشید.
- محدوده منابع : این API بر مدیریت منابع طراحی نقشه مبتنی بر ابر تمرکز دارد. سایر پیکربندیهای پلتفرم نقشههای گوگل ممکن است همچنان به کنسول ابری نیاز داشته باشند.
هزینهها
هیچ هزینهای برای استفاده از API مدیریت نقشه وجود ندارد. فراخوانیهای API در صفحه صورتحساب در کنسول ابری نمایش داده میشوند، اما هزینهها 0 دلار خواهند بود. با این حال، درخواستها به شرح زیر محدود میشوند:
- ۳ QPS (پرسوجو در ثانیه)
- ۱۸۰ کوئری در دقیقه (QPM) برای یک پروژه، که هر دقیقه بهروزرسانی میشود
- ۱۰۰۰۰۰ QPD (پرسوجو در روز) برای یک پروژه، که هر روز بهروزرسانی میشود
به بخش استفاده و صورتحساب مراجعه کنید.