ملفات GPX في OsmAnd

مقدمة

GPX (GPS Exchange Format) هو معيار واسع الاستخدام قائم على XML لتخزين بيانات GPS، بما في ذلك المسارات والطرق ونقاط الطريق. يدعم OsmAnd تنسيق GPX لاستيراد وتصدير وتخصيص بيانات GPS للملاحة، مما يتيح للمستخدمين المبتدئين والمتقدمين على حد سواء تحسين تجربتهم.

ما الذي يجعل ملفات GPX في OsmAnd فريدة؟

يوسع OsmAnd تنسيق GPX 1.1 القياسي من خلال تقديم مساحة اسم XML المخصصة الخاصة به osmand:. تتيح مساحة الاسم هذه تخزين بيانات إضافية مثل:

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

ماذا ستتعلم في هذا الدليل؟

يقدم هذا المقال نظرة عامة شاملة على بنية ملف GPX وميزاته في OsmAnd. ستتعلم:

كيفية تخصيص المسارات ونقاط الطريق باستخدام علامات GPX.
الميزات المتقدمة مثل أوصاف HTML وبيانات المستشعر وأنواع الأنشطة.
كيفية تصدير المسارات المحسوبة والحفاظ على وظائفها الكاملة.
تحويل ملفات GPX إلى تنسيق OBF للتخزين الأمثل وقدرات البحث المتقدمة.

نظرة عامة على بنية GPX

تنظم ملفات GPX في OsmAnd البيانات هرميًا في العناصر التالية:

<gpx> - العنصر الجذر للملف.
<trk> - يمثل المسارات، والتي تحتوي على:
- <trkseg> - أجزاء المسار، والتي تنقسم كذلك إلى <trkpt> (نقاط المسار).
<rte> - يمثل الطرق، بما في ذلك نقاط الطريق والنقاط الرئيسية.
<wpt> - يمثل نقاط الطريق الفردية.

تخصيص المسار

معلمات مظهر المسار

يصف هذا القسم كيفية عرض OsmAnd للمسارات على الخريطة وخيارات التخصيص المتاحة لضبط مظهرها. يتم تطبيق المعلمات الموصوفة أدناه داخل علامة <gpx> وتؤثر على جميع المسارات المضمنة في ملف GPX.

اسم العلامة	الوصف / القيم
`<color>`	- يحدد لون خط المسار على الخريطة. - سلسلة نصية: رمز لون HEX `#RRGGBB` أو `#AARRGGBB`
`<width>`	- يحدد عرض خط المسار. - سلسلة نصية: `“thin”`، `“medium"`, `“bold”` (محددة بواسطة السمة `“currentTrackWidth”`)، أو عدد صحيح (1-24)
`<show_arrows>`	- تمكين أو تعطيل أسهم الاتجاه على طول المسار. - قيمة منطقية: `"true"` / `"false"`
`<show_start_finish>`	- إظهار أو إخفاء علامات بداية ونهاية المسار. - قيمة منطقية: `"true"` / `"false"`
`<split_type>`	- يحدد نوع تقسيم المسار. - سلسلة نصية: `"no_split"`، `"distance"`، `"time"`
`<split_interval>`	- يحدد الفاصل الزمني لتقسيم المسار بناءً على النوع المحدد. - عدد عشري: عدد صحيح (أمتار لـ `"distance"`، ثوانٍ لـ `"time"`)
`<line_3d_visualization_by_type>`	- يحدد نوع التصور ثلاثي الأبعاد للمسار. - سلسلة نصية: `"none"`، `"altitude"`، `"shared_string_speed"`، `"map_widget_ant_heart_rate"`، `"map_widget_ant_bicycle_cadence"`، `"map_widget_ant_bicycle_power"`، `"shared_string_temperature"`، `"shared_string_speed"`، `"fixed_height"`
`<line_3d_visualization_wall_color_type>`	- يحدد نوع لون الجدار للتصور ثلاثي الأبعاد. - سلسلة نصية: `"none"`، `"solid"`، `"downward_gradient"`، `"upward_gradient"`، `"altitude"`، `"slope"`، `"speed"`
`<line_3d_visualization_position_type>`	- يحدد موضع التصور ثلاثي الأبعاد بالنسبة للمسار. - سلسلة نصية: `"top"`، `"bottom"`، `"top_bottom"`
`<vertical_exaggeration_scale>`	- مضاعف لتوسيع قيمة السمة `line_3d_visualization_by_type`. - عدد عشري: الافتراضي: 1.0
`<elevation_meters>`	- يحدد ارتفاعًا ثابتًا بالأمتار لـ `"fixed_height"` في `<line_3d_visualization_by_type>`. - عدد عشري: الافتراضي: `1000`
`<coloring_type>`	- يحدد طريقة تلوين المسار. - سلسلة نصية: `"solid"`، `"speed"`، `"altitude"`، `"slope"`، `"routeInfo_roadClass`، `"routeInfo_surface"`، `"routeInfo_smoothness"`
`<color_palette>`	- يحدد نظام الألوان للمسار. - سلسلة نصية: `"default"` / أنظمة يحددها المستخدم

