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

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

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

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

https://www.arcgis.com/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

عرض هذا المثال في Map Viewer

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

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

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

يبدأ عنوانURL دائمًا بـ https://www.arcgis.com/apps/mapviewer/index.html? في Map Viewer وhttps://www.arcgis.com/home/webmap/viewer.html? في Map Viewer Classic ويتضمن واحدة أو أكثر من معلمات الاستعلام المدرجة أدناه. لتضمين أكثر من معطى، قم باستخدام علامة العطف (&) لفصل المعطيات عن بعضها. ستجد أمثلة على استخدام معلمات متعددة عبر هذه الصفحة.

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

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

عرض هذا المثال في Map Viewer

ملاحظة:‏

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

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

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

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

basemapUrl=https://services.arcgisonline.com/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%2Fmaps.ngdc.noaa.gov%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 مرمزة—على سبيل المثال، https://www.urlencoder.io/. من أجل سهولة القراءة، لا يتم ترميز بقية الأمثلة في هذا الموضوع. انقر فوق عرض هذا المثال في رابط Map Viewer بعد المثال لعرض عنوان URL المرمز في مستعرض ويب.

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

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

في هذا المثال، سيتم فتح خريطة الويب التي تحتوي على معرف 75a3ce8990674a5ebd5b9ab66bdab893 في Map Viewer:

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

عرض هذا المثال في Map Viewer

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

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

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

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

في هذا المثال، يفتح Map Viewer مع OpenStreetMap المستخدمة في صورة خريطة الأساس:

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

عرض هذا المثال في Map Viewer

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

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

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

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

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

https://www.arcgis.com/apps/mapviewer/index.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

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

https://myportal.domain.com/apps/mapviewer/index.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

عرض هذا المثال في Map Viewer

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

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

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

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

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

عرض هذا المثال في Map Viewer

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

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

https://www.arcgis.com/apps/mapviewer/index.html?layers=025063719c32408dbd4fb608faa28d2a&layerIds=0,2

عرض هذا المثال في Map Viewer

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

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

https://www.arcgis.com/apps/mapviewer/index.html?url=https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/USGS_Seismic_Data_v1/FeatureServer

عرض هذا المثال في Map Viewer

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

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

https://www.arcgis.com/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

عرض هذا المثال في Map Viewer

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

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

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

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

ملاحظة:‏

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

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

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

عرض هذا المثال في Map Viewer

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

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

عرض هذا المثال في Map Viewer

تعريف المدى

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

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

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

عرض هذا المثال في Map Viewer

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

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

عرض هذا المثال في Map Viewer

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

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

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

ملاحظة:‏

يبدأ ترقيم الطبقة الفرعية بصفر (0) كما هو موضح في نقطة نهاية REST.

https://www.arcgis.com/apps/mapviewer/index.html?url=https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/BLS_Monthly_Unemployment_Current_14_Months/FeatureServer?layers=show:2&find=Pennsylvania

عرض هذا المثال في Map Viewer

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

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

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

https://www.arcgis.com/apps/mapviewer/index.html?find=380 new york st,redlands,ca

عرض هذا المثال في Map Viewer

تلميح:

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

إضافة نُقطة

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

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

مثال

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

https://www.arcgis.com/apps/mapviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon

عرض هذا المثال في Map Viewer

اعتبارات

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

• في 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 Classic، استخدم mapOnly=true.

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

https://www.arcgis.com/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710&mapOnly=true

عرض هذا المثال في Map Viewer Classic