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