Skip To Content

استخدم معلمات عنوان URL لإنشاء الخرائط وتعديلها

تحتوي الخرائط التي يتم إنشاؤها في بوابة ArcGIS Enterprise الإلكترونية على خريطة أساس وطبقات بيانات ونطاق ومفتاح خريطة وأدوات تنقل مثل التكبير/التصغير والتحريك والباحث عن الأماكن والعلامات المرجعية. تحتوي العديد من الخرائط أيضًا على عناصر تفاعلية، مثل معرض خرائط الأساس وأدوات القياس والعناصر المنبثقة وأزرار لتشغيل البيانات عبر الوقت.

بالإضافة إلى إنشاء الخرائط باستخدام Map Viewer أو Map Viewer Classic، يمكنك إنشاء الخرائط وتعديلها مباشرةً باستخدام معلمات URL.

على سبيل المثال، يمكنك إنشاء خريطة بمعلمات URL التي تعرض المناطق الأحيائية والمناطق البيئية.

myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer&url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/Resolve_Ecoregions/FeatureServer

يمكنك إنشاء خريطة باستخدام معلمات URL التي تُظهر مزارع الرياح الساحلية في المملكة المتحدة في Map Viewer Classic.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=https%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

على سبيل المثال، يمكن استخدام عنوان URL الخاص بـ Map Viewer في الحالات التالية:

  • إذا كنت لا تحتاج إلى تضمين الكثير من طبقات الإسناد أو الطبقات التشغيلية ولا تحتاج إلى تطبيق أنماط محددة على محتوى الخريطة، فاستخدم عنوان URL لفتح أحد إصدارات Map Viewer. على سبيل المثال، إذا كان موقع الويب يسمح للأشخاص بالبحث عن عنوان أو عرض طبقة واحدة مرتبطة بموقعك، يمكنك تضمين رابط في موقع الويب بحيث يفتح Map Viewer باستخدام خريطة الأساس المحددة والطبقة الفردية المطلوبة.
  • تحتاج إلى الارتباط بخريطة ويب محفوظة من موقع ويب أو بريد إلكتروني. يمكنك استخدام عنوان URL الذي يفتح خريطة الويب المحددة.

ما الذي يجب تضمينه في عنوان URL

في Map Viewer Classic, يبدأ عنوان URL دائمًا بعنوان URL الخاص بالصفحة الرئيسية لبوابة الإلكترونيةArcGIS Enterprise ، بالإضافة إلى /webmap/viewer.html? وواحد أو أكثر من معلمات الاستعلام المدرجة أدناه في Map Viewer، يبدأ عنوان URL دائمًا باسم ArcGIS Enterprise المؤهل بالكامل ومحول الويب أو سياق موازن التحميل، بالإضافة إلى apps/mapviewer/index.html? وواحد أو أكثر من معلمات الاستعلام المدرجة أدناه. لتضمين أكثر من معطى، قم باستخدام علامة العطف (&) لفصل المعطيات عن بعضها. ستجد أمثلة على استخدام معلمات متعددة عبر هذه الصفحة.

يفتح المثال الأول أدناه Map Viewer؛ ويفتح الثاني Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=8

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=8
ملاحظة:‏

إذا تم توفير أي مورد في معلمة URL في صورة HTTP، يجب أن يكون عنوان URL للخريطة HTTP أيضًا. لإضافة مزيد من الأمان، استخدم عنوان URL لـ HTTPS إن أمكن.

ترميز جميع معلمات الاستعلام

يجب ترميز جميع معطيات الاستعلام. يضمن ترميز عنوان URL إرسال الأحرف الصالحة إلى البوابة الإلكترونية. يستبدل التكويد الأحرف غير الصحيحة بـ % متبوعة بشكل سداسي مكافئ لها.

على سبيل المثال، فيما يلي معطيات عنوان URL التي لم يتم ترميزها:

basemapUrl=https://myportal.domain.com:7443/arcgis/rest/services/Ocean/World_Ocean_Base/MapServer

