Package google.maps.mapmanagement.v2

الفهرس

Interface MapManagement

تعريف الخدمة لواجهة Map Management API

الطُرق
CreateMapConfig تنشئ هذه الطريقة MapConfig في مشروع.
CreateMapContextConfig تنشئ هذه الدالة عنصر MapContextConfig.
CreateStyleConfig تنشئ هذه الدالة StyleConfig.
DeleteMapConfig تحذف هذه الطريقة MapConfig.
DeleteMapContextConfig تحذف هذه الطريقة عنصر MapContextConfig.
DeleteStyleConfig تحذف هذه الطريقة StyleConfig.
GetMapConfig تعرض هذه الطريقة MapConfig.
GetMapContextConfig تعرض هذه الطريقة MapContextConfig.
GetStyleConfig تعرض هذه السمة StyleConfig.
ListMapConfigs تعرض هذه الطريقة قائمة بـ MapConfigs لمشروع معيّن.
ListMapContextConfigs تعرض هذه الطريقة قائمة بـ MapContextConfigs.
ListStyleConfigs قوائم StyleConfigs
UpdateMapConfig تعدّل هذه الطريقة MapConfig.
UpdateMapContextConfig تعديل MapContextConfig
UpdateStyleConfig تعديل StyleConfig

CreateMapConfigRequest

طلب إنشاء MapConfig

الحقول
parent

string

الحقل مطلوب. المشروع الرئيسي الذي سيمتلك MapConfig. التنسيق: projects/{project}
map_config

MapConfig

الحقل مطلوب. تمثّل هذه السمة MapConfig المطلوب إنشاؤه.

CreateMapContextConfigRequest

طلب إنشاء MapContextConfig

الحقول
parent

string

الحقل مطلوب. ملف MapConfig الرئيسي الذي سيحتوي على MapContextConfig. التنسيق: projects/{project}/mapConfigs/{map_config}
map_context_config

MapContextConfig

الحقل مطلوب. تمثّل هذه السمة MapContextConfig المطلوب إنشاؤه.

CreateStyleConfigRequest

طلب إنشاء StyleConfig

الحقول
parent

string

الحقل مطلوب. المشروع الرئيسي الذي سيمتلك StyleConfig. التنسيق: projects/{project}
style_config

StyleConfig

الحقل مطلوب. تمثّل هذه السمة StyleConfig المطلوب إنشاؤه.

DeleteMapConfigRequest

طلب حذف MapConfig

الحقول
name

string

الحقل مطلوب. اسم MapConfig المطلوب حذفه. التنسيق: projects/{project}/mapConfigs/{map_config}

DeleteMapContextConfigRequest

طلب حذف MapContextConfig

الحقول
name

string

الحقل مطلوب. اسم MapContextConfig المطلوب حذفه. التنسيق: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}

DeleteStyleConfigRequest

طلب حذف StyleConfig

الحقول
name

string

الحقل مطلوب. اسم StyleConfig المطلوب حذفه. التنسيق: projects/{project}/styleConfigs/{style_config}

GetMapConfigRequest

طلب الحصول على MapConfig

الحقول
name

string

الحقل مطلوب. اسم MapConfig المطلوب استرداده. التنسيق: projects/{project}/mapConfigs/{map_config}

GetMapContextConfigRequest

طلب الحصول على MapContextConfig

الحقول
name

string

الحقل مطلوب. اسم MapContextConfig المطلوب استرداده. التنسيق: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}

GetStyleConfigRequest

طلب الحصول على StyleConfig

الحقول
name

string

الحقل مطلوب. تمثّل هذه السمة اسم StyleConfig المطلوب استرداده. التنسيق: projects/{project}/styleConfigs/{style_config}
view

StyleConfigView

اختياريّ. تمثّل هذه السمة المجموعة الفرعية من StyleConfig المطلوب عرضها. في حال عدم ضبط هذا الخيار، يكون السلوك التلقائي هو عرض FULL.

ListMapConfigsRequest

طلب إدراج MapConfigs لمشروع

الحقول
parent

string

الحقل مطلوب. المشروع الرئيسي الذي يملك MapConfigs. التنسيق: projects/{project}
page_size

int32

اختياريّ. الحدّ الأقصى لعدد MapConfigs المطلوب عرضه. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 MapConfig كحد أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000. غير متاحة حاليًا.
page_token

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب ListMapConfigs سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListMapConfigs مع الطلب الذي قدّم رمز الصفحة المميّز. غير متاحة حاليًا.

ListMapConfigsResponse

استجابة لطلب إدراج MapConfigs

الحقول
map_configs[]

MapConfig

قائمة MapConfigs.
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة. غير متاحة حاليًا.

