النقاط الجغرافية

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

ضع في الاعتبار ما يلي عند استخدام النقاط الجغرافية:

• يمكنك إضافة عدة أسئلة بشأن نقطة جغرافية أو تتبع جغرافي أو شكل جغرافي إلى أحد الاستطلاعات، ومع ذلك، يمكنك استخدام واحد منها فقط باعتباره الشكل الهندسي لسجل الاستطلاع. يمكنك استخدام أسئلة خريطة متعددة إذا تم ضبط bind::esri:fieldType لجميع الأسئلة، باستثناء سؤال واحد على null.
• يمكن أن يحتوي كل تكرار في الاستطلاع أيضًا على أكثر من سؤال واحد لنقطة جغرافية أو تتبع جغرافي أو شكل جغرافي، ومع ذلك، يمكنك استخدام واحدًا منها فقط باعتباره الشكل الهندسي لسجل التكرار. يمكنك استخدام أسئلة الخريطة المتعددة بالطريقة نفسها الموضحة أعلاه.
• وافتراضيًا، يعرض Survey123 قيم خطوط الطول والعرض WGS84، بتنسيق درجات/دقائق/ثواني. لتغيير هذا العرض الخاص بالاستطلاع، حدد علامة تبويب الخريطة واختر قيمة مختلفة للتنسيق الإحداثي.
• يستخدم سؤال النقطة الجغرافية خريطة أساس عبر الإنترنت افتراضيًا. إذا استخدم الاستطلاع دون اتصال بالإنترنت، راجع استخدام خرائط الأساس دون اتصال.
• يمكن عرض مواقع النقاط من أول سؤال نقطة جغرافية في تكرار على أي خريطة في استطلاعك. لمزيد من المعلومات، راجع تراكبات النقاط على الخرائط.
• إذا لم تقم بتضمين أي أسئلة نقطة جغرافية أو تتبع جغرافي أو شكل جغرافي، فإن طبقة المعلم الرئيسي لاستطلاعك ستحتوي على نوع الشكل الهندسي لـ esriGeometryPoint. ستتم تعبئة موقع النقطة بمعلومات الموقع المتاحة من الجهاز في وقت فتح الاستطلاع. ينطبق هذا السلوك حتى إذا كان الاستطلاع يحتوي على تكرارات تضم أسئلة خريطة، لكنه لا يتضمن سؤال خريطة خارج التكرارات.
• من خلال تعيين عمود مظهر سؤال النقطة الجغرافية على press-to-locate، Survey123 سوف يلتقط نقطة فقط عندما يتفاعل المستخدم مع السؤال.
• عند جمع الاستجابات باستخدام خريطة، لا يتم دعم جميع ميزات تطبيق Survey123 الميداني في تطبيق الويب. يتم دعم الميزات التالية في تطبيق Survey123 الميداني ولكن ليس في تطبيق الويب:
  • خرائط الأساس غير المتصلة.
  • متوسط الموقع لأسئلة النقطة الجغرافية.
  • رموز النقاط الجغرافية.‎
  • حدود دقة الموقع وتعبيرات جودة الموقع.
  • جميع خصائص pulldata("@geopoint"). يدعم تطبيق الويب خصائص x وy وz وhorizontalAccuracy وverticalAccuracy وspeed وdirection فقط.

حد دقة الموقع

لا يفحص Survey123 الدقة بشكل افتراضي في قيم الموضع التي يجمعها. إذا كانت دقة الموضع ضرورية لنتائج الاستطلاع، يمكنك تعريف حد الدقة بتعيين معدل الموقع. ويمكن تنفيذ ذلك بإدخال قيمة رقمية في عمود body::accuracyThreshold في سؤال النقطة الجغرافية، وستكون هذه القيمة حد الدقة التي لم يعد يتم التقاط البيانات بعدها عند تعيين معدل الموقع.

في حالة عدم تعيين المعدل، تعرض لوحة الخريطة في التطبيق الميداني Survey123 تحذيرًا إذا كانت دقة الموضع أكبر من الحد المُعرّف، ولكنها لا تمنع المستخدم من التقاط المواقع. لالتقاط موقع يلبي الحد، انتظر حتى يختفي التحذير، وحدد زر الموقع. لا يتم تجاهل المواضع التي لا تلبي حد الدقة إلا عند تعيين المعدل.

تعبيرات جودة الموقع

حد دقة الموقع هي رقم مفرد، وهي أدنى قيمة للدقة الأفقية لموقع معين. لتحذير مستخدم من أن الموقع لا يلبي متطلبات الجودة الأخرى الأكثر تعقيدًا، أو يقيدها من إرسال ذلك الموقع، فيمكن استخدام أحد التعبيرات. هذه هي الأعمدة (مع أعمدة الرسالة المقترنة بها) حيث يمكنك إدخال هذه التعبيرات:

• يمكن استخدام عمودي القيد وconstraint_message لمنع المستخدم من التقاط موقع في سؤال النقطة الجغرافية عندما لا يتم استيفاء تعبير جودة الموقع.
• يمكن استخدام عمودي bind::esri:warning وbind::esri:warning_message لعرض تحذير للمستخدم إذا لم يتم استيفاء تعبير جودة الموقع. إذا لم يتم استيفاء تعبير جودة الموقع، فسيتحول الشريط الذي يحتوي على القيمة الإحداثية أعلى سؤال النقطة الجغرافية إلى اللون الأصفر. في هذه الحالة، ما زال بإمكان المستخدم التقاط الموقع.