فيما يلي نفس المعطيات التي تم ترميزها:

basemapUrl=https%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean%2FWorld_Ocean_Base%2FMapServer

يجب أيضًا تشفير المعلمات ضمن المعلمات، على سبيل المثال:

urls=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttps%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

يحتوي الإنترنت على العديد من المواقع والأدوات المجانية التي تُستخدم لإنشاء عناوين URL مرمزة. من أجل سهولة القراءة، لا يتم ترميز بقية الأمثلة في هذا الموضوع.

فتح خريطة محفوظة

لفتح خريطة محفوظة تم إنشائها باستخدام Map Viewer أو Map Viewer Classic، استخدم webmap= والمعرّف الفريد للخريطة.

في المثال الأول، سيتم فتح خريطة الويب التي تحتوي على معرف 75a3ce8990674a5ebd5b9ab66bdab893 في Map Viewer Classic. يفتح عنوان URL الثاني نفس الخريطة في Map Viewer.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=75a3ce8990674a5ebd5b9ab66bdab893

في هذا المثال، سيتم فتح خريطة الويب ذات المعرف 29990ur6423j1180p53f9t30019491 في Map Viewer باستخدام النطاق الذي تم تعيينه على -117.996342,33.841078,-117.993692,33.844375:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=29990ur6423j1180p53f9t30019491&extent=-117.996342,33.841078,-117.993692,33.844375

تعريف خريطة الأساس

لتحديد خريطة الأساس، قم بتعيين basemapUrl= للطبقة. إذا لم يتم تعريف خريطة الأساس، فستُستخدم خريطة الأساس الافتراضية، وهي خريطة الأساس الطبوغرافية العالمية.

في مثال عنوان URL الأول، يفتح Map Viewer باستخدام خريطة العالم المادية المستخدمة كخريطة أساس: يفتح عنوان URL للمثال الثاني في Map Viewer Classic.

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://basemaps.arcgis.com/arcgis/rest/services/OpenStreetMap_v2/VectorTileServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

في هذا المثال، يفتح Map Viewer باستخدام خريطة العالم الفعلية المستخدمة كخريطة أساس وطبقة تشغيلية بمعرف العنصر 9e2f2b544c954fda9cd13b7f3e6eebce الموجودة في الخريطة:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer&layers=9e2f2b544c954fda9cd13b7f3e6eebce

تضمين طبقة مرجعية

لتضمين طبقة الإسناد مع خريطة الأساس، قم بتعيين basemapReferenceUrl= للطبقة. يجب استخدام معلمة basemapReferenceUrl= إضافةً إلى معلمة basemapUrl.

في هذا المثال، يفتح Map Viewer Classic مع طبقة خريطة أساس الصور العالمية وطبقة الإسناد التي تم تعيينها على طبقة الحدود والأماكن:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer&basemapReferenceUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer

تعريف الطبقات التشغيلية

لتعريف الطبقات التشغيلية التي تتراكب مع خريطة الأساس، استخدم webmap= أو layers= أو layerIds= أو url= أو urls=. إذا كانت الطبقة عنصرًا في موقع الويب، فاستخدم layers= حتى تحصل على جميع تكوينات الطبقة. لإضافة طبقات فرعية فردية من طبقة معالم تحتوي على طبقات فرعية متعددة، استخدم layerIds=. إذا لم تكن الطبقة في موقع الويب، فاستخدم url= أو urls=.

تقبل معلمة layers= مُعرف عنصر مفرد أو مُعرفات عناصر متعددة. للطبقات المتعددة، استخدم قائمة مفصولة بفاصلة من المُعرّفات (&layers=<itemID>,<itemID>,<itemID>).

يفتح المثال الأول في Map Viewer. يفتح الثاني في Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8152694dd9594393a1db4d62d2020fe3&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3