ListMapContextConfigsRequest

طلب إدراج MapContextConfigs

الحقول
parent

string

الحقل مطلوب. تمثّل هذه السمة MapConfig الرئيسية التي تتضمّن MapContextConfigs. التنسيق: projects/{project}/mapConfigs/{map_config}
page_size

int32

اختياريّ. الحدّ الأقصى لعدد MapContextConfigs المطلوب عرضه. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 MapContextConfigs كحد أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000. غير متاحة حاليًا.
page_token

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب ListMapContextConfigs سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListMapContextConfigs مع الطلب الذي قدّم رمز الصفحة المميّز. غير متاحة حاليًا.

ListMapContextConfigsResponse

ردّ على طلب إدراج MapContextConfigs

الحقول
map_context_configs[]

MapContextConfig

‫MapContextConfigs
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة. غير متاحة حاليًا.

ListStyleConfigsRequest

طلب إدراج StyleConfigs

الحقول
parent

string

الحقل مطلوب. المشروع الرئيسي الذي يملك StyleConfigs. التنسيق: projects/{project}
page_size

int32

اختياريّ. الحد الأقصى لعدد StyleConfigs المطلوب عرضه. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 StyleConfig كحدّ أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000. غير متاحة حاليًا.
page_token

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب ListStyleConfigs سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListStyleConfigs مع الطلب الذي قدّم رمز الصفحة المميّز. غير متاحة حاليًا.
filter

string

اختياريّ. تعبير الفلتر لمكالمة ListStyleConfigs. لا يتيح حاليًا سوى الفلترة حسب display_name. على سبيل المثال: سيؤدي طلب البحث display_name="My StyleConfig" إلى عرض جميع StyleConfigs التي تحمل الاسم المعروض "My StyleConfig".
view

StyleConfigView

اختياريّ. تمثّل هذه السمة المجموعة الفرعية من StyleConfig المطلوب عرضها. في حال عدم ضبط هذا الخيار، يكون السلوك التلقائي هو عرض FULL.

ListStyleConfigsResponse

ردّ على طلب إدراج StyleConfigs

الحقول
style_configs[]

StyleConfig

‫StyleConfigs.
next_page_token

string

رمز مميز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة. غير متاحة حاليًا.

MapConfig

يمثّل هذا الصف خريطة واحدة في تطبيق عميل لواجهة Maps API. ‫MapConfig هو المورد الرئيسي لـ MapContextConfigs ويتيح تصميمًا مخصّصًا في حِزم تطوير البرامج (SDK) للأجهزة الجوّالة والويب. يمكن أن يحتوي MapConfig على عدة MapContextConfigs، يطبّق كل منها أنماطًا على أشكال خرائط معيّنة. Next ID = 9;

الحقول
name

string

النتائج فقط. المعرّف. اسم المورد الخاص بإعدادات MapConfig هذه. على سبيل المثال: "projects/my-project-123/mapConfigs/234".
display_name

string

اختياريّ. الاسم المعروض لـ MapConfig هذا، كما يحدّده المستخدم.
description

string

اختياريّ. وصف MapConfig هذا، كما يحدّده المستخدم.
map_id

string

النتائج فقط. معرّف الخريطة الخاص بـ MapConfig هذا، ويُستخدَم لتحديد الخريطة في تطبيقات العميل. يتم إنشاء هذا الحقل للقراءة فقط عند إنشاء MapConfig.
map_features

MapFeatures

اختياريّ. ميزات الخريطة التي تنطبق على إعدادات الخريطة هذه
map_type

MapRenderingType

اختياريّ. تمثّل هذه السمة نوع الخريطة في MapConfig. في حال عدم ضبط هذا الخيار، يكون السلوك التلقائي هو استخدام نوع الخريطة النقطية.
create_time

Timestamp

النتائج فقط. تشير إلى وقت إنشاء إعدادات الخريطة.
update_time

Timestamp

النتائج فقط. تشير إلى وقت آخر تعديل أُجري على إعدادات الخريطة.

MapContextConfig

تتضمّن هذه الفئة إعدادات الأنماط الخاصة بالخريطة. يربط MapContextConfig بين عناصر التصميم، مثل StyleConfig وDatasets، وبين أشكال خرائط محدّدة من MapConfig. عند تحميل MapConfig في حزمة SDK، يتم تطبيق معلومات التصميم ومجموعة البيانات من MapContextConfig على أشكال الخرائط المحدّدة. Next ID = 10;

الحقول
name

string

النتائج فقط. المعرّف. اسم المورد الخاص بـ MapContextConfig هذا. على سبيل المثال: projects/{project_id}/mapConfigs/{map_id}/mapContextConfigs/{map_context_config_id}
map_config