يمكن إنشاء تعبير إما في أي هذه الأعمدة باستخدام أي أسئلة من الاستطلاع، ولكن عادةً ما يتم استخدام الأسئلة أو المعلمات المتعلقة بموقع الاستطلاع.

لمعرفة معلمات الموقع التي يمكن استخدامها، راجع قسم استخراج قيم النقطة الجغرافية أدناه.

وكمثال على ذلك، يمكن استخدام التعبيرالتالي للتأكد من أن المستخدم قد وصل إلى شبه الجمود قبل التقاط الموقع، وتكون الدقة الأفقية أفضل من 5 أمتار:

pulldata("@geopoint", ., "horizontalAccuracy") < 5 and pulldata("@geopoint", ., "speed") < 0.1

تلميح:

في حين قد ترغب في أن يلتقط المستخدم نقطة وهو ما زال قائمًا، إلا أنه من النادر جدًا أن يبلغ جهاز قيمة سرعة الصفر. ولهذا السبب، يبحث المثال أعلاه عن سرعة أقل من 0.1 لتقديم هامش مقبول من الخطأ.

إذا كان يجب التقاط الموقع وفقًا للشروط الموضحة حسب التعبير، فأدخل التعبير في عمود القيد. وإذا كان مجرد توصية، فإن إدخال التعبير في عمود bind::esri:warning سيعرض رسالة التحذير المصاحبة للمستخدم فقط. ما زال بإمكان المستخدم التقاط الموقع في سؤال النقطة الجغرافية.

يتم عرض رسائل القيد و bind::esri:warning إذا تم تقييم التعبير في هذه الأعمدة على أنه خطأ.

بالنسبة للتعبيرات الكبيرة أو المعقدة جدًا، يوصى بفصل دوال pulldata("@geopoint") إلى أسئلة فردية والإشارة إلى أسماء الأسئلة هذه في التعبير. على سبيل المثال، لتنفيذ نفس الدالة كالمثال أعلاه، يمكنك استخدام طريقة الحساب التالية في السؤال المسمىhAccuracy:

pulldata("@geopoint", ${location}, "horizontalAccuracy")

ثم يمكنك استخدام طريقة الحساب التالية في السؤال المسمى currentSpeed:

pulldata("@geopoint", ${location}, "speed")

ويمكن استخدام الحساب التالي كقيد أو تعبير تحذيري لسؤال النقطة الجغرافية:

(${hAaccuracy} < 5) and (${currentSpeed} < 0.1)

تقرير فترة الثقة بنسبة 95%

قد تطلب مؤسستك الإبلاغ عن البيانات التي تم جمعها في فترة ثقة محددة (CI). افتراضيًا، عندما يكون نوع الدقة الذي تم إرجاعه هو جذر القيمة التربيعية الوسطى (RMS)، يكون فاصل الثقة هو 68 بالمئة. للإبلاغ عن دقة CI التي تصل إلى 95% في الاستطلاع، تحتاج إلى مضاعفة الدقة الأفقية بمقدار 1.7308 والدقة الرأسية بمقدار 1.9600. لمزيد من المعلومات حول عوامل التحويل هذه، راجع المعيار الوطني لدقة البيانات المكانية.

مثال الدقة العالية

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

يحدد منشيء الاستطلاع متطلبات الدقة الدنيا المطلقة التالية:

• الدقة الأفقية بـ 95% في فترة الثقة أقل من مترين.
• الدقة الرأسية بـ 95% في فترة الثقة أقل من مترين.
• التخفيف الموضعي للدقة (PDOP) أقل من أو يساوي 6.0.
• يتم استخدام خمسة أقمار صناعية أو أكثر.

يحدد منشئ الاستطلاع متطلبات الدقة المثالية التالية:

• الدقة الأفقية بـ 95% في فترة الثقة أقل من متر واحد.
• الدقة الرأسية بـ 95% في فترة الثقة أقل من متر واحد.
• PDOP يكون أقل من أو يساوي 2.0
• يتم استخدام سبعة أقمار صناعية أو أكثر.

يتم استخدام الحساب التالي في السؤال التاليhaccuracy68cep:

pulldata("@geopoint", ${location}, "horizontalAccuracy")

يتم استخدام الحساب التالي في السؤال التالي haccuracy95ci:

${haccuracy68cep} * 1.7308

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

${accuracyType} = 0 and ${haccuracy95ci} < 2 and ${vaccuracy95ci} < 2 and ${pdop} <= 6 and ${satellitesInUse} >= 5

سيتم إدخال التعبير التالي في العمود bind::esri:warning لتمثيل الدقة المفضلة. عادةً ما تكون القيم المستخدمة هنا أصغر من تلك المستخدمة للحد الأدنى من الدقة المطلقة. يفضل استخدام القيم الأصغر، لكن يمكن استخدام الحد الأدنى من القيم الأكبر.

${accuracyType} = 0 and ${haccuracy95ci} < 1 and ${vaccuracy95ci} < 1 and ${pdop} <= 2 and ${satellitesInUse} >= 7