تقبل معلمة layerIds= مُعرف طبقة واحد أو معرفات طبقات متعددة. عندما تتضمن طبقة المعالم العديد من الطبقات الفرعية، استخدم معلمة layerIds= لإضافة طبقات فرعية فردية. للطبقات الفرعية المتعددة، استخدم قائمة مفصولة بفاصلة من المُعرّفات (&layerIds=0,1,2).

يفتح المثال الأول في Map Viewer. يفتح الثاني في Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2
https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2

تقبل معلمة url= عنوان URL لطبقة مفردة.

راجع الأمثلة التالية:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
     url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServer

استخدم urls= لتضمين أكثر من طبقة واحدة. فصل الطبقات بفاصلة. يستند نطاق الخريطة إلى الطبقة الأخيرة في القائمة أو الخدمة الأبطأ المراد تحميلها. للتكبير إلى مدى محدد، قم بتضمين معلمة extent=.

يفتح عنوان URL الأول الخريطة في Map Viewer. يفتح عنوان URL الثاني في Map Viewer Classic:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4&extent=-108,40,-85,31

https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_METAR_current_wind_speed_direction_v1/FeatureServer,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/NOAA_storm_reports_v1/FeatureServer?layers=show:4

اعتبارًا من ArcGIS 10.5، يمكنك استخدام عملية ?layers من على خدمة المعلم.

راجع الأمثلة التالية:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/RedlandsEmergencyVehicles/FeatureServer?layers=show:1,2

تحديد مستوى المقياس وتوسيط الخريطة

يتم تعيين المقياس تلقائيًا لخريطة في Map Viewer Classic عند استخدامك معلمة webmap أو find. إذا كنت تستخدم معلمة webmap، فسيتم تقريب الخريطة تلقائيًا إلى مدى الخريطة الكامل، ما لم تُستخدم معلمات عنوان URL أخرى مثل level وcenter أو extent لتجاوز مقياس خريطة الويب. إذا كنت تستخدم معلمة find، يتم تكبير الخريطة تلقائيًا وصولاً إلى أفضل مدى للموقع الذي تم العثور عليه.

لتحديد مستوى مقياس محدد، استخدم معلمتي center وlevel. تقبل معلمة level مُعرّف مستوى مقياس رسم ذاكرة التخزين المؤقت كما هو مدرج في نقطة نهاية خدمة REST لخريطة الأساس المتجانبة. ترتبط الدقة بالمقياس بشكل عكسي. معلمة level مدعومة فقط لخرائط الأساس المتجانبة وليس لخرائط الأساس التي تم إنشاؤها من خدمات خريطة ديناميكية وبيانات أخرى غير متجانبة.

لتركيز الخريطة في موقع محدد، قم بتعيين center باستخدام الإحداثيات الجغرافية (س وص) أو الإحداثيات المُسقطة (س وص، WKID). يُمكن استخدام الفواصل أو الفواصل المنقوطة كفواصل. استخدم الفاصلة المنقوطة في حالة استخدام الفاصلة كعلامات عشرية للأرقام.

ملاحظة:‏

يجب استخدام معلمتي level وcenter معًا. يتم تجاهل معلمة level إذا تم استخدامها بمفردها.

راجع مثال الإحداثيات الجغرافية التالي في Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4

راجع مثال الإحداثيات الجغرافية التالي في Map Viewer Classic:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

راجع مثال الإحداثيات المسقطة التالي في Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=500000,5500000,102100&level=4

تعريف المدى

لتعريف مدى الخريطة، استخدم extent. تقبل معلمة extent الإحداثيات الجغرافية (GCS) مثل MinX وMinY وMaxX وMaxY أو الإحداثيات المسقطة (PCS) مثل MinX وMinY وMaxX وMaxY وWKID. يُمكن استخدام الفواصل أو الفواصل المنقوطة كفواصل. استخدم الفاصلة المنقوطة في حالة استخدام الفاصلة كعلامات عشرية للأرقام.

راجع مثال الإحداثيات الجغرافية التالي في Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-117.20,34.055,-117.19,34.06

راجع مثال الإحداثيات المسقطة التالي في Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

