يتيح لك قالب Map Viewer إنشاء التطبيقات التي تتيح للمستخدمين البحث عن خريطة مفردة أو معرض خرائط وعرضها. لمعرفة المزيد والاطلاع على أمثلة لتطبيقات Map Viewer، راجع هذه القصة.
عند إنشاء تطبيق من هذا القالب، يجب عليك توفير عنوان لإنشاء تطبيق. استخدم أداة الإعدادات لتخصيص Map Viewer.
المتطلبات
متطلبات قالب عارض الخريطة هي كما يلي:
- يمكن أن تكون خرائط الويب عامة أو مُؤمَّنة. للوصول إلى خريطة ويب مُؤمَّنة في مؤسسة أو بوابة ArcGIS Enterprise الإلكترونية باستخدام OAuth2، سجل تطبيقك، وأدخل معرف عميل. لمزيد من المعلومات،راجع تسجيل الدخول إلى التطبيق. وافتراضيًا، لا تظهر إلا خرائط الويب العامة في معرض Map Viewer، وللوصول إلى الخرائط المُؤمَّنة، قم بتمكين خاصية دعم الخرائط المُؤمَّنة في إعدادات التطبيق.
- وإضافة إلى خرائط الويب، فإن سلسلة الاستعلام عن Map Viewer يدعم أيضًا حزم خرائط الجوال (MMPKs). ونظرًا لقيود الترخيص في القالب الافتراضي، يجب عليك تسجيل الدخول إلى حساب البوابة الإلكترونية أو الحساب المؤسسي من أجل الوصول إلى MMPKs وعرضها، إلا إذا تم إنشاء MMPK باستخدام ملحق ناشر ArcGIS Pro باستخدام مجهول مُمكَّن. لمزيد من المعلومات عن إنشاء MMPKs، راجع وثائق ArcGIS Pro في حزم خرائط الجوال، أو منشور مدونة استخدام ArcGIS Pro لإنشاء خرائط دون اتصال - الجزء الأول.
- يجب أن يكون إصدار خريطة الويب هو 2.0 أو أحدث، وإلا سيفشل تحميل الخريطة.
- اختياري - لاستخدام بحث المعلم في التطبيق، يجب أن تحتوي طبقة واحدة على الأقل على إمكانية البحث التي تم تكوينها في خريطة الويب.
- اختياري - تمكين العناصر المنبثقة في خريطة الويب لاستخدام معلم تحديد خريطة الويب.
- اختياري— تكوين العلامات المرجعية في خريطة الويب لاستخدام معلم العلامة المرجعية.
- اختياري - لعرض مفتاح الخريطة، يجب أن تحتوي طبقة واحدة على الأقل لخريطة الويب على مفتاح خريطة مُعرف في خدمة الخريطة.
يعمل قالب عارض الخريطة جيدًا عند عرض خدمات الخريطة. قد يتم عرض خدمات المعالم ولكن عادة ما تكون بطيئة للرسم.
تخصيص التطبيق
بمجرد إنشاء التطبيق، يمكنك تخصيصه عبر تغيير إعدادات التطبيق في إعدادات التطبيق.
شغِّل AppStudio ثم انقر فوق الإعدادات > الخصائص في اللوحة الجانبية. يُدرج الجدول التالي محتويات علامات التبويب في علامة تبويب خصائص عارض الخريطة ويتم فرزها بواسطة علامة التبويب التي تظهر فيها، وكذلك أغراضها. ويمكن أيضًا تعديلها مباشرةً في ملف appinfo.json الخاص بالتطبيق. إذا قمت بتغيير أي خصائص، فانقر على تطبيق لحفظها قبل بدء التطبيق مرة أخرى.
محتويات علامة تبويب شاشة البدء
| الخاصية | اسم JSON | النوع | الوصف |
|---|---|---|---|
صورة الخلفية | startBackground | سلسلة (عنوان URL للصورة) | صورة تستخدم لخلفية صفحة البدء. |
لون العلامة التجارية | startForegroundColor | السلسلة (قيمة اللون) | لون يستخدم في صورة اللون الرئيسي. |
حجم الخط الأساسي | baseFontSize | رقم | يُحدد حجم خط القاعدة المستخدمة عبر التطبيق. |
ملف خط العنوان | regularFontTTF | سلسلة (عنوان URL لملف الخط) | يعين خط العنوان المخصص المطلوب استخدامه في التطبيق. سيتم استخدام هذا الخط في العناوين وعناوين الصفحات وما إلى ذلك. |
ملف خط النص | mediumFontTTF | سلسلة (عنوان URL لملف الخط) | يُعيّن خط النص المخصص لاستخدامه في التطبيق. سيتم استخدام هذا الخط في أوصاف الصور، وحول النص، وهكذا. |
البريد الإلكتروني للملاحظات | feedbackEmail | سلسلة (معرف البريد الإلكتروني) | عنوان البريد الإلكتروني الذي سيتم إرسال ملاحظات المستخدم له. |
إظهار إخلاء المسئولية | showDisclaimer | منطقي (صحيح|خطأ) | إظهار نص إخلاء المسئولية في صورة عنصر منبثق في التطبيق. هذا النص هو المحتوى من قسم قيود الدخول والاستخدام في علامة تبويب التفاصيل. |
محتويات علامة تبويب المعرض
| الخاصية | اسم JSON | النوع | الوصف |
|---|---|---|---|
استعلام الخرائط | galleryMapsQuery | السلسلة | أدخل استعلام ArcGIS لتحديد خرائط الويب أو MMPK من البوابة الإلكترونية لعرضها في المعرض. يمكن أن يكون ذلك أي سلسلة صحيحة مثل USA أو معرف عنصر صالح، مثل d5e02a0c1f2b4ec399823fdd3c2fdebd. |
إجمالي النتائج للعرض في المعرض | maxNumberOfQueryResults | رقم | أدخل العدد الأقصى لخرائط الويب التي يجب إرجاعها من استعلام البوابة الإلكترونية. |
عنوان url للبوابة الإلكترونية | portalUrl | السلسلة | عنوان URL لـ ArcGIS Portal للاستعلام عن خرائط الويب. |
معرف مجموعة خرائط الأساس | baseMapsGroupId | السلسلة | يسرد خرائط الأساس من المجموعة المتوفرة. |
دعم الخرائط المُؤمَّنة | supportSecuredMaps | منطقي (صحيح|خطأ) | توفير إمكانية تسجيل الدخول إلى المؤسسة للوصول إلى خرائط الويب المُؤمَّنة وMMPKs بموجب معلمات الاستعلام. |
تخطي تسجيل الدخول | enableAnonymousAccess | منطقي (صحيح|خطأ) | يوفر إمكانية تجاوز تسجيل الدخول، وعرض MMPKs وخرائط الويب المتاحة لكل الأشخاص، والمنشأة باستخدام ملحق ناشر ArcGIS Pro باستخدام مجهول مُمكَّن. الوضع الافتراضي هو صحيح. |
دعم التحرير | supportEditAttributes | منطقي (صحيح|خطأ) | يتيح تعيين هذا الخيار على "صواب" إمكانية تحرير البيانات الجدولية للمعالم إذا كانت طبقة المعالم قابلة للتحرير وكان المستخدم لديه الإذن لتحرير المعالم. |
الخرائط المطلوب عرضها في المعرض | mapTypes | الخيارات (مربع التحرير والسرد) | تحدد نوع الخرائط المعروضة في معرض عارض الخرائط. توجد ثلاث قيمة محتملة: لن تعرض showWebMapsOnly إلا خرائط الويب على الإنترنت، ولن تعرض showOfflineMapsOnly إلا حزم خرائط الجوال، كما لن تعرض showBoth إلا خرائط الويب وMMPKs. |
حقل فرز البوابة الإلكترونية | portalSortField | السلسلة | تحديد اسم الحقل المستخدم لتنفيذ فرز خرائط الويب المعروضة في المعرض. تتضمن القيم الممكنة: العنوان، والذي تم إنشائه، والنوع، والمالك، والمُعدل، و avgRating، و numRatings، و numComments، و numViews. القيمة الافتراضية مُعدَّلة. |
ترتيب فرز البوابة الإلكترونية | portalSortOrder (asc|desc) | السلسلة | تحديد نوع خرائط الويب المعروضة في المعرض بترتيب تصاعدي أو تنازلي، بناءً على portalSortField المعين. القيمة الافتراضية هي desc. |