طبقات المعالم ثلاثية الأبعاد

لا تدعم أسئلة النقطة الجغرافية في Survey123 افتراضيًا قيم محور z (دائرة العرض)، وتعمل فقط على التقاط دائرة العرض وخط الطول في طبقة معالم ثنائية الأبعاد. يمكنك تغيير ذلك بإدخال esriFieldTypePointZ في حقل bind::esri:fieldType في السؤال، وهو ما يعمل على تمكين التقاط قيمة الارتفاع إلى الطبقة المعالم. وهو ما يتيح أيضًا تبديل حقل دائرة العرض عند تحديد قيمة نقطة جغرافية.

افتراضيات

يمكن تعيين موقع افتراضي لسؤال نقطة جغرافية عن طريق توفير مجموعة مفصولة بمسافة من قيم دوائر العرض وخطوط الطول (بالدرجات العشرية) في العمود الافتراضي. على سبيل المثال، -37.814552 144.966071 سيؤدي بسؤال النقطة الجغرافية إلى الوضع الافتراضي إلى موقع في ملبورن، أستراليا.

تلميح:

تؤدي الإعدادات الافتراضية للموقع في نصف الكرة الأرضية الجنوبي إلى حدوث خطأ في Microsoft Excel، حيث يتم قراءة القيمة كصيغة لأنها تبدأ بعلامة الطرح (-). في هذه الحالات، أدخِل فاصلة عليا قبل القيمة الأولى، وسيقرأها على النحو المقصود في Excel. لا تؤدي إضافة فاصلات عُليا إلى أي تغييرات في السلوك في Survey123.

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

أسئلة النقاط الجغرافية "Geopoint" التي تم تغييرها من غير ذات الصلة إلى ذات الصلة لن يتم تحديثها إلى موقع الجهاز تلقائيًا. عندما يصبح السؤال ذا صلة، اضبط القيمة الافتراضية على الموضع لتحصل تلقائيًا على الموقع الحالي للجهاز.

لن يتم تحديث أسئلة النقطة الجغرافية المضمنة في الاستطلاعات التي تم إطلاقها من صندوق الوارد أو المسودات أو صندوق الصادر تلقائيًا إلى الموقع الحالي للجهاز. قم بتعيين القيمة الافتراضية على الموضع لتحصل تلقائيًا على الموقع الحالي الذي يحدده الجهاز عند فتح الاستطلاع من مجلد.

حسابات

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

نظرًا لأنه لا يمكنك القيام ذلك مباشرةً عند التعبئة من أسئلة select_one، يوصى باستخدام دالة substr() للمساعدة في إنشاء إجابة صحيحة. على سبيل المثال، يمكن أن يكون اسم النقطة الجغرافية كما يلي:

+059.38330_+018.00000

تستخدم هذه القيمة كمية ثابتة من الأحرف لكل من خط الطول ودائرة العرض، بما في ذلك الأصفار التي سيتم اقتطاعها كالمعتاد بتسطير سفلي بين القيمتين؛ نظرًا لعدم السماح بالمسافات في عمود الاسم. وهو ما يعمل على إنشاء قيمة يمكن إلغاء إنشاؤها بدالة substr() لتعبئة المثال التالي لسؤال النقطة الجغرافية:

concat(substr(${LocationValue}, 0, 10), " ", substr(${LocationValue}, -10))

يأخذ هذا المثال الأحرف العشرة الأولى للقيمة (دائرة العرض) الأحرف العشرة الأخيرة (قيمة خط الطول) ويمثلها مفصولةً بمسافة لإنتاج نقطة جغرافية صالحة.

يمكنك أيضًا استخدام دالة pulldata() لتعبئة سؤال النقطة الجغرافية باستخدام ملف csv مرفق. قم أولاً بإضافة ملف .csv إلى مجلد وسائط الاستطلاع. ثم أضف شيئًا مشابهًا لما يلي إلى عمود الحساب:

pulldata('Intersections', 'Lat', 'IntersectionID', ${intersection}) + " " + pulldata('Intersections', 'Long', 'IntersectionID', ${intersection})

كما في المثال substr()، يجمع ذلك بين قيم خط طول ودائرة العرض الموقع بمسافة لإنشاء إجابة صحيحة لسؤال النقطة الجغرافية بناءً على سؤال سابق.

راجع الأمثلة على هاتين العمليتين الحسابيتين في النماذج الموجودة في Survey123 Connect

مطلوب وللقراءة فقط

تُعبئ أسئلة النقطة الجغرافية الاستطلاع تلقائيًا بموقع يوفره الجهاز إن توفّر. إذا كان الجهاز لا يوفر موقعًا صالحًا في استجابة الاستطلاع، Survey123 يقوم بإرجاع موقع 0,0، الذي يقع في امتداد محيط خارج الساحل الأفريقي. عندما يتم وضع علامة على سؤال النقطة الجغرافية باعتباره إلزاميًا، لا يتم إرسال الاستطلاع بهذه القيمة الفارغة، ويتم قبول الاستطلاع بعد أن يقدم الجهاز موقعًا أو يتم إدخال الموقع يدويًا.

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

البحث الجغرافي والكود الجغرافي

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

وبحسب الوضع الافتراضي، تقوم وظيفة البحث الجغرافي بإرجاع نتائج من جميع أنحاء العالم، باستخدام ArcGIS World Geocoding Service للبحث عن العناوين.

