OsmAnd GPX

Giriş

GPX (GPS Exchange Format), izler, rotalar ve ara noktalar dahil olmak üzere GPS verilerini depolamak için yaygın olarak kullanılan XML tabanlı bir standarttır. OsmAnd, hem yeni başlayan hem de ileri düzey kullanıcıların deneyimlerini optimize etmelerini sağlayan navigasyon için GPS verilerini içe aktarma, dışa aktarma ve özelleştirme için GPX formatını destekler.

OsmAnd GPX'i Benzersiz Kılan Nedir?

OsmAnd, kendi özel osmand: XML ad alanını tanıtarak standart GPX 1.1 formatını genişletir. Bu ad alanı, aşağıdakiler gibi ek verilerin depolanmasını sağlar:

İz görsel ayarları (renk, genişlik, oklar).
Ara nokta gruplama ve simgeler.
Hesaplanan rotalar ve aktivite türleri dahil olmak üzere ayrıntılı rota öznitelikleri.

Bu Kılavuzda Neler Öğreneceksiniz?

Bu makale, OsmAnd'daki GPX dosya yapısı ve özelliklerine kapsamlı bir genel bakış sunmaktadır. Şunları öğreneceksiniz:

GPX etiketlerini kullanarak izleri ve ara noktaları nasıl özelleştireceğiniz.
HTML açıklamaları, sensör verileri ve aktivite türleri gibi gelişmiş özellikler.
Hesaplanan rotaları nasıl dışa aktaracağınız ve tüm işlevlerini nasıl koruyacağınız.
Optimize edilmiş depolama ve gelişmiş arama yetenekleri için GPX dosyalarını OBF formatına dönüştürme.

GPX Yapısına Genel Bakış

OsmAnd'daki GPX dosyaları, verileri hiyerarşik olarak aşağıdaki öğelere göre düzenler:

<gpx> - dosyanın kök öğesi.
<trk> - izleri temsil eder, bunlar şunları içerir:
- <trkseg> - iz segmentleri, bunlar ayrıca <trkpt> (iz noktaları) olarak ayrılır.
<rte> - ara noktalar ve anahtar noktalar dahil olmak üzere rotaları temsil eder.
<wpt> - bireysel ara noktaları temsil eder.

İz Özelleştirme

İz Görünüm Parametreleri

Bu bölüm, OsmAnd'ın izleri haritada nasıl görüntülediğini ve görünümlerini ayarlamak için mevcut özelleştirme seçeneklerini açıklar. Aşağıda açıklanan parametreler <gpx> etiketi içinde uygulanır ve bir GPX dosyasında bulunan tüm izleri etkiler.

Etiket Adı	Açıklama / Değerler
`<color>`	- İz çizgisinin haritadaki rengini tanımlar. - Dize: HEX renk kodu `#RRGGBB` veya `#AARRGGBB`
`<width>`	- İz çizgisinin genişliğini belirtir. - Dize: `"thin"`, `"medium"`, `"bold"` (`"currentTrackWidth"` özniteliği tarafından tanımlanır) veya tam sayı (1-24)
`<show_arrows>`	- İz boyunca yön oklarını etkinleştirir veya devre dışı bırakır. - Mantıksal: `"true"` / `"false"`
`<show_start_finish>`	- İzin başlangıcı ve sonu için işaretçileri gösterir veya gizler. - Mantıksal: `"true"` / `"false"`
`<split_type>`	- İz için segmentasyon türünü belirtir. - Dize: `"no_split"`, `"distance"`, `"time"`
`<split_interval>`	- Seçilen türe göre iz segmentasyonu için aralığı ayarlar. - Çift: Tam sayı (`"distance"` için metre, `"time"` için saniye)
`<line_3d_visualization_by_type>`	- İzin 3D görselleştirme türünü belirtir. - Dize: `"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>`	- 3D görselleştirme için duvar rengi türünü tanımlar. - Dize: `"none"`, `"solid"`, `"downward_gradient"`, `"upward_gradient"`, `"altitude"`, `"slope"`, `"speed"`
`<line_3d_visualization_position_type>`	- 3D görselleştirmenin izle göre konumunu ayarlar. - Dize: `"top"`, `"bottom"`, `"top_bottom"`
`<vertical_exaggeration_scale>`	- `line_3d_visualization_by_type` özniteliğinin değerini ölçeklendirmek için çarpan. - Ondalık: Varsayılan: 1.0
`<elevation_meters>`	- `<line_3d_visualization_by_type>` içinde `"fixed_height"` için sabit bir yüksekliği metre cinsinden belirtir. - Ondalık: Varsayılan: `1000`
`<coloring_type>`	- İz için renklendirme yöntemini belirler. - Dize: `"solid"`, `"speed"`, `"altitude"`, `"slope"`, `"routeInfo_roadClass`, `"routeInfo_surface"`, `"routeInfo_smoothness"`
`<color_palette>`	- İz için renk şemasını belirtir. - Dize: `"default"` / kullanıcı tanımlı şemalar

