استخدم معلمات عنوان URL لتعديل الخرائط المضمنة

ملاحظة:‏

هذه الوظائف مدعومة حاليًا فقط في Map Viewer Classic. سيكون متاحًا في إصدار مستقبلي من Map Viewer.

Map Viewer Classic يوفر كود HTML جاهز للاستخدام لـ تضمين الخريطة في الموقع. يمكنك اختيار خيارات تضمين الخريطة مثل زر البداية والتحكم بالتكبير والتصغير ووسيلة الخريطة التي تم إضافتها للكود الذي قمت بنسخه ولصقه في الموقع. هناك طريقة أخرى لإضافة الخيارات هو استخدام معلمات عنوان URL.

يبدأ عنوان URL للخريطة المضمنة بعنوان URL للمؤسسة أو الموقع العام (https://www.arcgis.com) و/apps/Embed/index.html?webmap=<your web map ID>. فيما يلي أحد الأمثلة:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118

يتضمن عنوان URL واحد أو أكثر من معطيات الاستعلام المدرجة أدناه. تقوم بعض معلمات عنوان URL بتعديل الخريطة المضمنة بينما يقوم الآخرين بتعديل الوظائف المتوفرة في خريطة المضمنة. لتضمين أكثر من معطى، قم باستخدام علامة العطف (&) لفصل المعطيات عن بعضها. فيما يلي أحد الأمثلة:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118&legend=true&details=true

ملاحظة:‏

إذا تم توفير أي من الموارد في معلمة عنوان URL في صورة HTTP، يجب استبدال HTTP بـ HTTPS في عنوان URL وإتاحة الوصول إلى جميع الموارد باستخدام HTTPS فقط.

تخطيط

تمنحك المعلمات التالية التحكم في شكل الخريطة وأجوائها:

• theme—يحدد سمة اللون المطبقة على اللوحة الجانبية والأزرار. تكون الخيارات الصحيحة light أو dark.
• legend—عند التعيين على true، تظهر وسيلة الإيضاح في اللوحة الجانبية عارضةً الطبقات بالخريطة.
• details—عند التعيين على true، يظهر وصف الخريطة في اللوحة الجانبية.
• active_panel—يحدد علامة التبويب النشطة في اللوحة الجانبية عند تحميل الخريطة. تكون الخيارات الصحيحة legend أو details. يجب تعيين معلمات legend أو details على true إذا استُخدمت على أنها قيمة لمعلمة active_panel.
• show_panel—عند التعيين على true، تظهر اللوحة الجانبية عند تحميل الخريطة. الوضع الافتراضي هو false.
• popup_sidepanel—عند التعيين على true، يتم تمثيل معلومات النوافذ المنبثقة في علامة تبويب المعلومات في اللوحة الجانبية وليس في الخريطة.
• zoom_position—يحدد موقع أزرار التحكم بالتكبير/التصغير. تكون الخيارات الصحيحة top-left (الافتراضي)، bottom-left أو top-right أو bottom-right. إذا تم تعيين معلمة home على true، يتحرك زر الصفحة الرئيسية أيضًا تبعًا لقيمة معلمة zoom_position.
• logoimage—هو عنوان URL للصورة المستخدمة باعتبارها صورة مصغرة قابلة للنقر في مخطط الخريطة. عند النقر فوق الصورة المصغرة يتم إعادة توجيه عنوان URL ليتم تعيينه مع معلمة logolink.
• logolink—هو عنوان URL للموقع الخارجي أو مصدر الويب. يؤدي النقر فوق الصورة المصغرة التي تم تعيينها مع معلمة logoimage إلى إعادة توجيه عنوان URL المعين في logolink.

مثال على الخريطة المضمنة مع الموضع الغامق ووسيلة الإيضاح وعرض اللوحة عند التحميل وأزرار التكبير أعلى اليمين وصورة الشعار التي تتصل بصفحة الويب.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&theme=dark&legend=true&show_panel=true&zoom_position=top-right
&logoimage=https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
&logolink= https://en.wikipedia.org/wiki/Indiana_University

مثال على الخريطة المضمنة مع وسيلة الإيضاح والتفاصيل باعتبارها علامة تبويب نشطة في اللوحة والنوافذ المنبثقة التي تعرض في اللوحة الجانبية في علامة تبويب المعلومات.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&legend=true&details=true&active_panel=details&popup_sidepanel=true

تخطيط

تتحكم المعلمات التالية في التنقل في الخريطة ورؤية عناصر الخريطة:

• webmap—معرّف خريطة الويب للعرض داخل map viewer المضمن، مثل webmap=432a8d7ca22d4b5b859e0bdaa30ae118. تعد معلمة webmap إلزامية.
• extent—يُحدد المدى المستخدم عند تحميل الخريطة. يقوم هذا بتجاوز المدى الافتراضي للخريطة. تعتبر قيم نظام الإحداثيات الجغرافية فقط صحيحة.
• center—يضع الخريطة في المركز باستخدام الإحداثيات الجغرافية (س وص).
• level—مُعرّف مستوى المقياس المُخزَّن مؤقتًا كما هو مدرج في نقطة نهاية REST لخريطة الأساس. يُحدد ذلك مستوى التكبير/التصغير الافتراضي عند تحميل الخريطة، مثل level=9.
• zoom—عند التعيين على true، تُعرَض أزرار التصغير والتكبير. يتم التحكم في موقعهم في الخريطة بواسطة معلمة zoom_position.
• home- عند التعيين إلى true، يتم عرض زر البداية. يستخدم زر البداية للانتقال للوراء إلى المدى الافتراضي للخريطة. إذا تم تعيين extent، يستخدم زر الصفحة الرئيسية المدى بدلاً من المدى الافتراضي للخريطة. تكون معلمة home صحيحة فقط إذا تم تعيين zoom أيضًا على true.
• scale- عند التعيين إلى true، يتم عرض شريط المقياس. يظهر شريط المقياس أسفل يسار الخريطة.
• disable_scroll- عند التعيين إلى true، يتم تعطيل تمرير الماوس للتكبير والتصغير. الوضع الافتراضي هو true.
• marker—يضع الصورة المطلوبة في صورة رمز علامة مع وجود نافذة منبثقة في الخريطة عند موقع محدد. بناء الجملة هو marker=longitude;latitude;wkid;description;URL;title. يتطلب خطوط الطول ودوائر العرض، والقيم الأخرى اختيارية. يجب أن يكون الوصف وقيم العنوان المكودة في عنوان URL‎. اترك القيمة الاختيارية فارغة إذا كنت لا تريد تضمينه. فيما يلي أحد الأمثلة:

  marker=-86.52;39.18;;Assembly%20Hall;https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png

• basemap_toggle—يتم عرض زر تبديل خريطة الأساس. يجب تعيينه على true لاستخدام alt_basemap.
• alt_basemap—يتحكم في خريطة الأساس المستخدمة باعتبارها خريطة أساس بديلة في تبديل خريطة الأساس. يجب تعيين معلمة basemap_toggle على true لاستخدام alt_basemap. إذا لم يكن هناك بديل مُحدد لخريطة الأساس، تستخدم خريطة أساس القمر الصناعي. القيم الصالحة هي streets وsatellite وhybrid وtopo وgray وoceans وnational-geographic وosm وterrain وdark-gray.

مثال على الخريطة الضمنة مع المدى المخصص، وأزرار التكبير/التصغير المعطلة، وشريط المقياس الموجود، وتمرير التكبير/التصغير بالفأرة الممكن ومعرض خريطة الأساس.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&extent=-86.179,39.923,-85.932,40.075
&zoom=false&scale=true&disable_scroll=false&basemap_gallery=true

مثل على الخريطة المضمنة مع المركز ومستوى مقياس التكبير/التصغير، وزر البداية وتبديل خريطة الأساس مع خريطة أساس بديلة.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&center=-86.39,39.84&level=16&home=true&basemap_toggle=true&alt_basemap=hybrid

البحث عن المعلم والموقع (البحث الجغرافي)

تبحث المعلمات التالية عن البيانات في الخريطة:

• search—عند التعيين على true، يتم عرض أداة البحث. تدعم عناصر واجهة الاستخدام البحث عن طريق التكويد الجغرافي والطبقات القابلة للتطبيق. يجب تعيين معلمة search كـ true لاستخدام find للطبقات التي يمكن البحث فيها في الخريطة.
• searchextent—عند التعيين على true، يُرجع البحث الجغرافي من خلال أداة البحث النتائج التي تقع ضمن النطاق الافتراضي للخريطة.
• find—يفتح الخريطة في موقع مُحدد. يمكن استخدام معلمة find للبحث عن طريق العناوين أو الأماكن (التكويد الجغرافي) أو للبحث عن قيم حقل البيانات الجدولية من الطبقة القابلة للبحث. تقوم المعلمة بإرجاع النتائج من كل موارد البحث التي يمكن للخريطة الوصول إليها. إذا كانت قيم الطبقة القابلة للبحث مماثلة لقيم التكويد الجغرافي، يمكن أن ينتج عنه نتائج مضللة. على سبيل المثال، قد يكون البحث عن أكواد FIPS ذات الخمسة أرقام من حقل الطبقة القابلة للبحث مُحير مع أكواد الرمز البريدي للولايات المتحدة ويُرجِع نتائج متعددة غير مرغوب بها. ضع في اعتبارك استخدام feature للبحث عن المعلم بدلاً من find في سيناريوهات مثل هذا السيناريو أو عند الحاجة إلى تحكم أكثر دقة في النتائج.
• feature—يتيح البحث عن معلم مُحدد في طبقة معلم يمكن البحث فيها. البحث عن المواقع بواسطة الطبقة يحتاج الإعداد بالخريطة للحقل القابل للبحث. يعد بناء الجملة feature=layerID;searchfield;searchvalue على سبيل المثال feature=CentralIndianaCities_634;PLACEFIPS;05860.

  يرجع عنوان URL التالي إلى المدن الهندية المركزية المثال السابق ويمكن استخدامها لاستكشاف مُعرف الطبقة للطبقة المطلوبة في الخريطة. لاحظ id:CentralIndianaCities_634 تحت operationalLayers. استبدل مُعرّف webmap بمُعرّف خريطة الويب للعثور على مُعرّف الطبقة.

  https://www.arcgis.com/sharing/rest/content/items/432a8d7ca22d4b5b859e0bdaa30ae118/data?f=json

مثال على الخريطة الضمنة التي تتضمن البحث، ومدى البحث، ويفتح موقع مُحدد.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&search=true&searchextent=true
&find=500%20S%20Capitol%20Ave,%20Indianapolis,%20IN%2046225

مثال على الخريطة مضمنة الذي يفتح المعلم المُحدد.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&feature=CentralIndianaCities_634;PLACEFIPS;05860