بشكل افتراضي، يقوم البحث الجغرافي بإرجاع النتائج من العالم بأكمله، وذلك باستخدام ArcGIS World Geocoding Service للبحث عن العناوين. سيشاهد المستخدمون الذين قاموا بتسجيل الدخول أيضًا جميع خدمات الترميز الجغرافي التي تم تكوينها في المؤسسات.

ملاحظة:‏

الترميز الجغرافي باستخدام ArcGIS World Geocoding Service سوف يستهلك الاعتمادات. لمزيد من المعلومات، راجع فهم الاعتمادات.

لتعيين محدد موقع معين لإرجاع النتائج منه، قم بتوفير معرف عنصر محدد الموقع في عمود bind::esri:parameters، على سبيل المثال، geocode=36ff9e8c13e042a58cfce4ad87f55d19. يجب أن يكون محدد الموقع المُستخدم في استطلاع ArcGIS Online عنصرًا في ArcGIS Online. يجب أن يكون محدد الموقع المُستخدم في استطلاع ArcGIS Enterprise عنصرًا في نفس البوابة الإلكترونية للاستطلاع.

يمكنك أيضًا تعيين سؤال لإجراء تكويد جغرافي فقط عن طريق إضافة سؤال نصي بمظهر التكويد الجغرافي. لمزيد من المعلومات، راجع مظهر التكويد الجغرافي.

تكويد جغرافي معكوس

يمكن تنفيذ التكويد الجغرافي العكسي في التطبيق الميداني بالضغط مع الاستمرار على الخريطة أو الإحداثيات عند فتح عرض النقطة الجغرافية الكامل، ولكن لن يتم حفظ ذلك وسيتم إرساله إلى الاستطلاع. يمكن الحصول على القيمة المكود جغرافيًا عكسيًا من النقطة الجغرافية باستخدام pulldata("@geopoint", ${location}, "reversegeocode")، الذي يقوم بإرجاع الموقع ككائن JSON. يمكن استخراج الخصائص الفردية من الكائن بتوفير اسم الخاصية، ولكن تختلف هذه الخصائص بحسب محدد المواقع المستخدم. في حالة ArcGIS World Geocoding Service، يتم إرجاع كائن JSON مشابه لما يلي:

{
	"address": {
		"Match_addr": "207-361 Flinders St, Melbourne, Victoria, 3000",
		"LongLabel": "207-361 Flinders St, Melbourne, Victoria, 3000, AUS",
		"ShortLabel": "207-361 Flinders St",
		"Addr_type": "StreetAddress",
		"Type": "",
		"PlaceName": "",
		"AddNum": "283",
		"Address": "283 Flinders St",
		"Block": "",
		"Sector": "",
		"Neighborhood": "Melbourne",
		"District": "Melbourne",
		"City": "Melbourne",
		"MetroArea": "",
		"Subregion": "",
		"Region": "Victoria",
		"RegionAbbr": "VIC",
		"Territory": "",
		"Postal": "3000",
		"PostalExt": "",
		"CntryName": "Australia",
		"CountryCode": "AUS"
	},
	"location": {
		"x": 144.96721048751365,
		"y": -37.81768543612741,
		"spatialReference": {
			"wkid": 4326,
			"latestWkid": 4326
		}
	}
}

لاستخراج قيمة محددة فقط من كائن JSON استخدم دالة pulldata("@geopoint") المشابهة لما يلي، والتي من شأنها استخراج خاصية Match_addr:

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")

يتم استخدام خدمة التكويد الجغرافي الافتراضية لمؤسستك عند عكس الترميز الجغرافي. لاستخدام خدمة تكويد جغرافي مختلفة، أدخِل عنوان URL لمحدد المواقع كمعلمة خيار في الدالة بتنسيق pulldata("@geopoint", ${location}, "reversegeocode", ${locatorURL}). إذا كانت الخدمة مؤمّنة، أو الاستطلاع لا يستهدف المستخدمين العموميين، فيجب تكوين عنصر وكيل باستخدام بيانات اعتماد الوصول المحفوظة فيه.

إذا تم توفير محدد مواقع عنوان URL، فيمكن توفير معلمات إضافية سيتم تمريرها إلى عنوان URL. وكما هو الشأن مع الخصائص المتوفرة داخل كائن JSON، تختلف هذه المعلمات استنادا إلى خدمة التكويد الجغرافي المستخدمة. يستخدم المثال التالي featureTypes معلمة، مما يحد من القيمة التي يتم إرجاعها إلى نوع معين من المواقع لإرجاع أقرب عمل أو معلم:

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr", "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer", "featureTypes=POI")

تلميح:

إذا كانت خدمة التكويد الجغرافي الافتراضي لعملية نشر ArcGIS Enterprise هي ArcGIS World Geocoding Service، أو إذا كان ArcGIS World Geocoding Service مستخدمًا كمعلمة عنوان URL لمحدد المواقع في استطلاع مؤسسة كما ورد في الخطوات السابقة، فسيظهر لك خطأ رمز مميز عند إجراء تكويد جغرافي عكسي. لتجنب ذلك، أنشئ عنصر وكيل لديه بيانات اعتماد وصول ArcGIS Online محفوظة به لمستخدم لديه أذونات إجراء الترميز الجغرافي. يمكن بعد ذلك تعيين هذا العنصر سواء كخدمة تكويد جغرافي افتراضي لبوابة أو وجهة لمعلمة عنوان URL محدد موقع في دالة عكس الكود الجغرافي.

