Pacchetto personalizzato
Panoramica
Nell'applicazione OsmAnd, puoi creare molte personalizzazioni ed esportarle in un file .osf. Dopo aver aggiunto una descrizione, un'immagine e un'icona, queste personalizzazioni diventano un plugin completamente indipendente. Questo plugin può includere:
- Tutte le Impostazioni del profilo con un nuovo profilo.
- Set specifico di azioni rapide e layout di menu per Cassetto e Menu contestuale.
- Mappa offline personalizzata all'interno del plugin o suggerita per il download.
- Tipi di routing online specifici e mappe online.
Come creare
Il file .osf è un file .zip rinominato contenente file e cartelle .json. Ad esempio, puoi scaricare i nostri file preparati da Google Drive o un plugin già pronto da questo link.
Puoi modificare i file .json utilizzando il file items.json di OsmAnd, che contiene i comandi per importare file .json, file .obf, icone e altro.
Potrebbe essere necessario leggere:
- Sul formato
.json. - Sugli editor di testo, con cui puoi aprire e modificare file in formato JSON.
- Sull'editor Sublime Text, che viene utilizzato in OsmAnd come riferimento.
- Puoi controllare il tuo codice in JSON Editor Online.
items.json
File items.json di OsmAnd.
{
"version":1,
"items":[
{
"type":"PLUGIN",
"pluginId":"test.plugin",
"version" : 1,
"icon": {
"" : "@plugin-id.png"
},
"image": {
"" :"@plugin-image.webp"
},
"name":{
"":"Test Plugin",
"ru":"Test Plugin: RU language"
},
"description":{
"":"This package is a test package and displays test information.",
"ru":"This package is a test package and displays test information. RU language."
}
},
{
"type":"RESOURCES",
"pluginId":"test.plugin",
"file":"res"
},
{
"type":"DOWNLOADS",
"pluginId":"test.plugin",
"items":[
{
"path":"test",
"name":{
"":"My offline maps",
"ru":"RU: My offline maps"
},
"icon":{
"":"ic_world_globe_dark"
},
"header-color":"#002E64",
"description":{
"text":{
"":"This package is a collection of online and offline map sources of various types.",
"ru":"RU: This package is a collection of online and offline map sources of various types."
},
"button":[
{
"":"Telegram chat OsmAnd",
"url":"https:\/\/t.me\/OsmAndMaps"
}
]
}
},
{
"scope-id":"offline-maps",
"path":"test/Waterway",
"header-color":"#002E64",
"name":{
"":"Waterway",
"ru":"RU: waterway"
},
"icon":{
"":"ic_world_globe_dark"
},
"items":[
{
"name":{
"":"Offline Waterway map SA",
"ru":"RU: Offline Waterway map SA"
},
"filename":"waterway.obf.zip",
"type":"map",
"isHidden":"true",
"timestamp":1582994500,
"containerSize":28195301,
"contentSize":28195301,
"description":{
"text":{
"":"Zoom min: 0<br />Zoom max: 19<br />Countries: SA",
"ru":"RU: Zoom min: 0<br />Zoom max: 19<br />Countries: SA"
},
"image":[
"https://drive.google.com/uc?id=16HjUHsSWNgeQI0bmuup9ohpyrg6rWkHH&export=download"
]
},
"downloadurl":"https://drive.google.com/uc?id=10iP2VZexHtHC0QLhACZ1QoEy-duNN5Wg&export=download",
"firstsubname":{
"":"Waterway",
"ru":"RU: Waterway"
},
"secondsubname":{
"":"",
"ru":""
}
}
]
}]
},
{
"type":"PROFILE",
"pluginId":"test.plugin",
"file":"bicycle_test.json",
"appMode":{
"iconColor":"RED",
"iconName":"ic_action_motorcycle_dark",
"locIcon":"BENTLEY",
"navIcon":"BENTLEY",
"order":32,
"parent":"bicycle",
"stringKey":"bicycle_test",
"userProfileName" : "Test Prof"
},
"prefs" : {
"drawer_logo": { "" : "@logo.png"},
"drawer_url" : { "" : "https://osmand.net"},
"drawer_items" : { "hidden" : ["dashboard"], "order" : ["map_markers", "my_places", "search"] },
"context_menu_items" : {},
"configure_map_items" : {},
"route_service":"OSMAND",
"renderer":"test-rendering.render.xml",
"routing_profile":"routing-test.xml/test-car"
}
},
{
"type":"FILE",
"pluginId":"test.plugin",
"subtype" : "rendering_style",
"file":"\/rendering\/test-rendering.render.xml"
},
{
"type":"FILE",
"pluginId":"test.plugin",
"subtype" : "routing_config",
"file":"\/routing\/routing-test.xml"
},
{
"type":"SUGGESTED_DOWNLOADS",
"pluginId":"test.plugin",
"comment-1" : "search-type are latlon (closest by latlon), worldregion (by boundaries if name matches worldRegion downloadName as we do for default types), by default natural order, limit finds first N elements",
"comment-2" : "predefined scope-id are @type of indexes.xml map, srtm_map, road_map, wikimap, wikivoyage, hillshade, slope, fonts, voice, depth ",
"comment-3" : "names filters ignore case by name.contains(filterName)",
"items": [{
"scope-id" : "test-downloads",
"limit" : 1,
"search-type" : "latlon"
}, {
"scope-id" : "road_map",
"names" : [
"Poland_lesser-poland_europe_2.obf.zip", "netherlands_noord-holland_europe"]
}, {
"scope-id" : "wikimap",
"search-type" : "worldregion"
}]
},
{
"type":"NAVIGATION_ICONS",
"pluginId":"test.plugin",
"items" : [{
"locationIcon": {
"" : "@bentley-car.png"
},
"locationIconId": "BENTLEY",
"navigationIcon": {
"" : "@bentley-car-moving.png"
},
"navigationIconId": "BENTLEY"
}]
},
{
"type":"QUICK_ACTIONS",
"pluginId":"test.plugin",
"items": [{
"name": "Test quick action",
"actionType": "osmbug.add",
"params": "{\"dialog\":\"false\",\"message\":\"Message\"}"
}]
},
{
"type":"POI_UI_FILTERS",
"pluginId":"test.plugin",
"items": [{
"name": "Test Search",
"filterId": "test_search",
"acceptedTypes": "{\"sustenance\":[\"bar\",\"alpine_hut\"]}"
}]
},
{
"type":"MAP_SOURCES",
"pluginId":"test.plugin",
"items": [{
"sql": false,
"name": "OsmAnd (test)",
"minZoom": 1,
"maxZoom": 19,
"url": "https:\/\/tile.osmand.net\/hd\/{0}\/{1}\/{2}.png",
"ellipsoid": false,
"inverted_y": false,
"timesupported": false,
"expire": -1,
"inversiveZoom": false,
"ext": ".png",
"tileSize": 512,
"bitDensity": 8,
"avgSize": 18000
}]
}
]
}
Tipi di importazione
Esistono molti tipi di importazione per il file items.JSON di OsmAnd. Tutti i tipi possono essere trovati qui, e questo articolo ne descrive solo alcuni.
Descrizione del plugin
Per iniziare, crei e aggiungi il tuo plugin a items.JSON. Il primo tipo di importazione è "PLUGIN". NOTA. Devi creare e aggiungere questa riga per ogni tipo "pluginId":"test.plugin", dove test.plugin è il nome del tuo pacchetto.
Immagini del plugin
Per importare le immagini delle icone del tuo plugin in OsmAnd, crea una cartella (nel nostro esempio è la cartella "res”) dove verranno archiviati i file immagine. Il nome di questo tipo è "RESOURCES".
Profili
Utilizzando il tipo "PROFILE” puoi aggiungere un profilo di navigazione per il tuo plugin. Puoi ottenere tutte le informazioni sul tuo profilo di navigazione nel file JSON esportato, dove è possibile leggere quali tipi di items.JSON sono stati aggiunti (“QUICK_ACTIONS”, “POI_UI_FILTERS”, “MAP_SOURCES” o altri). NOTA: Inizia a creare un profilo di navigazione con tutti i parametri, a tale scopo esporta i profili di navigazione e copia gli elementi necessari dal file profiles.osf (items.JSON) di navigazione al file PLUGIN.osf (items.JSON).
Download
Puoi aggiungere qualsiasi file come SQLite, OBF o font per il download utilizzando il tipo "DOWNLOADS". I tipi principali di file scaricabili possono essere trovati qui. NOTA. Il tag "isHidden":"true" (per impostazione predefinita è false) può nascondere i dati della tua mappa da Mappe e risorse di OsmAnd. In "scope-id" puoi aggiungere tutte le informazioni necessarie sull'URL del tuo file, nome, descrizione e altro.
Download suggeriti
Nel tipo "SUGGESTED_DOWNLOADS", puoi scaricare le mappe che OsmAnd offre quando si importa un nuovo plugin.
File
Nel tipo "FILE" puoi aggiungere file dalle cartelle del tuo plugin alle cartelle di OsmAnd, il cui "sottotipo" può essere trovato qui. Nell'esempio fornito, sono stati aggiunti i file routing.xml e rendering.xml. Puoi leggere come creare questi file ai link qui e qui.
Quando il file items.JSON e tutti i file nella cartella sono pronti, puoi comprimerli in un unico documento. Successivamente, il file .zip deve essere rinominato in .osf, e quindi il tuo PLUGIN.osf sarà pronto per essere aggiunto all'applicazione OsmAnd.
Esempi
Puoi dare un'occhiata ad alcuni dei plugin che gli utenti di OsmAnd hanno creato da soli:
- Plugin personalizzato The USA Maps (dati PAD-US, sentieri e strade USFS, ricreazione USFS).
- Plugin personalizzato Anygis maps.
- Plugin personalizzato Map Legend.
- UMP-PL Polonia plugin mappa personalizzato.
- Plugin personalizzato OsmAnd Rendering plugin.
- Plugin personalizzato Outdoor Explorer.
Articoli correlati
Ultimo aggiornamento: Giugno 2024