GPX do OsmAnd
Introdução
GPX (GPS Exchange Format) é um padrão baseado em XML amplamente utilizado para armazenar dados de GPS, incluindo trilhas, rotas e pontos de passagem. O OsmAnd suporta o formato GPX para importar, exportar e personalizar dados de GPS para navegação, permitindo que usuários iniciantes e avançados otimizem sua experiência.
O que torna o GPX do OsmAnd único?
O OsmAnd estende o formato GPX 1.1 padrão, introduzindo seu próprio namespace XML osmand:. Este namespace permite armazenar dados adicionais, como:
- Configurações visuais da trilha (cor, largura, setas).
- Agrupamento e ícones de pontos de passagem.
- Atributos detalhados da rota, incluindo rotas calculadas e tipos de atividade.
O que você aprenderá neste guia?
Este artigo fornece uma visão geral abrangente da estrutura e dos recursos do arquivo GPX no OsmAnd. Você aprenderá:
- Como personalizar trilhas e pontos de passagem usando tags GPX.
- Recursos avançados, como descrições HTML, dados de sensores e tipos de atividade.
- Como exportar rotas calculadas e preservar sua funcionalidade completa.
- Converter arquivos GPX para o formato OBF para armazenamento otimizado e recursos de pesquisa avançados.
Visão geral da estrutura GPX
Os arquivos GPX no OsmAnd organizam os dados hierarquicamente nos seguintes elementos:
<gpx>- o elemento raiz do arquivo.<trk>- representa trilhas, que contêm:<trkseg>- segmentos da trilha, que são ainda divididos em<trkpt>(pontos da trilha).
<rte>- representa rotas, incluindo pontos de passagem e pontos-chave.<wpt>- representa pontos de passagem individuais.
Personalização de trilhas
Parâmetros de aparência da trilha
Esta seção descreve como o OsmAnd exibe trilhas no mapa e as opções de personalização disponíveis para ajustar sua aparência. Os parâmetros descritos abaixo são aplicados dentro da tag <gpx> e afetam todas as trilhas incluídas em um arquivo GPX.
| Nome da tag | Descrição / Valores |
|---|---|
<color> | - Define a cor da linha da trilha no mapa. - String: Código de cor HEX #RRGGBB ou #AARRGGBB |
<width> | - Especifica a largura da linha da trilha. - String: “thin” (fina), “medium" (média), “bold” (grossa) (definida pelo atributo “currentTrackWidth”), ou inteiro (1-24) |
<show_arrows> | - Habilita ou desabilita as setas de direção ao longo da trilha. - Bool: "true" / "false" |
<show_start_finish> | - Mostra ou oculta marcadores para o início e o fim da trilha. - Bool: "true" / "false" |
<split_type> | - Especifica o tipo de segmentação para a trilha. - String: "no_split" (sem divisão), "distance" (distância), "time" (tempo) |
<split_interval> | - Define o intervalo para a segmentação da trilha com base no tipo selecionado. - Double: Inteiro (metros para "distance", segundos para "time") |
<line_3d_visualization_by_type> | - Especifica o tipo de visualização 3D para a trilha. - String: "none" (nenhum), "altitude" (altitude), "shared_string_speed" (velocidade de string compartilhada), "map_widget_ant_heart_rate" (frequência cardíaca ANT do widget do mapa), "map_widget_ant_bicycle_cadence" (cadência da bicicleta ANT do widget do mapa), "map_widget_ant_bicycle_power" (potência da bicicleta ANT do widget do mapa), "shared_string_temperature" (temperatura de string compartilhada), "shared_string_speed" (velocidade de string compartilhada), "fixed_height" (altura fixa) |
<line_3d_visualization_wall_color_type> | - Define o tipo de cor da parede para visualização 3D. - String: "none" (nenhum), "solid" (sólido), "downward_gradient" (gradiente para baixo), "upward_gradient" (gradiente para cima), "altitude" (altitude), "slope" (inclinação), "speed" (velocidade) |
<line_3d_visualization_position_type> | - Define a posição da visualização 3D em relação à trilha. - String: "top" (topo), "bottom" (inferior), "top_bottom" (topo e inferior) |
<vertical_exaggeration_scale> | - Multiplicador para escalar o valor do atributo line_3d_visualization_by_type. - Float: Padrão: 1.0 |
<elevation_meters> | - Especifica uma elevação fixa em metros para "fixed_height" em <line_3d_visualization_by_type>. - Float: Padrão: 1000 |
<coloring_type> | - Determina o método de coloração para a trilha. - String: "solid" (sólido), "speed" (velocidade), "altitude" (altitude), "slope" (inclinação), "routeInfo_roadClass" (classe de estrada RouteInfo), "routeInfo_surface" (superfície RouteInfo), "routeInfo_smoothness" (suavidade RouteInfo) |
<color_palette> | - Especifica o esquema de cores para a trilha. - String: "default" (padrão) / esquemas definidos pelo usuário |
Exemplo:
<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>
Tag 'coloring_type'
A tag <coloring_type> no OsmAnd permite que os usuários personalizem a coloração da trilha com base em atributos de dados específicos, fornecendo uma maneira visual de interpretar informações-chave ao longo da trilha.
| Tipo | Descrição | Caso de uso |
|---|---|---|
<solid> | A trilha inteira é exibida com uma única cor sólida especificada pela tag color. | Use quando uma cor uniforme for necessária para visibilidade clara. |
<speed> | A trilha é colorida em um gradiente com base nos valores de velocidade em cada ponto da trilha (<trkpt>). Velocidades mais altas são representadas por cores distintas. | Ideal para atividades como ciclismo ou direção para visualizar mudanças na velocidade. |
<altitude> | A trilha é colorida de acordo com os dados de elevação em cada <trkpt>. Um gradiente é aplicado, indicando diferentes faixas de altitude. | Útil para rotas de caminhada ou montanha para destacar mudanças de altitude. |
<slope> | A trilha é colorida com base na inclinação/declínio entre pontos de trilha consecutivos. Gradientes positivos indicam inclinações para cima, enquanto gradientes negativos indicam para baixo. | Adequado para ciclistas ou caminhantes que analisam a dificuldade da trilha. |
<routeInfo_roadClass> | Colore os segmentos da trilha com base na classificação de estrada do OpenStreetMap (OSM) (por exemplo, rodovia, rua residencial). | Ajuda a distinguir entre diferentes tipos de estrada ao seguir uma rota. |
<routeInfo_surface> | Colore os segmentos da trilha com base no tipo de superfície do OSM (por exemplo, pavimentado, cascalho, terra). | Útil para determinar as condições da trilha durante atividades como off-road. |
<routeInfo_smoothness> | Colore a trilha de acordo com as classificações de suavidade do OSM, indicando a aspereza ou suavidade do caminho (por exemplo, excelente, ruim). | Útil para avaliar a navegabilidade da trilha para veículos específicos. |
Tags GPX na interface do usuário
As tags de extensão GPX são exibidas na parte inferior do menu de contexto da trilha.
Ambas as <metadata> e <gpx> <extensions> são listadas.
As tags de aparência são excluídas da listagem.
Suportado desde o OsmAnd Android 5.0.
Personalização de pontos de passagem
Esta seção explica como o OsmAnd permite a personalização de pontos de passagem em arquivos GPX usando ícones, cores e agrupamento.
Ícones de pontos de passagem
As seguintes tags controlam a aparência dos ícones de pontos de passagem no OsmAnd:
| Tag GPX | Padrão | Finalidade |
|---|---|---|
<icon> | (nenhum) | Especifica o ícone para o ponto de passagem (por exemplo, historic_castle). |
<color> | "red" | Define a cor do ícone usando um código HEX (por exemplo, #FF0000) ou nome da cor (por exemplo, "blue"). |
<background> | "circle" | Define a forma do plano de fundo do ícone. Valores possíveis: "circle", "square", "octagon". |
Exemplo:
<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>
Grupos de pontos de passagem
Os pontos de passagem no OsmAnd podem ser classificados em grupos com base em seu tipo. Esse agrupamento permite que o usuário organize vários pontos de passagem em categorias específicas, melhorando a clareza e a legibilidade do mapa.
- Definição de grupo de pontos. A tag
<type>dentro do elemento<wpt>especifica o grupo do ponto (por exemplo,"castle","aqueduct"). - Configuração de grupo. A extensão
<osmand:points_groups>no elemento<gpx>define as configurações para cada grupo, incluindo oname,color,iconebackgroundpara todos os pontos de passagem nesse grupo.
Exemplo:
<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>
Recursos avançados de GPX
Tipo de atividade
A partir do OsmAnd versão 4.9, você pode classificar suas trilhas por tipo de atividade para análise e organização em pastas.
A lista de tipos de atividade suportados está disponível no arquivo activities.json. Cada atividade é identificada por seu ID exclusivo e armazenada nas extensões <metadata> do arquivo GPX.
Exemplo:
<metadata>
<extensions>
<osmand:activity>off_road_motorcycling_dirt_biking</osmand:activity>
</extensions>
</metadata>
HTML em descrições
Tags HTML podem ser usadas dentro das tags <desc> nos elementos <metadata> ou <wpt> para fornecer descrições formatadas para trilhas ou pontos de passagem.
Para evitar conflitos com a sintaxe XML, substitua caracteres especiais da seguinte forma:
<→<>→>&→&
Exemplo:
<metadata>
<desc>
<p>
The first paragraph will be displayed as <b>brief</b> description.
HTML tags are stripped in brief descriptions.
</p>
<p>
<h3>Second paragraph</h3>
<b>Hello, world!</b><br/>
<img src="..."/><br/>
<a href="...">url</a><br/>
<table> ... </table>
</p>
</desc>
</metadata>
Notas importantes:
- O OsmAnd remove todas as tags HTML ao gerar descrições breves, deixando texto simples.
- Você pode usar tags como
<b>,<i>,<p>,<br/>,<a>,<img>e outras para personalização.
Tag de link
Use a tag <link> para associar URLs a metadados, informações do autor ou pontos de passagem em arquivos GPX do OsmAnd. Esta tag também pode exibir uma imagem quando a URL aponta para um arquivo de imagem.
Exemplos (Link de metadados com imagem):
<metadata>
<link href="https://osmand.net/img/logo.png">
<text>OsmAnd Logo</text>
</link>
</metadata>
Exemplos (Link de ponto de passagem com imagem):
<wpt lat="52.5163" lon="13.3779">
<link href="https://osmand.net/img/logo.png" />
</wpt>
Tags de dados do sensor
Você pode enriquecer suas trilhas com dados de sensores de fitness, como monitores de frequência cardíaca ou sensores de temperatura. O OsmAnd usa o esquema TrackPointExtension da Garmin para armazenar esses dados, tornando-o compatível com plataformas como Strava e Garmin Basecamp.
Tags de dados do sensor suportadas:
- hr - frequência cardíaca (em batimentos por minuto).
- cad - cadência da bicicleta (em rotações por minuto).
- atemp - temperatura ambiente (em graus Celsius).
- power - potência de saída da bicicleta (em watts).
Exemplo:
<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>
Detalhes do ponto da trilha
Cada <trkpt> (ponto da trilha) no arquivo GPX pode incluir atributos adicionais para capturar dados como velocidade, rumo e elevação.
Atributos suportados:
- speed - velocidade no ponto da trilha (em metros por segundo).
- heading - direção do movimento (0-359 graus).
- ele - elevação acima do nível do mar (em metros).
- time - carimbo de data/hora para o ponto da trilha.
Exemplo:
<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>
Rota(s) calculada(s)
No OsmAnd, você pode calcular uma rota e salvar todos os dados em GPX, de modo que, posteriormente, todos os recursos de navegação estarão disponíveis como navegação GPX em execução, ou seja, o GPX do OsmAnd conterá segmentos de rota, curvas, nomes de estradas, tipos de estradas, restrições, etc. A rota pode ser completamente restaurada como se tivesse acabado de ser construída, mesmo na ausência dos respectivos mapas offline.
Um arquivo gpx pode conter várias rotas. Cada uma delas está contida em um segmento específico sob trkseg / extensions. Um arquivo gpx é salvo nesta forma ao exportar uma rota construída ou ao salvar uma trilha que consiste em vários segmentos separados por meio da funcionalidade Planejar uma rota.
Planejar uma rota também adiciona um (ou vários, de acordo com o número de segmentos/trilhas separadas contidas) blocos rte ao arquivo gpx, contendo pontos-chave da rota (rtept).
Estrutura GPX:
<trk>
<trkseg>
// Lista de pontos de segmento. A ordem dos pontos corresponde à ordem e comprimento dos segmentos da rota (<route><segment length="x" ... />).
// O valor do atributo "length" corresponde ao número de pontos neste segmento da rota.
<trkpt ... ></trkpt>
<extensions>
// Lista de segmentos de rota
<route>
<segment ... />
</route>
// Propriedades dos segmentos incluídos na rota.
// Esses dados são obtidos de mapas offline durante a construção inicial de uma rota.
<types>
<type ... />
</types>
</extensions>
</trkseg>
</trk>
// Lista de pontos de rota intermediários. Se houver várias rotas, a ordem da lista rte corresponde à ordem dos segmentos da rota.
<rte>
<rtept ... />
// Para rotas construídas com o "Planejar rota", os parâmetros dos pontos-chave são salvos.
// Se rtept não for o primeiro e o último, antes dele (com o mesmo idx) trkpt estará com os mesmos dados.
<extensions>
// Tipo de perfil de rota para o próximo segmento (carro, bicicleta, pedestre, etc.).
<profile>...</profile>
// O índice do ponto no segmento gpx que corresponde ao primeiro ponto da rota calculada para este segmento.
// Se rtept não for o primeiro e o último, antes dele (com o mesmo idx) trkpt estará com os mesmos dados.
<trkpt_idx>...</trkpt_idx>
</extensions>
</rtept>
</rte>
Propriedades importantes:
- trkpt_idx do primeiro rtept em trkseg é 0. Assim, se houver dois trksegs, haverá dois rtepts com trkpt_idx = 0
- trkpt_idx do último rtept em trkseg é igual ao número de trkpts em trkseg menos 1. Por exemplo, se trkseg tiver 12 trkpts, trkpt_idx do último rtept deve ser 11
- Os segmentos de rota vizinhos se sobrepõem: o final do segmento anterior e o início do próximo segmento são o mesmo trkpt.
- Há uma exceção quando os segmentos de rota vizinhos não se sobrepõem (não compartilham o mesmo trkpt). Isso acontece quando há rtept "entre" os segmentos de rota. O final do segmento de rota anterior é um trkpt, e o início do próximo segmento de rota é outro rtept. Mas esses dois trkpts são totalmente iguais por lat, lon e outros parâmetros.
- A sobreposição de segmentos de rota pode ser detectada via length e startTrkptIdx (este último é usado apenas para conveniência de leitura humana):
- Se a soma de startTrkptIdx e length do segmento de rota anterior for igual a startTrkptIdx do próximo segmento de rota, os segmentos de rota não se sobrepõem
- Se a soma for menor em um, então os segmentos de rota se sobrepõem
- Pode haver segmentos de rota retos. Eles são marcados com id="-1". Eles podem aparecer em dois casos:
- É uma rota multiprofilada, e o usuário selecionou linha reta
- O usuário colocou rtept muito longe da estrada mais próxima, então o osmand fez uma linha reta entre rtept e a estrada
- trkpts = length - (segments - 1) + (rtepts - 2), onde:
- trkpts - quantidade de trkpts dentro de trkseg
- length - soma de todos os lengths dos segmentos de rota dentro de trkseg
- segments - quantidade de segmentos de rota dentro de trkseg
- rtepts - quantidade de rtepts pertencentes a trkseg
Exemplo:
<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>
Coleções GPX em OBF
O OsmAnd permite converter vários arquivos GPX em um único arquivo OBF. Isso possibilita o armazenamento de milhares de trilhas GPX em um formato compacto e otimizado, mantendo recursos como ícones de mapa especiais, personalização da aparência da trilha e funcionalidade de pesquisa. Isso evita um limite de arquivos GPX locais grandes que normalmente não conseguem lidar com mais de 500 mil pontos no total, no entanto, alguns recursos das trilhas GPX podem estar ausentes em comparação com a exibição do arquivo OBF.
Etapas para converter GPX para OBF:
-
Faça login no Mapa Web do OsmAnd *→ Trilhas → Selecione uma pasta → Menu (⋮) → Baixar como coleção OBF
-
O arquivo
<.obf>resultante pode ser importado para o OsmAnd (requer OsmAnd Android 5.0+).
Estilo da linha da trilha
Personalize as linhas da trilha com as seguintes tags:
| Tag GPX | Padrão | Finalidade |
|---|---|---|
<name> | (nenhum) | Nome exibido sobre a linha da trilha. |
color | red | Cor primária (HEX ou texto). |
colour, displaycolor | (nenhum) | Maneiras alternativas de substituir color. |
shield_waycolor | (nenhum) | Substituição para color da linha da trilha do escudo. |
translucent_line_colors | no | Defina como yes para cores semi-transparentes. |
width | thin | Largura da linha: "thin" (fina), "medium" (média), "bold" (grossa), "1-24", ou "roadstyle" (estilo de estrada) |
Cores suportadas: preto, azul, marrom, amarelo escuro, cinza, verde, azul claro, verde claro, laranja, roxo, vermelho, branco, amarelo.
Exemplo:
<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>
Escudos de linha de trilha
Escudos são ícones ou símbolos exibidos ao longo da linha da trilha. O OsmAnd suporta escudos no estilo OSMC-symbol-style, que podem incluir:
- Ícone de fundo - a forma principal (por exemplo, círculo ou quadrado).
- Ícones de primeiro plano - até dois símbolos menores sobrepostos ao fundo.
- Texto - descrições curtas ou identificadores, derivados das tags
shield_textouref.
Se nenhuma propriedade de escudo for definida, o OsmAnd usa um escudo amarelo de tamanho automático para a trilha.
Tags para escudos:
| Tag GPX | Finalidade |
|---|---|
shield_bg | Define o ícone de fundo para o escudo. |
shield_fg | Especifica o primeiro ícone de primeiro plano (por exemplo, uma seta ou ponto). |
shield_fg_2 | Especifica o segundo ícone de primeiro plano (opcional). |
shield_text | Define o texto curto a ser exibido sobre o escudo (por exemplo, ref da rota). |
shield_textcolor | Determina a cor do texto do escudo (opcional). |
shield_waycolor | Substitui a cor padrão da trilha para a linha do escudo (opcional). |
ref | Usado como texto de fallback se shield_text não for fornecido. |
Exemplo:
<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>
Exibição de pontos de passagem
Os ícones de pontos de passagem podem ser personalizados com as seguintes tags:
| Tag GPX | Padrão | Finalidade |
|---|---|---|
icon | (nenhum) | Especifica o ícone para o ponto de passagem (usa ícones padrão do editor de pontos de passagem do OsmAnd). |
color | red | Define a cor do ícone usando um código HEX (por exemplo, #ffaa00) ou um nome de cor suportado (opções limitadas). |
background | circle | Define a forma do ícone. Valores suportados: circle (círculo), square (quadrado), octagon (octógono). |
Comportamento das formas de background:
circle- exibe o ícone com um fundo circular.square- exibe o ícone com um fundo quadrado, padrão para vermelho se nenhuma cor for especificada.octagon- tratado como um fundo circular no OsmAnd.
Cores suportadas para background=circle: azul, cinza, verde, azul claro, verde claro, laranja, roxo, amarelo.
Aprimoramentos com elementos adicionais:
- Você pode adicionar descrições formatadas a pontos de passagem usando código HTML. Isso permite incluir texto estilizado, links ou até mesmo imagens.
- Os pontos de passagem podem exibir imagens vinculadas usando Link-as-Image.
Exemplo:
<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>
Pesquisar por nome e referências
Trilhas e pontos de passagem podem ser localizados usando uma variedade de tags GPX.
| Tag GPX | Localização | Finalidade |
|---|---|---|
<name> | <metadata> | O nome principal da trilha GPX. |
ref | <extensions> GPX | Um identificador curto, frequentemente derivado da tag ref do OSM. |
shield_text | <extensions> GPX | Texto exibido em escudos (também pode ser usado com ref). |
name_-_lang | <extensions> GPX/WPT | name:lang localizado (por exemplo, name_-_en para inglês, substitua : -> _-_) |
<name> | <wpt> | O nome do ponto de passagem. |
Exemplo:
<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>
Pesquisar por tipo de atividade
O OsmAnd organiza as trilhas em arquivos OBF em Grupos de Atividade e Tipos de Atividade. Essas classificações ajudam você a filtrar trilhas como POIs ou criar filtros de pesquisa baseados em atividades.
Como os tipos de atividade funcionam:
- Os tipos e grupos de atividade são determinados usando o
"id"e as"tags"do arquivo activities.json. - O OsmAnd usa as tags
osmand:activityouosmand:routepara classificar atividades em arquivos GPX.
| Tag GPX | Localização | Finalidade |
|---|---|---|
osmand:activity | <metadata> | Tag principal do OsmAnd para armazenar o tipo de atividade (ID). |
osmand:route | <extensions> GPX | Maneira alternativa do OSM para definir o tipo de atividade. |
Exemplos de organização de trilhas por tipo de atividade:
-
Isso classificará a trilha no grupo Motociclismo com o tipo Motociclismo Off-Road (Trilha).
<metadata>
<extensions>
<osmand:activity>off_road_motorcycling_dirt_biking</osmand:activity>
</extensions>
</metadata> -
Isso organizará a trilha no grupo Ciclismo com o tipo Mountain Biking.
<gpx>
<extensions>
<osmand:route>mtb</osmand:route>
</extensions>
</gpx>
Tags de informações de pesquisa
Os arquivos OBF geram e armazenam automaticamente estatísticas e análises críticas da trilha.
| Tag OBF | Finalidade |
|---|---|
distance | Distância total percorrida por todos os segmentos da trilha. |
start_ele, ele_graph | Dados de elevação do GPX, encapsulados em um array binário compacto. |
min_ele, avg_ele, max_ele | Análise de elevação mínima, média e máxima. |
diff_ele_up, diff_ele_down | Ganho e perda total de elevação ao longo da trilha. |
max_speed, avg_speed, min_speed | Análise de velocidade da trilha, incluindo velocidade máxima, média e mínima. |
time_span, time_span_no_gaps | Tempo total da trilha, com e sem contabilizar lacunas. |
time_moving, time_moving_no_gaps | Tempo total em movimento, com e sem contabilizar lacunas. |
Tags internas
Algumas tags GPX são usadas ou armazenadas indiretamente em arquivos OBF. Consulte OsmGpxWriteContext.java para obter detalhes sobre a implementação.
| Tag OBF | Finalidade |
|---|---|
route_id | Um identificador exclusivo para o arquivo GPX, vinculando dados de mapa e POI (formato: /[A-Z]+[0-9]+/ por exemplo, OSM12345). |
route_type | Identificador de grupo de atividade (id) derivado de poi/activities.json |
route_activity_type | Identificador de tipo de atividade (dentro do grupo) (id) derivado de poi/activities.json |
name, ref, description | Atributos localizáveis e pesquisáveis (lang="true" em tipos de POI) |
filename | O nome do arquivo GPX original usado para gerar esta trilha. |
track_color | Cor da trilha da seção do mapa derivada de shield_waycolor, color, colour ou displaycolor |
extensions_extra_tags | Tags extras arbitrárias para <gpx><extensions> no formato JSON. |
metadata_extra_tags | Tags extras arbitrárias para <metadata><extensions> no formato JSON. |
wpt_extra_tags | Tags extras arbitrárias para pontos de passagem <wpt><extensions> no formato JSON. |
route_track_point | Pontos de passagem do arquivo GPX usam este tipo em dados de POI. |
route_bbox_radius | Especifica o raio padrão para pesquisar partes da trilha dentro da seção POI |
route_shortlink_tiles | Especifica uma lista separada por vírgulas de blocos OSM Shortlink para acelerar a leitura de dados de geometria (opcional) |
route_segment_index | Especifica um número ordinal do segmento de geometria que está vinculado a este ponto (opcional) |
route_name | O nome da rota, usado por searchPoiByName interno (obsoleto) |
Última atualização: Março de 2025