string

الحقل مطلوب. اسم مورد MapConfig المرتبط بـ MapContextConfig. التنسيق: projects/{project}/mapConfigs/{map_config}. هذا الحقل مطلوب ولا يمكن إغفاله.
style_config

string

الحقل مطلوب. اسم مورد StyleConfig الذي يحدّد نمط MapContextConfig هذا. هذا الحقل مطلوب ولا يمكن إغفاله. التنسيق: projects/{project}/styleConfigs/{style_config}
dataset[]

string

اختياريّ. اسم مورد مجموعة البيانات المرتبط بـ MapContextConfig هذا. هذا الحقل اختياري ويمكن حذفه. في حال عدم توفّره، لن يتم ربط أي مجموعات بيانات بـ MapContextConfig. في حال تحديد مجموعة بيانات، سيتم تطبيقها على MapContextConfig. التنسيق: projects/{project}/datasets/{dataset}
alias

string

اختياريّ. اسم MapContextConfig الذي يحدّده المستخدم ويمكن قراءته.
map_variants[]

MapVariant

الحقل مطلوب. أنواع الخرائط التي يمكن تطبيق MapContextConfig عليها. إذا كانت فارغة، سيتم تطبيق MapContextConfig تلقائيًا على نوع خريطة ROADMAP فقط.
create_time

Timestamp

النتائج فقط. تشير هذه السمة إلى وقت إنشاء MapContextConfig.
update_time

Timestamp

النتائج فقط. تشير إلى وقت آخر تعديل أُجري على MapContextConfig.

MapVariant

أنواع الخرائط المحتملة التي يمكن تطبيق MapContextConfig عليها. يتم تجميع أشكال الخرائط في شكلَين: فاتح وداكن. لا يمكن إقران خيار "فاتح" بخيار "داكن" في MapContextConfig نفسه. تتضمّن "الخرائط الخفيفة" ما يلي: ROADMAP وSATELLITE وTERRAIN وNAVIGATION وTRANSIT وABSTRACT3D وPHOTOREALISTIC3D. تتضمّن الأشكال الداكنة ما يلي: ROADMAP_DARK وNAVIGATION_LOW_LIGHT وTERRAIN_DARK وTRANSIT_DARK.

على سبيل المثال، ما يلي هو عملية ربط صالحة: {MapContextConfig 1: [ROADMAP, NAVIGATION]} {MapContextConfig 2: [ROADMAP_DARK, NAVIGATION_LOW_LIGHT]}

في ما يلي عملية إقران غير صالحة: {MapContextConfig 1: [ROADMAP, ROADMAP_DARK]}

عمليات التعداد
ROADMAP تمثّل هذه السمة نوع خريطة الإرشادات التفصيلية التلقائي.
ROADMAP_DARK إصدار داكن من نوع خريطة "خريطة الطريق"
SATELLITE صور القمر الصناعي
TERRAIN نوع خريطة التضاريس
TERRAIN_DARK نسخة داكنة من نوع خريطة التضاريس
NAVIGATION نوع خريطة التنقّل
NAVIGATION_LOW_LIGHT إصدار منخفض الإضاءة من نوع خريطة التنقّل.
TRANSIT نوع خريطة النقل العام
TRANSIT_DARK نسخة داكنة من نوع خريطة النقل العام
ABSTRACT3D نوع خريطة ثلاثية الأبعاد تجريدية
PHOTOREALISTIC3D نوع خريطة ثلاثية الأبعاد لصور واقعية

MapFeatures

تمثّل هذه السمة مجموعة من ميزات الخريطة التي تنطبق على MapConfig. يتم توريث الميزات التي تم ضبطها على MapConfig من خلال جميع MapContextConfigs التابعة لها. Next ID = 3;

الحقول
simple_features[]

SimpleFeature

اختياريّ. تمثّل هذه السمة الميزة المرئية التي سيتم استخدامها لهذه الخريطة.
poi_boost_level

int32

اختياريّ. مستوى تحسين نقاط الاهتمام، حيث يشير الصفر إلى عدم التحسين وتشير القيم السالبة إلى خفض مستوى التحسين تظهر "نقاط الاهتمام" المحسّنة بمستوى تصغير أقل من المستوى التلقائي، والعكس صحيح بالنسبة إلى "نقاط الاهتمام" غير المحسّنة. يتيح حاليًا مستويَين من التعزيز، لذا يتم حصر المستوى في النطاق [-2, 2]. في حال عدم تحديدها، سيتم استخدام كثافة نقاط الاهتمام المحدّدة في ورقة الأنماط إذا كانت متوفرة. وفي الحالات الأخرى، لن يتم تطبيق أي كثافة لنقاط الاهتمام.