للحصول علي مزيد من المعلومات حول معلمات عنوان URL لعكس الكود الجغرافي، بما في ذلك قائمة كاملة بالمعلمات التي يمكن تمريرها إلى عنوان URL، راجع reverseGeocode في وئائق ArcGIS REST API.

يمكنك تضمين عمليات حسابية متعددة للترميز العكسي دون التأثير على الأداء أو الاعتمادات. على سبيل المثال، يمكن تضمين كافة المكالمات الثلاث التالية للخصائص الفردية:

pulldata("@geopoint", ${location}, "reversegeocode.address.Match_addr")

pulldata("@geopoint", ${location}, "reversegeocode.address.LongLabel")

pulldata("@geopoint", ${location}, "reversegeocode.address.ShortLabel")

يتم اجراء التكويد الجغرافي العكسي للحساب الأول، والذي من شأنه أن يستهلك الاعتمادات. وبعد ذلك، يتم تخزين الاستجابة مؤقتًا واستخدامها للحسابين الآخرين. يلزم إجراء اتصال جديد بالخدمة الجغرافية فقط إذا تم تغيير عنوان URL لطلب الترميز الجغرافي العكسي بسبب تغيير في الموقع أو معلمة طلب مختلفة قيد الاستخدام أو تنتهي صلاحية الرمز المميز للوصول الأصلي.

تكوين عنصر محدد موقع الوكيل

لتكوين عنصر محدد موقع الوكيل، اتبع الخطوات التالية:

1. سجل الدخول إلى مؤسسة ArcGIS باستخدام حساب له امتيازات الترميز الجغرافي.
2. من على صفحة المحتوى استعرض إلى إضافة عنصر > من عنوان URL الخاص بـ ArcGIS Online أو إضافة عنصر > من الويب الخاص بـ ArcGIS Enterprise، وتأكد من أن النوع المحدد هو خدمة ArcGIS Server على الويب.
3. استخدم عنوان URL لمحدد المواقع المقصود، على سبيل المثال، https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer لـ ArcGIS World Geocoding Service.

   سيتم الكشف عن ذلك كخدمة آمنة.

4. أضف اسم مستخدم وكلمة مرور لحساب ArcGIS لديه امتيازات ترميز جغرافي.
5. اختر تخزين بيانات الاعتماد مع عنصر الخدمة. لا تطالب بالتخويل.
6. أدخل عنوانًا وعلامات.
7. انقر على إضافة عنصر.
8. شارك عنصر محدد المواقع هذا عبر الإنترنت مع الجميع.

لمزيد من المعلومات، راجع متطلبات تكوين محددات الموقع لديك لـ ArcGIS Online أو تكوين خدمات الأداة المساعدة في البوابة الإلكترونية لـ ArcGIS Enterprise.

استخراج قيم النقطة الجغرافية

لإلغاء إنشاء إجابة النقطة الجغرافية، يمكنك استخدام دالة pulldata("@geopoint") لاستخراج القيم لتعبئة قيم أسئلة أخرى. يستخرج المثال التالي قيمة الدقة الأفقية من سؤال النقطة الجغرافية:

pulldata("@geopoint", ${location}, "horizontalAccuracy")

إن توافر خصائص النقطة الجغرافية تابع للجهاز. يدرج الجدول التالي الخصائص التي يمكن سحبها من نقطة جغرافية.

اسم الخاصية	الوصف	وحدة
x	خط الطول، قيمة موجبة في نصف الكرة الشرقي، وقيمة سالبة في نصف الكرة الغربي.	الدرجات العشرية
y	دائرة العرض، قيمة موجبة في نصف الكرة الشمالي، وقيمة سالبة في نصف الكرة الجنوبي.	الدرجات العشرية
z	دائرة العرض، أمتار فوق مستوى سطح البحر (افتراضي) أو الارتفاع فوق السطح الناقص (إذا تم تحديده في إعدادات التطبيق الميداني).	أمتار
horizontalAccuracy	الدقة الأفقية لإحداثيات x وy.	أمتار
verticalAccuracy	الدقة الرأسية لإحداثي z.	أمتار
السرعة	سرعة الطيران بالنسبة إلى الأرض.	متر في الثانية
verticalSpeed	السرعة الرأسية.	متر في الثانية
الاتجاه	اتجاه السفر بقياسه في اتجاه عقارب الساعة من الشمال.	الدرجات العشرية
positionSourceType	فئة مصدر الموضع. النتائج المحتملة هي Unknown (0)، User (1)، System Location (2)، External Device (3)، وNetwork Device (4) وFile (5).	غير متوفر
positionSourceInfo.antennaHeight	ارتفاع هوائي الجهاز. يتم طرح المسافة من الهوائي إلى سطح الأرض من قيم الارتفاع.	أمتار
positionSourceInfo.altitudeType	نوع الارتفاع المحدد. النتائج المحتملة هي الارتفاع فوق سطح البحر (0) والارتفاع فوق المجسم الإهليلجي (1). هذا متاح لجميع انواع مقدمي المواقع.	غير متوفر

