OsmAnd GPX

مقدمة

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

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

يوسع 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 هي الأولى والأخيرة، فستكون trkpt قبلها (بنفس idx) بنفس البيانات.
    <extensions>
      // نوع ملف تعريف المسار للمقطع التالي (سيارة، دراجة، مشاة، إلخ).
      <profile>...</profile>
      // فهرس النقطة في مقطع gpx الذي يتوافق مع النقطة الأولى للمسار المحسوب لهذا المقطع.
      // إذا لم تكن rtept هي الأولى والأخيرة، فستكون trkpt قبلها (بنفس idx) بنفس البيانات.
      <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`	(لا شيء)	تجاوز لون خط مسار الدرع.
`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>`	معرف قصير، غالبًا ما يكون مشتقًا من علامة OSM `ref`.
`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

مقدمة​

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

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

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

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

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

علامة "coloring_type"​

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

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

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

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

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

نوع النشاط​

HTML في الأوصاف​

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

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

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

المسار المحسوب (المسارات)​

بنية Gpx:​

خصائص هامة:​

مثال:​

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

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

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

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

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

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

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

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

مقدمة

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

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

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

تخصيص المسار

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

علامة "coloring_type"

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

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

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

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

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

نوع النشاط

HTML في الأوصاف

علامة الرابط

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

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

المسار المحسوب (المسارات)

بنية Gpx:

خصائص هامة:

مثال:

مجموعات GPX في OBF

نمط خط المسار

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

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

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

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

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

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