SimpleFeature

تمثّل هذه السمة مجموعة من عناصر الخريطة التي تؤثّر في البنية الأساسية للخريطة.

عمليات التعداد
SIMPLE_FEATURE_UNSPECIFIED سمة مرئية غير محدّدة
FLATTEN_BUILDINGS تسطيح جميع المباني في الخريطة
ICONIC_ICONS تؤثّر في طريقة عرض الرموز.

MapRenderingType

نوع الخريطة التي سيتم عرضها. السلوك التلقائي هو RASTER في حال عدم تحديده.

عمليات التعداد
RASTER خريطة معروضة باستخدام التنفيذ المستند إلى الصور النقطية
VECTOR خريطة معروضة باستخدام WebGL

StyleConfig

تمثّل هذه السمة نمطًا واحدًا في تطبيق عميل لواجهة برمجة التطبيقات Maps API. يحتوي StyleConfig على ورقة الأنماط التي تحدّد المظهر المرئي للخريطة. Next ID = 9;

الحقول
name

string

النتائج فقط. المعرّف. اسم المورد الخاص بـ StyleConfig هذا على سبيل المثال: "projects/my-project-123/styleConfigs/234".
display_name

string

اختياريّ. الاسم المعروض لـ StyleConfig هذا، كما يحدّده المستخدم.
description

string

اختياريّ. وصف StyleConfig هذا، كما يحدّده المستخدم.
style_id

string

النتائج فقط. المعرّف الفريد لهذا النمط. هذا حقل للقراءة فقط يتم إنشاؤه عند إنشاء StyleConfig.
json_style_sheet

string

اختياريّ. تمثيل JSON لورقة الأنماط الخاصة بـ StyleConfig هذا في حال عدم تحديدها، سيتم استخدام نمط "خرائط Google" الأساسي. لمزيد من المعلومات حول تنسيق JSON المقبول، يُرجى الاطّلاع على https://developers.google.com/maps/documentation/javascript/cloud-customization/json-reference.
create_time

Timestamp

النتائج فقط. تشير إلى وقت إنشاء StyleConfig.
update_time

Timestamp

النتائج فقط. تشير إلى وقت آخر تعديل لـ StyleConfig.

StyleConfigView

مجموعة فرعية من StyleConfig المطلوب عرضها.

عمليات التعداد
STYLE_CONFIG_VIEW_UNSPECIFIED طريقة عرض غير محدّدة
FULL أدرِج json_style_sheet في الردّ.
METADATA_ONLY استبعِد json_style_sheet من الردّ.

UpdateMapConfigRequest

طلب تعديل MapConfig

الحقول
map_config

MapConfig

الحقل مطلوب. تمثّل هذه السمة MapConfig المطلوب تعديله.

يتم استخدام حقل name في MapConfig لتحديد MapConfig المطلوب تعديله. التنسيق: projects/{project}/mapConfigs/{map_config}
update_mask

FieldMask

اختياريّ. الحقل المحدّد الذي سيتم تعديله في MapConfig. في حال عدم تحديدها، سيتم تعديل MapConfig بالكامل. الحقول الصالحة هي:

  • display_name
  • description
  • map_features

UpdateMapContextConfigRequest

طلب تعديل MapContextConfig

الحقول
map_context_config

MapContextConfig

الحقل مطلوب. تمثّل هذه السمة إعدادات MapContextConfig التي سيتم تعديلها.

يُستخدَم الحقل name في MapContextConfig لتحديد MapContextConfig المطلوب تعديله. التنسيق: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}
update_mask

FieldMask

اختياريّ. قائمة الحقول التي سيتم تعديلها. في حال عدم تحديدها، سيتم تعديل MapContextConfig بالكامل. الحقول الصالحة هي:

  • display_name
  • alias
  • map_variants
  • style_config
  • dataset

UpdateStyleConfigRequest

طلب تعديل StyleConfig

الحقول
style_config

StyleConfig

الحقل مطلوب. تمثّل هذه السمة StyleConfig المطلوب تعديله.

يُستخدَم الحقل name في StyleConfig لتحديد StyleConfig المطلوب تعديله. التنسيق: projects/{project}/styleConfigs/{style_config}
update_mask

FieldMask

اختياريّ. قائمة الحقول التي سيتم تعديلها. إذا لم يتم تحديدها، سيتم تعديل StyleConfig بالكامل. عند تعديل ورقة الأنماط، لا تعدِّل خيار المنتج. هذه عملية غير صالحة. الحقول الصالحة هي:

  • display_name
  • description
  • json_style_sheet