Map Management API یک میانای برنامه‌سازی کاربردی RESTful است که می‌توانید از آن برای مدیریت برنامه‌ریزی‌شده منابع سبک‌پردازی نقشه بااستفاده از فضای ابری استفاده کنید. با این میانای برنامه‌سازی کاربردی، می‌توانید ظاهر بصری نقشه‌هایتان را تعریف کنید، هویت‌های نقشه را مدیریت کنید، و سبک‌های سفارشی و مجموعه‌های داده را با انواع خاص نقشه مرتبط کنید—همه این‌ها بدون استفاده از کنسول Cloud انجام می‌شود.
Map Management API برای توسعه‌دهندگانی طراحی شده است که می‌خواهند مدیریت پیکربندی‌های نقشه را در مقیاس بزرگ انجام دهند یا سبک نقشه را در گردش‌های کاری خودکار و ابزارهای داخلی خود ادغام کنند.
منابع کلیدی
- StyleConfig: حاوی نمایش JSON از سبک نقشه است. این رنگ‌ها، رؤیت‌پذیری، و تراکم عوارض نقشه را تعریف می‌کند.
- MapConfig: نشان‌دهنده هویت نقشه منحصربه‌فرد (شناسه Map) است. این فایل مثل یک ظرف برای تنظیمات سبک‌بندی و ویژگی‌هایی مثل تقویت نقطه موردعلاقه یا مسطح کردن ساختمان عمل می‌کند.
- MapContextConfig:
StyleConfig(و به‌صورت اختیاری یک یا چند «مجموعه داده») را باMapVariantsخاصی درMapConfigمرتبط می‌کند.
کانال‌های نسخه‌سازی میانای برنامه‌سازی کاربردی
Map Management API از نسخه‌سازی مبتنی بر کانال استفاده می‌کند تا مسیر واضحی از ویژگی‌های آزمایشی به دردسترس بودن عمومی پایدار ارائه دهد.
- v2alpha (آزمایشی): حاوی جدیدترین ویژگی‌های آزمایشی است. ویژگی‌های این کانال ممکن است بدون اطلاع قبلی تغییر کند و برای استفاده در تولید توصیه نمی‌شود.
- v2beta (پیش‌نمایش): حاوی ویژگی‌هایی است که پایدار هستند و برای دردسترس عموم قرار گرفتن آماده می‌شوند. این کانال برای پذیرش اولیه و آزمایش در محیط‌های پیش‌تولید مناسب است.
- نسخه ۲ (دردسترس عموم): حاوی ویژگی‌های کاملاً پشتیبانی‌شده و آماده تولید است.
اکثر ویژگی‌های نسخه ۲ در هر دو نقطه پایانی v2alpha و v2beta
درطول فازهای عرضه مربوطه دردسترس هستند. برای کاربران جدید، Google توصیه می‌کند
با نقطه پایانی v2beta شروع کنند.
اصالت‌سنجی
فقط می‌توانید از OAuth 2.0 برای اصالت‌سنجی با Map Management API استفاده کنید که از کلیدهای میانای برنامه‌سازی کاربردی پشتیبانی نمی‌کند. برای اطلاعات بیشتر، به استفاده از OAuth مراجعه کنید.
محدودیت‌ها
- نقش‌های توسعه‌دهنده: برای استفاده از Map Management API، باید اجازه‌های IAM لازم را برای مدیریت منابع Google Maps Platform در پروژه Google Cloud خود داشته باشید.
- Resource Scope: This API focuses on management of Cloud-based Map Styling resources. سایر پیکربندی‌های Google Maps Platform ممکن است همچنان به کنسول Cloud نیاز داشته باشند.
هزینه‌ها
استفاده از Map Management API هزینه‌ای ندارد. فراخوانی‌های میانای برنامه‌سازی کاربردی در صفحه «صورت‌حساب» در «کنسول Cloud» نشان داده می‌شود، اما هزینه آن ۰ دلار خواهد بود. بااین‌حال، درخواست‌ها به‌صورت زیر محدود شده‌اند:
- ۳ پُرسمان در ثانیه (QPS)
- ۱۸۰ پُرسمان در دقیقه برای هر پروژه، که هر دقیقه بازآوری می‌شود
- ۱۰۰٬۰۰۰ پُرسمان در روز برای هر پروژه، که هر روز بازآوری می‌شود
مصرف و صورت‌حساب را ببینید.