Örnek:

<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' Etiketi

OsmAnd'daki <coloring_type> etiketi, kullanıcıların iz renklendirmesini belirli veri özniteliklerine göre özelleştirmesine olanak tanıyarak, iz boyunca anahtar bilgileri görsel olarak yorumlamanın bir yolunu sunar.

Tür	Açıklama	Kullanım Durumu
`<solid>`	Tüm iz, `color` etiketiyle belirtilen tek, düz bir renkle görüntülenir.	Net görünürlük için tek tip bir renk gerektiğinde kullanın.
`<speed>`	İz, her iz noktasındaki (`<trkpt>`) hız değerlerine göre bir gradyanla renklendirilir. Daha yüksek hızlar farklı renklerle temsil edilir.	Hızdaki değişiklikleri görselleştirmek için bisiklet veya araba sürme gibi aktiviteler için idealdir.
`<altitude>`	İz, her `<trkpt>`'deki yükseklik verilerine göre renklendirilir. Farklı yükseklik aralıklarını gösteren bir gradyan uygulanır.	Yükseklik değişikliklerini vurgulamak için yürüyüş veya dağ rotaları için kullanışlıdır.
`<slope>`	İz, ardışık iz noktaları arasındaki eğime göre renklendirilir. Pozitif gradyanlar yokuş yukarı eğimleri, negatif gradyanlar ise yokuş aşağı eğimleri gösterir.	İz zorluğunu analiz eden bisikletçiler veya yürüyüşçüler için uygundur.
`<routeInfo_roadClass>`	İz segmentlerini OpenStreetMap (OSM) yol sınıflandırmasına (örn. otoyol, yerleşim yolu) göre renklendirir.	Bir rotayı takip ederken farklı yol türleri arasında ayrım yapmaya yardımcı olur.
`<routeInfo_surface>`	İz segmentlerini OSM yüzey türüne (örn. asfalt, çakıl, toprak) göre renklendirir.	Arazi sürüşü gibi aktiviteler sırasında iz koşullarını belirlemek için kullanışlıdır.
`<routeInfo_smoothness>`	İzleri OSM pürüzsüzlük derecelendirmelerine göre renklendirir, yolun pürüzlülüğünü veya pürüzsüzlüğünü gösterir (örn. mükemmel, kötü).	Belirli araçlar için iz gezilebilirliğini değerlendirmek için faydalıdır.

Kullanıcı Arayüzündeki GPX Etiketleri

GPX uzantı etiketleri, İz bağlam menüsünün altında görüntülenir. Hem <metadata> hem de <gpx> <extensions> listelenir. Görünüm etiketleri listeden çıkarılmıştır. OsmAnd Android 5.0'dan beri desteklenmektedir.

Ara Nokta Özelleştirme

Bu bölüm, OsmAnd'ın GPX dosyalarındaki ara noktaların simgeler, renkler ve gruplama kullanarak nasıl özelleştirilmesine izin verdiğini açıklar.

Ara Nokta Simgeleri

Aşağıdaki etiketler, OsmAnd'daki ara nokta simgelerinin görünümünü kontrol eder:

GPX etiketi	Varsayılan	Amaç
`<icon>`	(yok)	Ara nokta için simgeyi belirtir (örn. `historic_castle`).
`<color>`	`"red"`	Simgenin rengini bir HEX kodu (örn. `#FF0000`) veya renk adı (örn. `"blue"`) kullanarak ayarlar.
`<background>`	`"circle"`	Simgenin arka plan şeklini tanımlar. Olası değerler: `"circle"`, `"square"`, `"octagon"`.

Örnek:

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

Ara Nokta Grupları