يدرج الجدول التالي إضافي الخصائص الإضافية التي يمكن سحبها من نقطة جغرافية ملتقطة باستخدام جهاز مستقبل عالي الدقة:

اسم الخاصية	الوصف	وحدة
magneticVariation	الزاوية بين الشمال الحقيقي والشمال المغناطيسي.	الدرجات العشرية
fixType	نوع إصلاح الموضع الذي يتضمنه الإحداثي. النتائج المحتملة هي NoFix (0)، GPS (1)، DifferentialGPS (2)، PrecisePositioningService (3)، RTKFixed (4)، RTKFloat (5)، Estimated (6)، Manual (7)، Simulator (8)، وSBAS (9).	غير متوفر
positionSourceInfo	معلومات الجهاز ككائن JSON. وهي مفيدة لإصلاح الأخطاء والتحقق من الدقة. يمكن أيضًا إعادة العناصر الفردية باستخدام اسم العنصر الكامل. راجع صفوف الجدول التالي للاطلاع على جميع العناصر المتاحة.	غير متوفر
positionSourceInfo.pluginName	اسم مصدر الموضع الداخلي. وهذا متاح فقط لمقدم الموقع المتكامل للجهاز.	غير متوفر
positionSourceInfo.deviceAddress	عنوان الجهاز. وهذا متاح فقط لمستقبلات GNSS الخارجية.	غير متوفر
positionSourceInfo.deviceName	اسم الجهاز. وهذا متاح فقط لمستقبلات GNSS الخارجية.	غير متوفر
positionSourceInfo.deviceType	نوع الجهاز الخارجي. النتائج المحتملة هي غير معروف (-1) وBluetooth (0) ومنفذ تسلسلي (1)، وBluetooth LE (2). وهذا متاح فقط لمستقبلات GNSS الخارجية.	غير متوفر
positionSourceInfo.networkName	اسم مصدر موضع الشبكة. وهذا متاح فقط لمقدمي مواقع الشبكة.	غير متوفر
positionSourceInfo.networkAddress	عنوان مصدر موضع الشبكة. وهذا متاح فقط لمقدمي مواقع الشبكة.	غير متوفر
positionSourceInfo.networkPort	منفذ مصدر موضع الشبكة. وهذا متاح فقط لمقدمي مواقع الشبكة.	غير متوفر
positionSourceInfo.geoidSeparationCustom	الفرق بين السطح الإهليلجي الأرضي WGS-84 ومستوى سطح البحر كما يحدده المستخدم في إعدادات التطبيق.	أمتار
geoidSeparation	الفرق بين الإهليلجي الأرضي WGS-84 ومتوسط مستوى سطح البحر حسبما أفاد جهاز مستقبل GNSS. وأحيانًا يُشار إلى هذا أيضًا كارتفاع أرثومتري.	أمتار
accuracyType	نوع الدقة المبلغ عنها من قبل خصائص horizontalAccuracy وverticalAccuracy. النتائج المحتملة هي RMS (0) وDOP (1). RMS يُقصد بها جذر متوسط المربع. ويتم حساب ذلك على أساس 68% من فاصل الثقة لخط العرض وخط الطول وتقارير الخطأ في الارتفاع بعبارة GST المقدّمة من قِبل المستلم. إذا لم يكن جهاز الاستقبال يدعم GST، فسيتم استخدام DOP بدلاً من ذلك. DOP هو التقليل من الدقة القائمة الدقة المتناهية. يستخدم هذا القيمة الثابتة لخطأ النطاق الذي يقدره المستخدم (UERE) لتقدير الدقة الأفقية والرأسية.	غير متوفر
positionAccuracy	حدث خطأ كروي إشعاعي متوسط. يشمل كلا من الخطأ الأفقي والرأسي.	أمتار
latitudeError	خطأ سيجما-1 لقيمة دائرة العرض. يتم ملء هذه الخاصية عندما يدعم جهاز تحديد الموقع عبارات GST في تدفقات NMEA.	أمتار
longitudeError	خطأ سيجما-1 لقيمة خط الطول. يتم ملء هذه الخاصية عندما يدعم جهاز تحديد الموقع عبارات GST في تدفقات NMEA.	أمتار
altitudeError	خطأ سيجما-1 لقيمة الارتفاع. يتم ملء هذه الخاصية عندما يدعم جهاز تحديد الموقع عبارات GST في تدفقات NMEA.	أمتار
hdop	التخفيف الأفقي لدقة بيانات الموضع (HDOP).	غير متوفر
vdop	التخفيف الرأسي لدقة بيانات الموضع (VDOP).	غير متوفر
pdop	تخفيف دقة الموضع لبيانات الموضع (PDOP) المعادلة المستخدمة لتحديد PDOP هي PDOP^2 = HDOP^2 + VDOP^2.	غير متوفر
differentialAge	عمر الإشارة التفاضلية والتصحيح الذي يستخدمه جهاز استقبال GPS لتصحيح الموقف تفاضليًا.	ثواني
referenceStationId	معرّف المحطة المرجعية التفاضلية (DSID) للمحطة المستخدمة بواسطة مستقبل GPS.	غير متوفر
satellitesVisible	عدد الأقمار الصناعية لتحديد المواقع المرئية في وقت التقاط الموقع.	غير متوفر
satellitesInUse	عدد الأقمار الصناعية لتحديد المواقع المستخدمة لإرجاع بيانات الموضع.	غير متوفر