مثال:

<gpx version="1.1" creator="OsmAnd~ 5.0.0" xmlns="https://www.topografix.com/GPX/1/1" xmlns:osmand="https://osmand.net/docs/technical/osmand-file-formats/osmand-gpx" xmlns:gpxtpx="https://www8.garmin.com/xmlschemas/TrackPointExtensionv1.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://www.topografix.com/GPX/1/1 https://www.topografix.com/GPX/1/1/gpx.xsd">
...
  <extensions>
    <osmand:color>#4e4eff</osmand:color>
    <osmand:width>bold</osmand:width>
    <osmand:show_arrows>true</osmand:show_arrows>
    <osmand:split_type>distance</osmand:split_type>
    <osmand:split_interval>2000.0</osmand:split_interval>
  </extensions>
</gpx>

علامة 'coloring_type'

تسمح علامة <coloring_type> في OsmAnd للمستخدمين بتخصيص تلوين المسار بناءً على سمات بيانات محددة، مما يوفر طريقة مرئية لتفسير المعلومات الرئيسية على طول المسار.

النوع	الوصف	حالة الاستخدام
`<solid>`	يتم عرض المسار بأكمله بلون واحد ثابت محدد بواسطة علامة `color`.	يُستخدم عندما يكون هناك حاجة إلى لون موحد لرؤية واضحة.
`<speed>`	يتم تلوين المسار بتدرج بناءً على قيم السرعة عند كل نقطة مسار (`<trkpt>`). يتم تمثيل السرعات الأعلى بألوان مميزة.	مثالي للأنشطة مثل ركوب الدراجات أو القيادة لتصور التغيرات في السرعة.
`<altitude>`	يتم تلوين المسار وفقًا لبيانات الارتفاع عند كل `<trkpt>`. يتم تطبيق تدرج، يشير إلى نطاقات ارتفاع مختلفة.	مفيد للمشي لمسافات طويلة أو الطرق الجبلية لتسليط الضوء على تغيرات الارتفاع.
`<slope>`	يتم تلوين المسار بناءً على الميل/الانحدار بين نقاط المسار المتتالية. تشير التدرجات الإيجابية إلى المنحدرات الصعودية، بينما تشير التدرجات السلبية إلى المنحدرات الهابطة.	مناسب لراكبي الدراجات أو المتنزهين الذين يحللون صعوبة المسار.
`<routeInfo_roadClass>`	يلون أجزاء المسار بناءً على تصنيف طريق OpenStreetMap (OSM) (على سبيل المثال، طريق سريع، شارع سكني).	يساعد في التمييز بين أنواع الطرق المختلفة عند اتباع مسار.
`<routeInfo_surface>`	يلون أجزاء المسار بناءً على نوع سطح OSM (على سبيل المثال، ممهد، حصى، تراب).	مفيد لتحديد ظروف المسار أثناء أنشطة مثل القيادة على الطرق الوعرة.
`<routeInfo_smoothness>`	يلون المسار وفقًا لتقييمات نعومة OSM، مما يشير إلى خشونة أو نعومة المسار (على سبيل المثال، ممتاز، سيء).	مفيد لتقييم قابلية الملاحة للمسار لمركبات محددة.

علامات GPX في واجهة المستخدم

يتم عرض علامات امتدادات GPX في أسفل قائمة سياق المسار. يتم سرد كل من <metadata> و <gpx> <extensions>. يتم استبعاد علامات المظهر من القائمة. مدعوم منذ OsmAnd Android 5.0.

تخصيص نقاط الطريق

يشرح هذا القسم كيف يسمح OsmAnd بتخصيص نقاط الطريق في ملفات GPX باستخدام الأيقونات والألوان والتجميع.

أيقونات نقاط الطريق

تتحكم العلامات التالية في مظهر أيقونات نقاط الطريق في OsmAnd:

علامة GPX	الافتراضي	الغرض
`<icon>`	(لا شيء)	تحدد الأيقونة لنقطة الطريق (على سبيل المثال، `historic_castle`).
`<color>`	`"red"`	تحدد لون الأيقونة باستخدام رمز HEX (على سبيل المثال، `#FF0000`) أو اسم اللون (على سبيل المثال، `"blue"`)
`<background>`	`"circle"`	تحدد شكل خلفية الأيقونة. القيم الممكنة: `"circle"`، `"square"`، `"octagon"`.

مثال:

<wpt lat="52.5163" lon="13.3779">
  <name>Brandenburg Gate</name>
  <extensions>
    <osmand:color>#FF5020</osmand:color>
    <osmand:icon>city_gate</osmand:icon>
    <osmand:background>square</osmand:background>
  </extensions>
</wpt>

مجموعات نقاط الطريق

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

تعريف مجموعة النقاط. تحدد علامة <type> داخل عنصر <wpt> مجموعة النقطة (على سبيل المثال، "castle"، "aqueduct").
تكوين المجموعة. يحدد امتداد <osmand:points_groups> في عنصر <gpx> إعدادات كل مجموعة، بما في ذلك name وcolor وicon وbackground لجميع نقاط الطريق في تلك المجموعة.

مثال:

<gpx>
  <wpt lat="1.234" lon="5.678">
    <name>Look up to see the water</name>
    <type>aqueduct</type>
  </wpt>
  <wpt lat="5.678" lon="1.234">
    <name>Beware of ghosts</name>
    <type>castle</type>
  </wpt>
  <wpt lat="66.666" lon="66.666">
    <name>The house of Beetlejuice</name>
    <type>castle</type>
  </wpt>
  <extensions>
    <osmand:points_groups>
      <group name="castle" color="#FF0000" icon="historic_castle" background="circle"/>
      <group name="aqueduct" color="#0000FF" icon="bridge_structure_arch" background="circle"/>
    </osmand:points_groups>
  </extensions>
</gpx>

ميزات GPX المتقدمة

نوع النشاط

بدءًا من الإصدار 4.9 من OsmAnd، يمكنك تصنيف مساراتك حسب نوع النشاط لمزيد من التحليل والتنظيم في المجلدات.

تتوفر قائمة أنواع الأنشطة المدعومة في ملف activities.json. يتم تحديد كل نشاط بواسطة ID الفريد الخاص به ويتم تخزينه ضمن امتدادات <metadata> لملف GPX.

مثال:

  <metadata>
    <extensions>
      <osmand:activity>off_road_motorcycling_dirt_biking</osmand:activity>
    </extensions>
  </metadata>

HTML في الأوصاف

يمكن استخدام علامات HTML داخل علامات <desc> في عناصر <metadata> أو <wpt> لتوفير أوصاف منسقة للمسارات أو نقاط الطريق.

لتجنب التعارضات مع بناء جملة XML، استبدل الأحرف الخاصة على النحو التالي:

< → <
> → >
& → &

مثال:

<metadata>
  <desc>
    &lt;p&gt;
        The first paragraph will be displayed as &lt;b&gt;brief&lt;/b&gt; description.
        HTML tags are stripped in brief descriptions.
    &lt;/p&gt;
    &lt;p&gt;
      &lt;h3&gt;Second paragraph&lt;/h3&gt;
        &lt;b&gt;Hello, world!&lt;/b&gt;&lt;br/&gt;
        &lt;img src="..."/&gt;&lt;br/&gt;
        &lt;a href="..."&gt;url&lt;/a&gt;&lt;br/&gt;
        &lt;table&gt; ... &lt;/table&gt;
    &lt;/p&gt;
  </desc>
</metadata>

ملاحظات هامة:

يزيل OsmAnd جميع علامات HTML عند إنشاء أوصاف موجزة، تاركًا نصًا عاديًا.
يمكنك استخدام علامات مثل <b> و<i> و<p> و<br/> و<a> و<img> والمزيد للتخصيص.

علامة الرابط

استخدم علامة <link> لربط عناوين URL ببيانات التعريف أو معلومات المؤلف أو نقاط الطريق في ملفات OsmAnd GPX. يمكن لهذه العلامة أيضًا عرض صورة عندما يشير عنوان URL إلى ملف صورة.

أمثلة (رابط بيانات تعريف مع صورة):

<metadata>
  <link href="https://osmand.net/img/logo.png">
    <text>OsmAnd Logo</text>
  </link>
</metadata>

أمثلة (رابط نقطة طريق مع صورة):

