Map Management API هي واجهة برمجة تطبيقات RESTful يمكنك استخدامها لإدارة موارد تصميم الخرائط المستندة إلى السحابة الإلكترونية آليًا. باستخدام واجهة برمجة التطبيقات هذه، يمكنك تحديد المظهر المرئي لخرائطك وإدارة هويات الخرائط وربط الأنماط المخصّصة ومجموعات البيانات بنُسخ معيّنة من الخرائط، وكل ذلك بدون استخدام Cloud Console.
تم تصميم Map Management API للمطوّرين الذين يريدون إدارة إعدادات الخرائط على نطاق واسع أو دمج أنماط الخرائط في مهام سير العمل المبرمَجة والأدوات الداخلية الخاصة بهم.
المصادر الرئيسية
- StyleConfig: يحتوي على تمثيل JSON لنمط خريطة. يحدّد هذا الإعداد الألوان ومستوى الظهور وكثافة ميزات الخريطة.
- MapConfig: يمثّل هوية خريطة فريدة (رقم تعريف الخريطة). وهي تعمل كحاوية لإعدادات الأنماط والميزات، مثل تعزيز نقاط الاهتمام أو تسوية المباني.
- MapContextConfig: يربط
StyleConfig(واختياريًا مجموعة بيانات واحدة أو أكثر) بـMapVariantsمعيّن ضمنMapConfig.
قنوات إصدارات واجهة برمجة التطبيقات
تستخدم واجهة Map Management API الإصدارات المستندة إلى القنوات لتوفير مسار واضح من الميزات التجريبية إلى الإصدارات الثابتة والمتوفرة للجمهور العام.
- v2alpha (تجريبي): يحتوي على أحدث الميزات التجريبية. قد تتغيّر الميزات في هذه القناة بدون إشعار، ولا يُنصح باستخدامها في مرحلة الإنتاج.
- v2beta (نسخة حصرية): يحتوي على ميزات ثابتة ويتم إعدادها لتصبح متاحة للجمهور العام. هذه القناة مناسبة للاستخدام المبكر والاختبار في بيئات ما قبل الإنتاج.
- الإصدار 2 (متوفّر للجمهور العام): يحتوي على ميزات متوافقة بالكامل وجاهزة للاستخدام في مرحلة الإنتاج.
تتوفّر معظم ميزات الإصدار الثاني في كل من نقطتَي النهاية v2alpha وv2beta خلال مراحل طرحهما. بالنسبة إلى المستخدمين الجدد، تنصح Google
بالبدء بنقطة النهاية v2beta.
المصادقة
يمكنك فقط استخدام OAuth 2.0 للمصادقة مع Map Management API، التي لا تتيح استخدام مفاتيح واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام OAuth.
القيود
- أدوار المطوّرين: لاستخدام Map Management API، يجب أن تكون لديك أذونات "إدارة الهوية وإمكانية الوصول" (IAM) اللازمة لإدارة موارد "منصة خرائط Google" ضمن مشروعك على Google Cloud.
- نطاق الموارد: تركّز واجهة برمجة التطبيقات هذه على إدارة موارد تصميم الخرائط المستندة إلى السحابة الإلكترونية. قد تتطلّب الإعدادات الأخرى في "منصة خرائط Google" استخدام Cloud Console.
التكاليف
لا يتم فرض أي رسوم مقابل استخدام Map Management API. تظهر طلبات البيانات من واجهة برمجة التطبيقات في صفحة "الفوترة" في Cloud Console، ولكن ستكون الرسوم 0 دولار أمريكي. ومع ذلك، تخضع الطلبات للقيود التالية:
- 3 طلبات في الثانية
- 180 طلب بحث في الدقيقة لمشروع معيّن، ويتم تحديثه كل دقيقة
- 100,000 طلب بحث في اليوم لكل مشروع، ويتم تجديدها كل يوم
يُرجى الاطّلاع على الاستخدام والفوترة.