OsmAnd'daki ara noktalar, türlerine göre gruplara ayrılabilir. Bu gruplama, kullanıcının birden çok ara noktayı belirli kategoriler altında düzenlemesine olanak tanıyarak harita netliğini ve okunabilirliğini artırır.

Nokta grubu tanımı. <wpt> öğesi içindeki <type> etiketi, noktanın grubunu belirtir (örn. "castle", "aqueduct").
Grup yapılandırması. <gpx> öğesindeki <osmand:points_groups> uzantısı, her grup için name, color, icon ve background dahil olmak üzere ayarları tanımlar.

Örnek:

<gpx>
  <wpt lat="1.234" lon="5.678">
    <name>Suyu görmek için yukarı bakın</name>
    <type>aqueduct</type>
  </wpt>
  <wpt lat="5.678" lon="1.234">
    <name>Hayaletlere dikkat edin</name>
    <type>castle</type>
  </wpt>
  <wpt lat="66.666" lon="66.666">
    <name>Beetlejuice'un evi</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>

Gelişmiş GPX Özellikleri

Aktivite Türü

OsmAnd sürüm 4.9'dan başlayarak, daha fazla analiz ve klasörlerde düzenleme için izlerinizi aktivite türüne göre sınıflandırabilirsiniz.

Desteklenen aktivite türlerinin listesi activities.json dosyasında mevcuttur. Her aktivite, benzersiz ID'si ile tanımlanır ve GPX dosyasının <metadata> uzantılarında saklanır.

Örnek:

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

Açıklamalarda HTML

HTML etiketleri, izler veya ara noktalar için biçimlendirilmiş açıklamalar sağlamak üzere <metadata> veya <wpt> öğelerindeki <desc> etiketleri içinde kullanılabilir.

XML sözdizimiyle çakışmaları önlemek için özel karakterleri aşağıdaki gibi değiştirin:

< → <
> → >
& → &

Örnek:

<metadata>
  <desc>
    &lt;p&gt;
        İlk paragraf &lt;b&gt;kısa&lt;/b&gt; açıklama olarak görüntülenecektir.
        HTML etiketleri kısa açıklamalarda kaldırılır.
    &lt;/p&gt;
    &lt;p&gt;
      &lt;h3&gt;İkinci paragraf&lt;/h3&gt;
        &lt;b&gt;Merhaba dünya!&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>

Önemli notlar:

OsmAnd, kısa açıklamalar oluştururken tüm HTML etiketlerini kaldırarak düz metin bırakır.
Özelleştirme için <b>, <i>, <p>, <br/>, <a>, <img> ve daha fazlası gibi etiketleri kullanabilirsiniz.

Bağlantı Etiketi

OsmAnd GPX dosyalarında URL'leri meta veriler, yazar bilgileri veya ara noktalarla ilişkilendirmek için <link> etiketini kullanın. Bu etiket, URL bir görüntü dosyasına işaret ettiğinde bir görüntü de görüntüleyebilir.

Örnekler (Görüntülü meta veri bağlantısı):

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

Örnekler (Görüntülü ara nokta bağlantısı):

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

Sensör Veri Etiketleri

İzlerinizi kalp atış hızı monitörleri veya sıcaklık sensörleri gibi fitness sensörlerinden gelen verilerle zenginleştirebilirsiniz. OsmAnd, bu verileri depolamak için Garmin'in TrackPointExtension şemasını kullanır ve Strava ve Garmin Basecamp gibi platformlarla uyumlu hale getirir.

Desteklenen Sensör Veri Etiketleri:

hr - kalp atış hızı (dakikadaki vuruş sayısı).
cad - bisiklet kadansı (dakikadaki devir sayısı).
atemp - ortam sıcaklığı (Celsius cinsinden).
power - bisiklet güç çıkışı (watt cinsinden).

Örnek:

<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>

İz Noktası Detayları

GPX dosyasındaki her <trkpt> (iz noktası), hız, yön ve yükseklik gibi verileri yakalamak için ek öznitelikler içerebilir.

Desteklenen öznitelikler:

speed - iz noktasındaki hız (saniyede metre cinsinden).
heading - hareket yönü (0-359 derece).
ele - deniz seviyesinden yükseklik (metre cinsinden).
time - iz noktası için zaman damgası.

Örnek:

  <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>

Hesaplanan rota(lar)