<wpt lat="52.5163" lon="13.3779">
  <link href="https://osmand.net/img/logo.png" />
</wpt>

علامات بيانات المستشعر

يمكنك إثراء مساراتك ببيانات من مستشعرات اللياقة البدنية، مثل أجهزة مراقبة معدل ضربات القلب أو مستشعرات درجة الحرارة. يستخدم OsmAnd مخطط TrackPointExtension من Garmin لتخزين هذه البيانات، مما يجعلها متوافقة مع منصات مثل Strava و Garmin Basecamp.

علامات بيانات المستشعر المدعومة:

hr - معدل ضربات القلب (بالنبضات في الدقيقة).
cad - إيقاع الدراجة (بالدورات في الدقيقة).
atemp - درجة الحرارة المحيطة (بالدرجات المئوية).
power - خرج طاقة الدراجة (بالواط).

مثال:

<extensions>
  <gpxtpx:TrackPointExtension>
    <gpxtpx:hr>145</gpxtpx:hr>
    <gpxtpx:cad>80</gpxtpx:cad>
    <gpxtpx:atemp>22</gpxtpx:atemp>
    <gpxtpx:power>250</gpxtpx:power>
  </gpxtpx:TrackPointExtension>
</extensions>

تفاصيل نقطة المسار

يمكن أن تتضمن كل <trkpt> (نقطة مسار) في ملف GPX سمات إضافية لالتقاط بيانات مثل السرعة والاتجاه والارتفاع.

السمات المدعومة:

speed - السرعة عند نقطة المسار (بالأمتار في الثانية).
heading - اتجاه الحركة (0-359 درجة).
ele - الارتفاع فوق مستوى سطح البحر (بالأمتار).
time - الطابع الزمني لنقطة المسار.

مثال:

  <trkpt lat="52.397799" lon="4.575998">
    <ele>203</ele>
    <time>2019-05-08T10:36:43Z</time>
    <hdop>3</hdop>
    <extensions>
      <heading>273</heading>
      <speed>5.02</speed>
    </extensions>
  </trkpt>

المسارات المحسوبة

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

قد يحتوي ملف gpx على عدة مسارات. يحتوي كل منها على جزء محدد ضمن trkseg / extensions. يتم حفظ ملف gpx بهذا الشكل عند تصدير مسار تم إنشاؤه أو عند حفظ مسار يتكون من عدة أجزاء منفصلة عبر وظيفة تخطيط مسار.

تضيف وظيفة تخطيط مسار أيضًا كتلة rte واحدة (أو عدة كتل، وفقًا لعدد الأجزاء/المسارات المنفصلة الموجودة) إلى ملف gpx، تحتوي على نقاط المسار الرئيسية (rtept).

بنية Gpx:

<trk>
  <trkseg>
    // قائمة نقاط الجزء. يتوافق ترتيب النقاط مع ترتيب وطول أجزاء المسار (<route><segment length="x" ... />).
    // تتوافق قيمة السمة "length" مع عدد النقاط في هذا الجزء من المسار.
    <trkpt ... ></trkpt>
    <extensions>
      // قائمة أجزاء المسار
      <route>
        <segment ... />
      </route>
      // خصائص الأجزاء المضمنة في المسار.
      // يتم أخذ هذه البيانات من الخرائط غير المتصلة بالإنترنت أثناء البناء الأولي للمسار.
      <types>
        <type ... />
      </types>
    </extensions>
  </trkseg>
</trk>

// قائمة نقاط المسار الوسيطة. إذا كان هناك عدة مسارات، فإن ترتيب قائمة rte يتطابق مع ترتيب أجزاء المسار.
<rte>
  <rtept ... />
    // بالنسبة للمسارات التي تم إنشاؤها باستخدام "تخطيط مسار"، يتم حفظ معلمات النقاط الرئيسية.
    // إذا لم يكن rtept هو الأول والأخير، فسيتم قبله (بنفس idx) trkpt بنفس البيانات.
    <extensions>
      // نوع ملف تعريف المسار للجزء التالي (سيارة، دراجة، مشاة، إلخ).
      <profile>...</profile>
      // فهرس النقطة في جزء gpx الذي يتوافق مع النقطة الأولى للمسار المحسوب لهذا الجزء.
      // إذا لم يكن rtept هو الأول والأخير، فسيتم قبله (بنفس idx) trkpt بنفس البيانات.
      <trkpt_idx>...</trkpt_idx>
    </extensions>
  </rtept>
</rte>

خصائص هامة:

trkpt_idx لأول rtept في trkseg هو 0. لذا، إذا كان هناك اثنان trkseg، فسيكون هناك اثنان rtept مع trkpt_idx = 0
trkpt_idx لآخر rtept في trkseg يساوي عدد trkpt في trkseg ناقص 1. على سبيل المثال، إذا كان trkseg يحتوي على 12 trkpt، يجب أن يكون trkpt_idx لآخر rtept هو 11
تتداخل أجزاء المسار المتجاورة: نهاية الجزء السابق وبداية الجزء التالي هي نفس trkpt.
هناك استثناء عندما لا تتداخل أجزاء المسار المتجاورة (لا تشترك في نفس trkpt). يحدث ذلك عندما يكون هناك rtept "بين" أجزاء المسار. نهاية الجزء السابق للمسار هي trkpt واحد، وبداية الجزء التالي للمسار هي rtept آخر. لكن هاتين trkpt متساويتان تمامًا في خط العرض وخط الطول والمعلمات الأخرى.
يمكن اكتشاف تداخل أجزاء المسار عبر length و startTrkptIdx (يستخدم الأخير فقط لراحة القراءة البشرية):
- إذا كان مجموع startTrkptIdx و length لـ الجزء السابق للمسار يساوي startTrkptIdx لـ الجزء التالي للمسار، فإن أجزاء المسار لا تتداخل
- إذا كان المجموع أقل بواحد، فإن أجزاء المسار تتداخل
يمكن أن تكون هناك أجزاء مسار مستقيمة. يتم تمييزها بـ id="-1". يمكن أن تظهر في حالتين:
- إنه مسار متعدد الملفات الشخصية، وقد اختار المستخدم خطًا مستقيمًا
- وضع المستخدم rtept بعيدًا جدًا عن أقرب طريق، لذلك قام osmand بإنشاء خط مستقيم بين rtept والطريق
trkpts = length - (segments - 1) + (rtepts - 2)، حيث:
- trkpts - عدد trkpt داخل trkseg
- length - مجموع جميع length لأجزاء المسار داخل trkseg
- segments - عدد أجزاء المسار داخل trkseg
- rtepts - عدد rtept المملوكة لـ trkseg

مثال:

<gpx version="1.1" creator="OsmAndRouterV2" xmlns="http://www.topografix.com/GPX/1/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
  <metadata>
    <name>Fri 06 Nov 2020</name>
  </metadata>
  <trk>
    <name>Fri 06 Nov 2020</name>
    <trkseg>
      <trkpt lat="52.3639849" lon="4.8900533">
        <ele>0.801</ele>
      </trkpt>
      <trkpt lat="52.3636917" lon="4.8922849">
        <ele>0.998</ele>
      </trkpt>
      <trkpt lat="52.3636885" lon="4.892309">
        <ele>1</ele>
      </trkpt>
      <trkpt lat="52.3636426" lon="4.8922902">
        <ele>0.963</ele>
      </trkpt>
      <trkpt lat="52.363564" lon="4.8922607">
        <ele>0.899</ele>
      </trkpt>

      ....

      <extensions>
        <route>
          <segment id="7372058" length="3" segmentTime="178.44" speed="1.11" turnType="C" types="0,1,2,3,4,5,6" names="57" />
          <segment id="334164679" length="5" segmentTime="86.11" speed="1.11" turnType="TR" turnAngle="91.88" types="7,8,0,9,10,11,12,13,6" pointTypes=";;14,15;16,17,18;" names="58" />
          <segment id="334603581" length="6" segmentTime="75.5" speed="1.11" types="19,20,21,7,8,0,22,9,10,11,12,13,23,6" pointTypes=";14;16,24;16,24;14;" names="58" />
          <segment id="446707354" length="3" segmentTime="8.32" speed="1.11" turnType="TSLL" turnAngle="-25.44" types="19,25,21,7,8,22,9,1,11,12,13,6" names="58" />
          ...
        </route>
        <types>
          <type t="lit" v="yes" />
          <type t="oneway" v="yes" />
          <type t="highway" v="unclassified" />
          <type t="surface" v="paving_stones" />
          <type t="maxspeed" v="30" />
          ...
        </types>
      </extensions>
    </trkseg>
  </trk>

  <rte>
    <rtept lat="52.3639945" lon="4.8900532">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>0</trkpt_idx>
      </extensions>
    </rtept>
    <rtept lat="52.3612797" lon="4.8911677">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>24</trkpt_idx>
      </extensions>
    </rtept>
    <rtept lat="52.356996" lon="4.8912071">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>89</trkpt_idx>
      </extensions>
    </rtept>
    <rtept lat="52.3542374" lon="4.8947024">
      <extensions>
        <profile>pedestrian</profile>
        <trkpt_idx>121</trkpt_idx>
      </extensions>
    </rtept>
  </rte>