راجع مثال الإحداثيات المسقطة التالي في Map Viewer Classic:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

تعيين رؤية الطبقة

لتعيين رؤية الطبقات الفرعية للطبقة التي تفتحها في الخريطة، استخدم layers=show:.

في هذا المثال، تكون الطبقة الفرعية 3 مرئية ولكن الطبقات الفرعية الأخرى غير مرئية:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=Pennsylvania

العثور على الموقع أو المعلم لفتح الخريطة

للعثور على موقع أو معلم بمجرد فتح الخريطة، استخدم find. يتم تكبير/تصغير الخريطة تلقائيًا إلى أقرب حالة مطابقة وتم إضافة محدد وسيلة الشرح إلى الخريطة. تقبل معلمة find العناوين أحادية الخط والعناوين الجزئية (مثل مدينة فقط أو دولة فقط) وأسماء الأماكن وإحداثيات خط الطول-دائرة العرض.

يستخدم المثال التالي عنوانًا أحادي الخط في Map Viewer:

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?find=380 new york st,redlands,ca
تلميح:

للبحث عن موقع أو معلم في طبقة قابلة للبحث، يمكنك تضمين معلمة webmap= مع معرف الخريطة الفريد.

إضافة نُقطة

لإضافة نقطة إلى الخريطة، استخدم marker=<x>,<y>. يُمكن أيضًا تضمين الخصائص الاختيارية التالية:

  • <wkid>—الإسناد المكاني للإحداثين x وy المُراد إضافتهما إلى الخريطة. إذا لم تقم بتضمين WKID، سيتم استخدام إحداثيات GCS.
  • <encoded title>—عنوان العنصر المنبثق النقطي. إذا لم تقم بتضمين العنوان، ستصبح العناصر المنبثقة فارغة.
  • <encoded icon URL>—رمز النقطة. إذا كنت لا ترغب في تضمين الرمز، سيتم استخدام رمز علامة زرقاء.
  • <encoded label>—التسمية المجاورة لرمز النقطة.

مثال

يستخدم المثال التالي فواصل منقوطة:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

اعتبارات

ضع في اعتبارك ما يلي عند إضافة نقطة إلى خريطة:

  • في Map Viewer Classic تمت إضافة النقطة إلى طبقة ملاحظات الخريطة الجديدة في موقع إحداثيات x وy المُحدد.
  • يلزم وجود إحداثيات <x>,<y> لإضافة نقطة.
  • يتعين عليك ترميز المعلمات title، وicon، وlabel.
  • يجب إضافة الخصائص بهذا الترتيب: marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
  • يُمكن استخدام الفواصل أو الفواصل المنقوطة كفواصل. استخدم الفاصلة المنقوطة في حالة استخدام الفاصلة كعلامات عشرية للأرقام.
  • استخدم القيم الفارغة. لا تستخدم الفواصل. على سبيل المثال، لتحديد تسمية وعدم تحديد خصائص اختيارية أخرى، أضف التسمية كمعلمة سادسة مع تحديد قيم فارغة للخصائص الأخرى (x;y;;;;label).
  • إذا كنت ترغب في تكبير الخريطة (إضافةً إلى التمركز على النقطة)، فقم بتضمين معلمة level.
  • يُمكن تحرير طبقة ملاحظات الخريطة وحفظها بصفتها خريطة أو عنصر.
  • يُمكن لحسابات المؤسسة استخدام النقطة للحصول على الاتجاهات و القيام بعمليات التحليل.

إخفاء جزء التفاصيل

ملاحظة:‏

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

لإخفاء جزء التفاصيل في Map Viewer Classic، استخدم mapOnly=true.

في هذا المثال، يتم فتح خريطة الويب المحفوظة ذات المعرف b487d81007294fb5a0be9e10a411f2d0 في Map Viewer Classic، ولكن يتم إخفاء جزء التفاصيل:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=b487d81007294fb5a0be9e10a411f2d0&mapOnly=true