تنسيق الإحداثيات

يمكن أيضًا استخدام دالة pulldata("@geopoint") لاستخراج قيم النقطة الجغرافية وتنسيقها ضمن تنسيقات إحداثية إضافية:

• يقوم pulldata("@geopoint", ${location}, "DMS") بإرجاع النقطة الجغرافية كدرجات ودقائق وثوان. يتم إرجاع ذلك على أنها كائن JSON:
  {
  	"latitudeDegrees": 39,
  	"latitudeHemisphere": "N",
  	"latitudeMinutes": 57,
  	"latitudeSeconds": 36.3,
  	"latitudeText": "39°57'36.3\"N",
  	"longitudeDegrees": 116,
  	"longitudeHemisphere": "E",
  	"longitudeMinutes": 27,
  	"longitudeSeconds": 4,
  	"longitudeText": "116°27'04.0\"E",
  	"text": "39°57'36\"N 116°27'4\"E"
  }

  يمكن استخراج هذه القيم الفردية باستخدام معلمات إضافية. على سبيل المثال، يقوم pulldata("@geopoint", ${location}, "DMS.latitudeMinutes") بإرجاع دقائق دائرة العرض فقط.
• يقوم pulldata("@geopoint", ${location}, "DDM") بإرجاع النقطة الجغرافية كدرجات ودقائق عشرية، ويقوم pulldata("@geopoint", ${location}, "DD") بإرجاع النقطة الجغرافية كدرجات عشرية. يتم أيضًا إرجاعها على أنها كائنات JSON، وقد يتوفر لديها قيم فردية مستخرجة بواسطة معلمات إضافية بنفس الطريقة كتنسيق الدرجات والدقائق والثوان أعلاه.

يمكن استخدام تنسيقات الإحداثيات التالية مع معلمة الدقة الاختيارية، مما ينتج عنه قيمة عشرية مرفوعة إلى القوة 10— على سبيل المثال، 0.01 أو 0.1 أو 1 أو 10 أو 100.

• يقوم pulldata("@geopoint", ${location}, "MGRS") بإرجاع النقطة الجغرافية على أنها قيمة شبكة (MGRS) بدقة 1 متر. من خلال توفير معلمة الدقة الاختيارية، يمكن تغيير الدقة. على سبيل المثال، يقوم pulldata("@geopoint", ${location}, "MGRS", 100) بإرجاع قيمة شبكة بدقة 100 متر.
• يقوم pulldata("@geopoint", ${location}, "USNG") بإرجاع النقطة الجغرافية على أنها قيمة شبكة (USNG) بدقة 1 متر.
• يقوم pulldata("@geopoint", ${location}, "UTM") بإرجاع النقطة الجغرافية في صورة إحداثيات ميركاتور الاجتياز العالمي (UTM) بدقة تبلغ 1 متر. يتم إرجاع ذلك على أنها كائن JSON:
  {
  	"band": "S",
  	"easting": 452994,
  	"northing": 4423429,
  	"text": "50S 452994E 4423429N",
  	"type": "UTM",
  	"zone": 50
  }

  يمكن استخراج هذه القيم الفردية باستخدام معلمات إضافية. على سبيل المثال، يقوم pulldata("@geopoint", ${location}, "UTM.easting", 0.01) بإرجاع قيمة الاتجاه الشرقي التي تبلغ دقتها 1 سم.

رموز النقاط الجغرافية

يمكن لسؤال نقطة جغرافية أن يعرض رمزًا مخصصًا لعلامة النقطة على الخريطة باستخدام معلمة symbol في العمود body::esri:style بالاستطلاع. يجب أن تقدم المعلمة اسم ملف ذلك الرمز المخصص، والذي يجب أن يكون ملف .png في مجلد وسائط الاستطلاع. راجع الأمثلة التالية:

symbol=hydrant.png

تقبل معلمة symbol المعلمات الاختيارية لتكوين عرض الرمز على الخريطة. افصل هذه المعلمات عن اسم الملف بعلامة استفهام، وعن بعضها البعض بعلامة عطف (&). على سبيل المثال، يمكن أن تحتوي معلمة symbol على خصائص x وy وscale على النحو التالي:

symbol=hydrant.png?x=0.2&y=0.7&scale=2

• تحدد المعلمة x نقطة الإرساء الأفقية للرمز. وتقبل قيمة ما بين 0 (تمثل الحافة اليسرى للصورة) و1 (تمثل الحافة اليمنى). وفي حال عدم التحديد، فستكون القيمة الافتراضية هي 0.5.
• تحدد المعلمة y نقطة الإرساء الرأسية للرمز. وتقبل قيمة ما بين 0 (تمثل الحافة العلوية للصورة) و1 (تمثل الحافة السفلية). وفي حال عدم التحديد، فستكون القيمة الافتراضية هي 1.
• تحدد المعلمة scale القياس الذي تُعرض به الصورة. القيم الأقل من القياس 1 ستجعل الصورة لأسفل، بينما القيم الأعلى من القياس 1 ستجعل الصورة لأعلى.