</gpx>

مجموعات GPX في OBF

يسمح لك OsmAnd بتحويل ملفات GPX متعددة إلى ملف OBF واحد. يتيح ذلك تخزين آلاف مسارات GPX بتنسيق مضغوط ومحسّن مع الحفاظ على ميزات مثل أيقونات الخريطة الخاصة، وتخصيص مظهر المسار، ووظيفة البحث. هذا يتجنب حد ملفات GPX المحلية الكبيرة التي لا يمكنها عادةً التعامل مع أكثر من 500 ألف نقطة إجمالاً، ومع ذلك قد تكون بعض ميزات مسارات GPX مفقودة مقارنة بعرض ملف OBF.

خطوات تحويل GPX إلى OBF:

سجل الدخول إلى خريطة الويب OsmAnd *← المسارات ← حدد مجلدًا ← القائمة (⋮) ← تنزيل كمجموعة OBF
يمكن استيراد ملف <.obf> الناتج إلى OsmAnd (يتطلب OsmAnd Android 5.0+).

نمط خط المسار

قم بتخصيص خطوط المسار باستخدام العلامات التالية:

علامة GPX	الافتراضي	الغرض
`<name>`	(لا شيء)	الاسم المعروض فوق خط المسار.
`color`	`red`	اللون الأساسي (HEX أو نص).
`colour`، `displaycolor`	(لا شيء)	طرق بديلة لتجاوز `color`.
`shield_waycolor`	(لا شيء)	تجاوز لون خط درع المسار `color`.
`translucent_line_colors`	`no`	اضبط على `yes` للألوان شبه الشفافة.
`width`	`thin`	عرض الخط: `"thin"`، `"medium"`، `"bold"`، `"1-24"`، أو `"roadstyle"`

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

مثال:

<gpx>
  <metadata>
    <name>
      Track name located in Metadata
    </name>
  </metadata>
  <trk>
    ...
  </trk>
  <extensions>
    <osmand:color>yellow</osmand:color>
    <osmand:width>roadstyle</osmand:width>
    <osmand:translucent_line_colors>yes</osmand:translucent_line_colors>
  </extensions>
</gpx>

دروع خط المسار

الدروع هي أيقونات أو رموز معروضة على طول خط المسار. يدعم OsmAnd دروع OSMC-symbol-style، والتي قد تتضمن:

أيقونة الخلفية - الشكل الرئيسي (على سبيل المثال، دائرة أو مربع).
أيقونات المقدمة - ما يصل إلى رمزين أصغر متراكبين فوق الخلفية.
نص - أوصاف قصيرة أو معرفات، مشتقة من علامات shield_text أو ref.

إذا لم يتم تعريف أي خصائص درع، يستخدم OsmAnd درعًا أصفر بحجم تلقائي للمسار.

علامات الدروع:

علامة GPX	الغرض
`shield_bg`	تحدد أيقونة الخلفية للدرع.
`shield_fg`	تحدد أيقونة المقدمة الأولى (على سبيل المثال، سهم أو نقطة).
`shield_fg_2`	تحدد أيقونة المقدمة الثانية (اختياري).
`shield_text`	تحدد النص القصير الذي سيتم عرضه فوق الدرع (على سبيل المثال، مرجع المسار).
`shield_textcolor`	تحدد لون نص الدرع (اختياري).
`shield_waycolor`	تتجاوز لون المسار القياسي لخط الدرع (اختياري).
`ref`	تستخدم كنص احتياطي إذا لم يتم توفير `shield_text`.

مثال:

<gpx>
  <trk>
    <name>Sample Route</name>
  </trk>
  <extensions>
    <osmand:shield_text>ABC</osmand:shield_text>
    <osmand:shield_fg>osmc_red_dot</osmand:shield_fg>
    <osmand:shield_bg>osmc_white_bg</osmand:shield_bg>
    <osmand:shield_waycolor>red</osmand:shield_waycolor>
    <osmand:shield_textcolor>black</osmand:shield_textcolor>
  </extensions>
</gpx>

عرض نقاط الطريق

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

