Skip To Content

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

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

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

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

myportal.domain.com/arcgis/apps/mapviewer/index.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer&url=https://services5.arcgis.com/9cBkZtsx7PSOoaCF/arcgis/rest/services/Maryland_Shoals/FeatureServer/0

يمكنك إنشاء خريطة باستخدام معلمات 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/home/webmap/viewer.html?center=20,45&level=4

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?center=20,45&level=4
ملاحظة:‏

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

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

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

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

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

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

basemapUrl=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2FOcean_Basemap%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= والمعرّف الفريد للخريطة.

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

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710

https://myportal.domain.com/arcgis/apps/mapviewer/index.html?webmap=8505192e747d440098523e9e64419710

في هذا المثال، سيتم فتح خريطة الويب ذات المعرف 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://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

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

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

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

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

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

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

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=https://services.myportal.domain.com:7443/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?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

تقبل معلمة 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://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

اعتبارًا من 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:.

في هذا المثال، تظهر الطبقتان الفرعيتان 1 و2 في طبقة قطع الأراضي في Map Viewer Classic في حين تكون الطبقات الفرعية الأخرى غير مرئية:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://otherportal.domain.com:7443/arcgis/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

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

للعثور على موقع أو معلم بمجرد فتح الخريطة، استخدم 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