OsmAnd'da rota hesaplayabilir ve tüm verileri GPX'e kaydedebilirsiniz, böylece daha sonra tüm özellik navigasyonu çalışan GPX navigasyonu olarak kullanılabilir, yani OsmAnd gpx'i rota segmentleri, dönüşler, yol adları, yol türleri, kısıtlamalar vb. içerecektir. Rota, ilgili çevrimdışı haritaların yokluğunda bile, sanki yeni oluşturulmuş gibi tamamen geri yüklenebilir.

Bir gpx dosyası birden fazla rota içerebilir. Her biri trkseg / extensions altında belirli bir segmentte bulunur. Bir gpx dosyası, oluşturulmuş bir rotayı dışa aktarırken veya Rota planla işlevselliği aracılığıyla birkaç ayrı segmentten oluşan bir izi kaydederken bu biçimde kaydedilir.

Rota planla ayrıca, rota anahtar noktalarını (rtept) içeren gpx dosyasına bir (veya içerdiği ayrı segment / iz sayısına göre birkaç) rte bloğu ekler.

Gpx yapısı:

<trk>
  <trkseg>
    // Segment noktalarının listesi. Noktaların sırası, rota segmentlerinin sırasına ve uzunluğuna karşılık gelir (<route><segment length="x" ... />).
    // "length" özniteliğinin değeri, rotanın bu segmentindeki nokta sayısına karşılık gelir.
    <trkpt ... ></trkpt>
    <extensions>
      // Rota segmentlerinin listesi
      <route>
        <segment ... />
      </route>
      // Rotaya dahil edilen segmentlerin özellikleri.
      // Bu veriler, bir rotanın ilk oluşturulması sırasında çevrimdışı haritalardan alınır.
      <types>
        <type ... />
      </types>
    </extensions>
  </trkseg>
</trk>

// Ara rota noktalarının listesi. Birden fazla rota varsa, rte listesinin sırası rota segmentlerinin sırasıyla eşleşir.
<rte>
  <rtept ... />
    // "Rota planla" ile oluşturulan rotalar için anahtar noktaların parametreleri kaydedilir.
    // Eğer rtept ilk ve son değilse, ondan önce (aynı idx ile) trkpt aynı verilerle olacaktır.
    <extensions>
      // Sonraki segment için rota profil türü (araba, bisiklet, yaya vb.).
      <profile>...</profile>
      // Bu segment için hesaplanan rotanın ilk noktasına karşılık gelen gpx segmentindeki noktanın indeksi.
      // Eğer rtept ilk ve son değilse, ondan önce (aynı idx ile) trkpt aynı verilerle olacaktır.
      <trkpt_idx>...</trkpt_idx>
    </extensions>
  </rtept>
</rte>

Önemli özellikler:

trkseg'deki ilk rtept'nin trkpt_idx'i 0'dır. Yani, iki trkseg varsa, trkpt_idx = 0 olan iki rtept olacaktır.
trkseg'deki son rtept'nin trkpt_idx'i, trkseg'deki trkpt sayısı eksi 1'e eşittir. Örneğin, trkseg 12 trkpt'ye sahipse, son rtept'nin trkpt_idx'i 11 olmalıdır.
Komşu rota segmentleri çakışıyor: önceki segmentin sonu ve sonraki segmentin başlangıcı aynı trkpt'dir.
Komşu rota segmentlerinin çakışmadığı (aynı trkpt'yi paylaşmadığı) istisnalar vardır. Bu, rota segmentleri "arasında" rtept olduğunda meydana gelir. Önceki rota segmentinin sonu bir trkpt'dir ve sonraki rota segmentinin başlangıcı başka bir rtept'dir. Ancak bu iki trkpt, enlem, boylam ve diğer parametreler açısından tamamen eşittir.
Rota segment çakışması, length ve startTrkptIdx (ikincisi yalnızca insan okuma kolaylığı için kullanılır) aracılığıyla tespit edilebilir:
- Önceki rota segmentinin startTrkptIdx ve length toplamı, sonraki rota segmentinin startTrkptIdx'ine eşitse, rota segmentleri çakışmaz.
- Toplam bir eksikse, rota segmentleri çakışır.
Düz rota segmentleri olabilir. Bunlar id="-1" ile işaretlenir. İki durumda ortaya çıkabilirler:
- Çok profilli bir rotadır ve kullanıcı düz çizgiyi seçmiştir.
- Kullanıcı rtept'yi en yakın yoldan çok uzağa yerleştirmiştir, bu nedenle osmand rtept ile yol arasında düz bir çizgi oluşturmuştur.
trkpts = length - (segments - 1) + (rtepts - 2), burada:
- trkpts - trkseg içindeki trkpt sayısı
- length - trkseg içindeki rota segmentlerinin tüm length'lerinin toplamı
- segments - trkseg içindeki rota segmentlerinin sayısı
- rtepts - trkseg'e ait rtept sayısı

Örnek:

<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>Cuma 06 Kasım 2020</name>
  </metadata>
  <trk>
    <name>Cuma 06 Kasım 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>

OBF'deki GPX Koleksiyonları

OsmAnd, birden çok GPX dosyasını tek bir OBF dosyasına dönüştürmenize olanak tanır. Bu, özel harita simgeleri, iz görünümü özelleştirmesi ve arama işlevselliği gibi özellikleri korurken binlerce GPX izini kompakt, optimize edilmiş bir biçimde depolamayı sağlar. Bu, genellikle toplamda 500 bin noktadan fazlasını işleyemeyen yerel büyük GPX dosyalarının sınırını aşar, ancak OBF dosyasını görüntülemeye kıyasla GPX izlerinin bazı özellikleri eksik olabilir.

GPX'i OBF'ye dönüştürme adımları:

OsmAnd Web Haritası *→ İzler → Bir klasör seçin → Menü (⋮) → OBF koleksiyonu olarak indir
Ortaya çıkan <.obf> dosyası OsmAnd'a aktarılabilir (OsmAnd Android 5.0+ gerektirir).

İz Çizgi Stili

İz çizgilerini aşağıdaki etiketlerle özelleştirin:

GPX etiketi	Varsayılan	Amaç
`<name>`	(yok)	İz çizgisi üzerinde görüntülenen ad.
`color`	`red`	Birincil renk (HEX veya metin).
`colour`, `displaycolor`	(yok)	`color`'ı geçersiz kılmanın alternatif yolları.
`shield_waycolor`	(yok)	Kalkan iz çizgisi `color`'ı için geçersiz kılma.
`translucent_line_colors`	`no`	Yarı saydam renkler için `yes` olarak ayarlayın.
`width`	`thin`	Çizgi genişliği: `"thin"`, `"medium"`, `"bold"`, `"1-24"` veya `"roadstyle"`

Desteklenen renkler: siyah, mavi, kahverengi, koyusarı, gri, yeşil, açıkmavi, açıkyeşil, turuncu, mor, kırmızı, beyaz, sarı.

Örnek:

<gpx>
  <metadata>
    <name>
      Meta Verilerde bulunan İz adı
    </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>

İz Çizgi Kalkanları

Kalkanlar, iz çizgisi boyunca görüntülenen simgeler veya sembollerdir. OsmAnd, aşağıdakileri içerebilen OSMC-sembol-stili kalkanlarını destekler:

Arka plan simgesi - ana şekil (örn. daire veya kare).
Ön plan simgeleri - arka plan üzerine katmanlanmış en fazla iki küçük sembol.
Metin - shield_text veya ref etiketlerinden türetilen kısa açıklamalar veya tanımlayıcılar.

Kalkan özellikleri tanımlanmazsa, OsmAnd iz için otomatik boyutlandırılmış sarı bir kalkan kullanır.

Kalkanlar için etiketler:

GPX etiketi	Amaç
`shield_bg`	Kalkan için arka plan simgesini tanımlar.
`shield_fg`	İlk ön plan simgesini belirtir (örn. bir ok veya nokta).
`shield_fg_2`	İkinci ön plan simgesini belirtir (isteğe bağlı).
`shield_text`	Kalkan üzerinde görüntülenecek kısa metni ayarlar (örn. rota referansı).
`shield_textcolor`	Kalkan metninin rengini belirler (isteğe bağlı).
`shield_waycolor`	Kalkanın çizgisi için standart iz rengini geçersiz kılar (isteğe bağlı).
`ref`	`shield_text` sağlanmazsa yedek metin olarak kullanılır.

Örnek:

<gpx>
  <trk>
    <name>Örnek Rota</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>

Ara Nokta Görüntüleme

Ara nokta simgeleri aşağıdaki etiketlerle özelleştirilebilir:

GPX etiketi	Varsayılan	Amaç
`icon`	(yok)	Ara nokta için simgeyi belirtir (standart OsmAnd ara nokta düzenleyici simgelerini kullanır).
`color`	`red`	Bir HEX kodu (örn. `#ffaa00`) veya desteklenen bir renk adı (sınırlı seçenekler) kullanarak simge rengini ayarlar.
`background`	`circle`	Simgenin şeklini tanımlar. Desteklenen değerler: `circle`, `square`, `octagon`.

background şekillerinin davranışı:

circle - simgeyi dairesel bir arka planla görüntüler.
square - simgeyi kare bir arka planla görüntüler, renk belirtilmezse varsayılan olarak kırmızı olur.
octagon - OsmAnd'da dairesel bir arka plan olarak işlenir.

background=circle için desteklenen renkler: mavi, gri, yeşil, açıkmavi, açıkyeşil, turuncu, mor, sarı.

Ek öğelerle geliştirmeler:

HTML kodu kullanarak ara noktalara biçimlendirilmiş açıklamalar ekleyebilirsiniz. Bu, stilize edilmiş metin, bağlantılar veya hatta resimler eklemenizi sağlar.
Ara noktalar, Görüntü olarak bağlantı kullanarak bağlantılı görüntüleri görüntüleyebilir.

Örnek:

<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>

Ada ve Referanslara Göre Arama

İzler ve ara noktalar çeşitli GPX etiketleri kullanılarak bulunabilir.

GPX etiketi	Konum	Amaç
`<name>`	`<metadata>`	GPX izinin birincil adı.
`ref`	GPX `<extensions>`	Genellikle OSM `ref` etiketinden türetilen kısa bir tanımlayıcı.
`shield_text`	GPX `<extensions>`	Kalkanlarda görüntülenen metin (ayrıca `ref` ile de kullanılabilir).
`name_-_lang`	GPX/WPT `<extensions>`	Yerelleştirilmiş `name:lang` (örn. İngilizce için `name_-_en`, `:` -> `_-_` ile değiştirin)
`<name>`	`<wpt>`	Ara noktanın adı.

Örnek:

<gpx>
  <metadata>
    <name>Xemxija Miras Yolu</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>Roma Arı Kovanı</osmand:name_-_en>
    </extensions>
  </wpt>
</gpx>

Aktivite türüne göre arama

OsmAnd, OBF dosyalarındaki izleri Aktivite Grupları ve Aktivite Türleri halinde düzenler. Bu sınıflandırmalar, izleri POI olarak filtrelemenize veya aktivite tabanlı arama filtreleri oluşturmanıza yardımcı olur.

Aktivite türleri nasıl çalışır:

Aktivite türleri ve grupları, activities.json dosyasındaki "id" ve "tags" kullanılarak belirlenir.
OsmAnd, GPX dosyalarındaki aktiviteleri sınıflandırmak için osmand:activity veya osmand:route etiketlerini kullanır.

GPX etiketi	Konum	Amaç
`osmand:activity`	`<metadata>`	Aktivite türünü (ID) depolamak için ana OsmAnd etiketi.
`osmand:route`	GPX `<extensions>`	Aktivite türünü tanımlamanın alternatif OSM yolu.

İzleri aktivite türüne göre düzenleme örnekleri:

Bu, izi Motosiklet grubu altında Arazi Motosikleti (Kir Bisikleti) türüyle sınıflandıracaktır.

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

Bu, izi Bisiklet grubu altında Dağ Bisikleti türüyle düzenleyecektir.

<gpx>
  <extensions>
    <osmand:route>mtb</osmand:route>
  </extensions>
</gpx>

Arama bilgisi Etiketleri

OBF dosyaları otomatik olarak kritik iz istatistiklerini ve analizlerini oluşturur ve depolar.

OBF etiketi	Amaç
`distance`	Tüm iz segmentleri tarafından katedilen toplam mesafe.
`start_ele`, `ele_graph`	GPX'ten yükseklik verileri, kompakt bir ikili dizide sarılı.
`min_ele`, `avg_ele`, `max_ele`	Minimum, ortalama ve maksimum yükseklik analizleri.
`diff_ele_up`, `diff_ele_down`	İz boyunca toplam yükseklik kazanımı ve kaybı.
`max_speed`, `avg_speed`, `min_speed`	Maksimum, ortalama ve minimum hız dahil olmak üzere iz hız analizleri.
`time_span`, `time_span_no_gaps`	İz için toplam süre, boşluklar hesaba katılarak ve boşluklar hesaba katılmadan.
`time_moving`, `time_moving_no_gaps`	Toplam hareket süresi, boşluklar hesaba katılarak ve boşluklar hesaba katılmadan.

Dahili Etiketler

Bazı GPX etiketleri OBF dosyalarında dolaylı olarak kullanılır veya depolanır. Uygulama ayrıntıları için OsmGpxWriteContext.java adresine bakın.

OBF etiketi	Amaç
`route_id`	Harita ve POI verilerini bağlayan GPX dosyası için benzersiz bir tanımlayıcı (biçim: `/[A-Z]+[0-9]+/` örn. `OSM12345`).
`route_type`	`poi/activities.json`'dan türetilen aktivite grubu tanımlayıcısı (`id`)
`route_activity_type`	`poi/activities.json`'dan türetilen aktivite türü (grup içinde) tanımlayıcısı (`id`)
`name`, `ref`, `description`	Yerelleştirilebilir ve aranabilir öznitelikler (POI türlerinde `lang="true"`)
`filename`	Bu izi oluşturmak için kullanılan orijinal GPX dosyasının adı.
`track_color`	`shield_waycolor`, `color`, `colour` veya `displaycolor`'dan türetilen harita bölümü iz rengi
`extensions_extra_tags`	JSON formatında `<gpx><extensions>` için rastgele ek etiketler.
`metadata_extra_tags`	JSON formatında `<metadata><extensions>` için rastgele ek etiketler.
`wpt_extra_tags`	JSON formatında ara noktalar `<wpt><extensions>` için rastgele ek etiketler.
`route_track_point`	GPX dosyasındaki ara noktalar, POI verilerinde bu türü kullanır.
`route_bbox_radius`	POI bölümünde izin bölümlerini aramak için varsayılan yarıçapı belirtir
`route_shortlink_tiles`	Geometri verilerini okumayı hızlandırmak için virgülle ayrılmış OSM Kısa Bağlantı döşemeleri listesini belirtir (isteğe bağlı)
`route_segment_index`	Bu noktaya bağlı geometri segmentinin sıra numarasını belirtir (isteğe bağlı)
`route_name`	Dahili `searchPoiByName` tarafından kullanılan rota adı (kullanımdan kaldırıldı)

Son güncelleme: Mart 2025

Giriş​

OsmAnd GPX'i Benzersiz Kılan Nedir?​

Bu Kılavuzda Neler Öğreneceksiniz?​

GPX Yapısına Genel Bakış​

İz Özelleştirme​

İz Görünüm Parametreleri​

'coloring_type' Etiketi​

Kullanıcı Arayüzündeki GPX Etiketleri​

Ara Nokta Özelleştirme​

Ara Nokta Simgeleri​

Ara Nokta Grupları​

Gelişmiş GPX Özellikleri​

Aktivite Türü​

Açıklamalarda HTML​

Bağlantı Etiketi​

Sensör Veri Etiketleri​

İz Noktası Detayları​

Hesaplanan rota(lar)​

Gpx yapısı:​

Önemli özellikler:​

Örnek:​

OBF'deki GPX Koleksiyonları​

İz Çizgi Stili​

İz Çizgi Kalkanları​

Ara Nokta Görüntüleme​

Ada ve Referanslara Göre Arama​

Aktivite türüne göre arama​

Arama bilgisi Etiketleri​

Dahili Etiketler​

Giriş

OsmAnd GPX'i Benzersiz Kılan Nedir?

Bu Kılavuzda Neler Öğreneceksiniz?

GPX Yapısına Genel Bakış

İz Özelleştirme

İz Görünüm Parametreleri

'coloring_type' Etiketi

Kullanıcı Arayüzündeki GPX Etiketleri

Ara Nokta Özelleştirme

Ara Nokta Simgeleri

Ara Nokta Grupları

Gelişmiş GPX Özellikleri

Aktivite Türü

Açıklamalarda HTML

Bağlantı Etiketi

Sensör Veri Etiketleri

İz Noktası Detayları

Hesaplanan rota(lar)

Gpx yapısı:

Önemli özellikler:

Örnek:

OBF'deki GPX Koleksiyonları

İz Çizgi Stili

İz Çizgi Kalkanları

Ara Nokta Görüntüleme

Ada ve Referanslara Göre Arama

Aktivite türüne göre arama

Arama bilgisi Etiketleri

Dahili Etiketler