علامة GPX	الافتراضي	الغرض
`icon`	(لا شيء)	تحدد الأيقونة لنقطة الطريق (تستخدم أيقونات محرر نقاط الطريق القياسية في OsmAnd).
`color`	`red`	تحدد لون الأيقونة باستخدام رمز HEX (على سبيل المثال، `#ffaa00`) أو اسم لون مدعوم (خيارات محدودة).
`background`	`circle`	تحدد شكل الأيقونة. القيم المدعومة: `circle`، `square`، `octagon`.

سلوك أشكال background:

circle - يعرض الأيقونة بخلفية دائرية.
square - يعرض الأيقونة بخلفية مربعة، ويصبح لونها أحمر افتراضيًا إذا لم يتم تحديد لون.
octagon - يتم التعامل معها كخلفية دائرية في OsmAnd.

الألوان المدعومة لـ background=circle: أزرق، رمادي، أخضر، أزرق فاتح، أخضر فاتح، برتقالي، بنفسجي، أصفر.

تحسينات مع عناصر إضافية:

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

مثال:

<wpt lat="3.1415926" lon="42">
  <name>PI</name>
  <extensions>
    <osmand:icon>historic_archaeological_site</osmand:icon>
    <osmand:background>circle</osmand:background>
    <osmand:color>#ffaa00</osmand:color>
  </extensions>
</wpt>

البحث بالاسم والمراجع

يمكن تحديد موقع المسارات ونقاط الطريق باستخدام مجموعة متنوعة من علامات GPX.

علامة GPX	الموقع	الغرض
`<name>`	`<metadata>`	الاسم الأساسي لمسار GPX.
`ref`	GPX `<extensions>`	معرف قصير، غالبًا ما يكون مشتقًا من علامة `ref` في OSM.
`shield_text`	GPX `<extensions>`	نص معروض على الدروع (يمكن استخدامه أيضًا مع `ref`).
`name_-_lang`	GPX/WPT `<extensions>`	`name:lang` مترجم (على سبيل المثال، `name_-_en` للإنجليزية، استبدل `:` بـ `_-_`)
`<name>`	`<wpt>`	اسم نقطة الطريق.

مثال:

<gpx>
  <metadata>
    <name>Xemxija Heritage Trail</name>
  </metadata>
  <extensions>
    <osmand:ref>XHT</osmand:ref>
  </extensions>
  <wpt lat="35.948477" lon="14.3806796">
    <name>Il-Mighba Rumana</name>
    <extensions>
      <osmand:name_-_en>The Roman Apiary</osmand:name_-_en>
    </extensions>
  </wpt>
</gpx>

البحث حسب نوع النشاط

ينظم OsmAnd المسارات في ملفات OBF إلى مجموعات الأنشطة و أنواع الأنشطة. تساعدك هذه التصنيفات في تصفية المسارات كنقاط اهتمام (POIs) أو إنشاء فلاتر بحث قائمة على الأنشطة.

كيف تعمل أنواع الأنشطة:

يتم تحديد أنواع الأنشطة والمجموعات باستخدام "id" و"tags" من ملف activities.json.
يستخدم OsmAnd علامات osmand:activity أو osmand:route لتصنيف الأنشطة في ملفات GPX.

علامة GPX	الموقع	الغرض
`osmand:activity`	`<metadata>`	علامة OsmAnd الرئيسية لتخزين نوع النشاط (ID).
`osmand:route`	GPX `<extensions>`	طريقة بديلة لـ OSM لتحديد نوع النشاط.

أمثلة على تنظيم المسارات حسب نوع النشاط:

سيصنف هذا المسار ضمن مجموعة ركوب الدراجات النارية بنوع ركوب الدراجات النارية على الطرق الوعرة (ركوب الدراجات الترابية).
```
<metadata>
  <extensions>
    <osmand:activity>off_road_motorcycling_dirt_biking</osmand:activity>
  </extensions>
</metadata>
```
سينظم هذا المسار ضمن مجموعة ركوب الدراجات بنوع ركوب الدراجات الجبلية.
```
<gpx>
  <extensions>
    <osmand:route>mtb</osmand:route>
  </extensions>
</gpx>
```

علامات معلومات البحث

تنشئ ملفات OBF وتخزن تلقائيًا إحصائيات وتحليلات المسار الهامة.