يمكن أن تكون القيمة المقدمة إما ثابتة أو مرجعًا لسؤال، على سبيل المثال symbol=${symbol_question}. التعبيرات المضمنة غير مدعومة.

تراكبات النقاط على الخرائط

يمكن عرض مواقع النقاط من أول سؤال نقطة جغرافية ضمن تكرار على أي سؤال خريطة في استطلاعك عن طريق تعيين عمود body::esri:style الخاص بسؤال نقطة جغرافية أو تتبع جغرافي أو شكل جغرافي إلى overlay=repeat_name. تُعرض جميع النقاط التي تم التقاطها لأول سؤال نقطة جغرافية ضمن هذا التكرار على الخريطة. يمكن استخدام معلمات إضافية لتخصيص ترميز التراكب.

ترد فيما يلي المعلمات الاختيارية التي يدعمها نمط التراكب، ويمكن فصلها بعلامة العطف، على سبيل المثال، overlay=repeat_name&preview=true:

المعلمة	الوصف	مثال
عرض	إظهار نقاط التراكب على سؤال الخريطة. القيمة الافتراضية هي صواب.	view=false
معاينة	إظهار نقاط التراكب على خريطة المعاينة. القيمة الافتراضية هي خطأ.	preview=true
أيقونة	اسم رمز النقطة المراد استخدامه لدبابيس الخريطة. راجع الرموز المتوفرة في مكتبة رموز النقاط في وثائق ArcGIS Developer.	icon=esri_pin_two
iconColor	لون الرمز المستخدم في دبابيس الخريطة. تقبل هذه المعلمة اسم لون قياسي أو رمز لون سداسي. تُميز القيمة الافتراضية باللون الأسود.	iconColor=Blue
iconOutlineColor	لون المخطط التفصيلي المستخدم في دبابيس الخريطة. تقبل هذه المعلمة اسم لون قياسي أو رمز لون سداسي. تُميز القيمة الافتراضية باللون الأبيض.	iconOutlineColor=#FF4500
حجم الأيقونة	حجم الرمز كما يظهر على الخريطة. القيمة الافتراضية هي 30.	iconSize=40
تسمية	اسم سؤال الاستطلاع لاستخدامه كتسمية.	label=question_name
لون التسمية	لون التسمية نقطة ما. تقبل هذه المعلمة اسم لون قياسي أو رمز لون سداسي. تُميز القيمة الافتراضية باللون الأسود.	labelColor=#FFD700
لون المخطط التفصيلي للتسمية	لون المخطط التفصيلي للتسمية. تقبل هذه المعلمة اسم لون قياسي أو رمز لون سداسي. تُميز القيمة الافتراضية باللون الأبيض.	labelOutlineColor=Black
حجم الخط	حجم خط تسمية نقطة ما. القيمة الافتراضية هي 13.	fontSize=16

أسلوب السؤال

يمكنك تكوين خريطة الأساس وأدوات الخريطة وارتفاع السؤال لأسئلة الخريطة.

يمكن تعيين خريطة أساس افتراضية لأسئلة الخريطة الفردية باستخدام معلمة map في عمود body::esri:style. على سبيل المثال، ستقوم map="World Topography" بتعيين سؤال الخريطة لاستخدام خريطة أساس طبوغرافيا العالم. يمكنك أيضًا تعيين معلمة map باستخدام معرف عنصر الخريطة، على سبيل المثال، map=de26a3cf4cc9451298ea173c4b324736. تدعم هذه المعلمة الخرائط عبر الإنترنت وغير المتصلة، بما في ذلك خرائط الويب الخاصة بك. لمزيد من المعلومات، راجع تضمين خريطة في الاستطلاع.

يقبل العمود body::esri:style معلمة mapTools للتحكم في أدوات الخريطة المتوفرة لأسئلة الخريطة. إذا لم يتم تعيين معلمة أداة الخريطة، فسيتم عرض جميع الأدوات. القيم التالية مقبولة:

• mapTools=search
• mapTools=mapSwitcher
• mapTools=zoom
• mapTools=home
• mapTools=locate

يمكن تعيين أدوات متعددة عن طريق فصل كل قيمة بفاصلة، على سبيل المثال، mapTools=search,locate.

يقبل العمود body::esri:style معلمة height لأسئلة الخريطة.

يمكنك تعيين ارتفاع السؤال عن طريق تزويد معلمة height بعدد ما، ووحدة اختياريًا. الوحدة الافتراضية هي lines، في إشارة إلى ارتفاع خط نص الإدخال الحالي. على سبيل المثال، يسبب height=5 أي من هذه الأسئلة لتعرض خمسة أسطر بالطول.

يمكنك بدلاً من ذلك تعيين وحدة على نسبة مئوية من ارتفاع الشاشة أو حسب عدد البكسل، بإضافتها كلاحقة إلى قيمة دون مسافة. على سبيل المثال، يتم قبول جميع القيم التالية:

• height=5
• height=5lines
• height=25%
• height=250pixels

يمكن ضبط أدوات الارتفاع والخريطة بمسافة بينها، على سبيل المثال، height=25% mapTools=search,zoom.

ملاحظة:‏

التحكم في الارتفاع وأدوات الخريطة الخاصة بالأسئلة غير مدعوم في تطبيق الويب Survey123.