علامة OBF	الغرض
`distance`	المسافة الإجمالية التي تغطيها جميع أجزاء المسار.
`start_ele`، `ele_graph`	بيانات الارتفاع من GPX، ملفوفة في مصفوفة ثنائية مضغوطة.
`min_ele`، `avg_ele`، `max_ele`	تحليلات الارتفاع الأدنى والمتوسط والأقصى.
`diff_ele_up`، `diff_ele_down`	إجمالي الارتفاع المكتسب والمفقود عبر المسار.
`max_speed`، `avg_speed`، `min_speed`	تحليلات سرعة المسار، بما في ذلك السرعة القصوى والمتوسطة والدنيا.
`time_span`، `time_span_no_gaps`	الوقت الإجمالي للمسار، مع وبدون احتساب الفجوات.
`time_moving`، `time_moving_no_gaps`	إجمالي وقت الحركة، مع وبدون احتساب الفجوات.

علامات داخلية

تُستخدم بعض علامات GPX أو تُخزن بشكل غير مباشر في ملفات OBF. راجع OsmGpxWriteContext.java للحصول على تفاصيل حول التنفيذ.

علامة OBF	الغرض
`route_id`	معرف فريد لملف GPX، يربط بيانات الخريطة ونقاط الاهتمام (التنسيق: `/[A-Z]+[0-9]+/` على سبيل المثال `OSM12345`).
`route_type`	معرف مجموعة النشاط (`id`) مشتق من `poi/activities.json`
`route_activity_type`	نوع النشاط (داخل المجموعة) معرف (`id`) مشتق من `poi/activities.json`
`name`، `ref`، `description`	سمات قابلة للترجمة والبحث (`lang="true"` في أنواع نقاط الاهتمام)
`filename`	اسم ملف GPX الأصلي المستخدم لإنشاء هذا المسار.
`track_color`	لون مسار قسم الخريطة مشتق من `shield_waycolor`، `color`، `colour`، أو `displaycolor`
`extensions_extra_tags`	علامات إضافية عشوائية لـ `<gpx><extensions>` بتنسيق JSON.
`metadata_extra_tags`	علامات إضافية عشوائية لـ `<metadata><extensions>` بتنسيق JSON.
`wpt_extra_tags`	علامات إضافية عشوائية لنقاط الطريق `<wpt><extensions>` بتنسيق JSON.
`route_track_point`	نقاط الطريق من ملف GPX تستخدم هذا النوع في بيانات نقاط الاهتمام.
`route_bbox_radius`	يحدد نصف القطر الافتراضي للبحث عن أجزاء المسار داخل قسم نقاط الاهتمام
`route_shortlink_tiles`	يحدد قائمة مفصولة بفاصلات من بلاطات OSM Shortlink لتسريع قراءة بيانات الهندسة (اختياري)
`route_segment_index`	يحدد رقمًا ترتيبيًا لجزء الهندسة المرتبط بهذه النقطة (اختياري)
`route_name`	اسم المسار، يستخدم بواسطة `searchPoiByName` الداخلي (مهمل)

آخر تحديث: مارس 2025

مقدمة​

ما الذي يجعل ملفات GPX في OsmAnd فريدة؟​

ماذا ستتعلم في هذا الدليل؟​

نظرة عامة على بنية GPX​

تخصيص المسار​

معلمات مظهر المسار​

علامة 'coloring_type'​

علامات GPX في واجهة المستخدم​

تخصيص نقاط الطريق​

أيقونات نقاط الطريق​

مجموعات نقاط الطريق​

ميزات GPX المتقدمة​

نوع النشاط​

HTML في الأوصاف​

علامة الرابط​

علامات بيانات المستشعر​

تفاصيل نقطة المسار​

المسارات المحسوبة​

بنية Gpx:​

خصائص هامة:​

مثال:​

مجموعات GPX في OBF​

نمط خط المسار​

دروع خط المسار​

عرض نقاط الطريق​

البحث بالاسم والمراجع​

البحث حسب نوع النشاط​

علامات معلومات البحث​

علامات داخلية​

مقدمة

ما الذي يجعل ملفات GPX في OsmAnd فريدة؟

ماذا ستتعلم في هذا الدليل؟

نظرة عامة على بنية GPX

تخصيص المسار

معلمات مظهر المسار

علامة 'coloring_type'

علامات GPX في واجهة المستخدم

تخصيص نقاط الطريق

أيقونات نقاط الطريق

مجموعات نقاط الطريق

ميزات GPX المتقدمة

نوع النشاط

HTML في الأوصاف

علامة الرابط

علامات بيانات المستشعر

تفاصيل نقطة المسار

المسارات المحسوبة

بنية Gpx:

خصائص هامة:

مثال:

مجموعات GPX في OBF

نمط خط المسار

دروع خط المسار

عرض نقاط الطريق

البحث بالاسم والمراجع

البحث حسب نوع النشاط

علامات معلومات البحث

علامات داخلية