Dies zeigt Ihnen die Unterschiede zwischen zwei Versionen der Seite.
Beide Seiten vorherige ÜberarbeitungVorherige ÜberarbeitungNächste Überarbeitung | Vorherige Überarbeitung | ||
manual:advanced:customization:online_maps [2015/05/22 14:45] - mstupka | manual:advanced:customization:online_maps [2019/07/03 16:33] (Strom) - mstupka | ||
---|---|---|---|
Linie 2: | Linie 2: | ||
---- | ---- | ||
- | <WRAP todo round center 40%>Page under re-construction</ | + | |
===== Grundlegende Informationen ===== | ===== Grundlegende Informationen ===== | ||
- | | + | * **XML file** - contains description of Online map providers (more below). Name and path to this file on storage card (or internal memory) is /// |
- | | + | * **PNG images (optional)** - for every map provider name. This icon is not required! It's just displayed next to the map name in die Karte manager. Name of this icon should be same as text in name tag. |
- | * **PNG images (optional)** - for every map provider name. This icon is not required! It's just displayed next to Karten in Online | + | |
- | ===== Beispiel | + | ===== Stichprobe |
- | Beispiel | + | A example |
- | + | ||
- | - layer is background, which is not visible in list but required. | + | |
- | - layer is contour layer, which is visible but not really required. On some places should not be this layer, so when server return 404 code for tile, you can still see background layer! | + | |
- | - layer is shade. This layer will be visible is map list, so fill correct " | + | |
+ | - background layer not visible in the map list but required. | ||
+ | - contour layer, visible but not really required. If this layer is not visible on some places and when the server returns 404 code for missing tiles you can still see background layer. | ||
+ | - shade layer, also not required. This layer is visible in the map list - fill correct " | ||
+ | Der dem Header hinzugefügte Referer wird in diesem Fall nicht empfohlen. | ||
==== Map code in providers.xml file ==== | ==== Map code in providers.xml file ==== | ||
- | |||
- | Example of OpenPiste map (OSM based) created from two layers here (in app is together with third shade layer). First layer is background, which is not visible in list but required. Second is contour layer, which is visible but not really required. On some places should not be this layer so when server return 404 code for tile, you can still see background layer! Referer added to header is not recommended in this case. It's only as example. | ||
<code xml providers.xml> | <code xml providers.xml> | ||
Linie 27: | Linie 24: | ||
< | < | ||
< | < | ||
- | < | + | < |
< | < | ||
< | < | ||
< | < | ||
< | < | ||
+ | < | ||
< | < | ||
</ | </ | ||
Linie 37: | Linie 35: | ||
< | < | ||
< | < | ||
- | < | + | < |
< | < | ||
< | < | ||
< | < | ||
< | < | ||
+ | < | ||
< | < | ||
</ | </ | ||
Linie 47: | Linie 46: | ||
< | < | ||
< | < | ||
- | < | + | < |
< | < | ||
< | < | ||
< | < | ||
< | < | ||
+ | < | ||
< | < | ||
< | < | ||
Linie 61: | Linie 61: | ||
==== Specifications of map definition ==== | ==== Specifications of map definition ==== | ||
- | * **id** - required | + | * **id** - required |
* **type** - type of map provider | * **type** - type of map provider | ||
* **0** - Spherical mercator, projection Spheric, inverse Y | * **0** - Spherical mercator, projection Spheric, inverse Y | ||
Linie 68: | Linie 68: | ||
* **3** - Spherical mercator, projection Ellipsoid, normal Y | * **3** - Spherical mercator, projection Ellipsoid, normal Y | ||
* **4** - Spherical Mercator, projection Spheric, Y from center | * **4** - Spherical Mercator, projection Spheric, Y from center | ||
- | * **5** - Spherical mercator, projection Spheric, Quadkey map system (more info http:// | + | * **5** - Spherical mercator, projection Spheric, Quadkey map system (more info hier: http:// |
* use {c} for coordinate part only. There are no X, Y, Z coordinates in URL, just {c}! | * use {c} for coordinate part only. There are no X, Y, Z coordinates in URL, just {c}! | ||
- | * **visible** - if Versorger | + | * **visible** - visibility of Anbieter ein Liste |
- | * **required** - is tile from this provider required? When server returns 404, use rest of multilayer map or not? | + | * **required** - is tile from this provider required? When server returns 404, use rest of multilayer map or not? |
* **background** - ID of background layer | * **background** - ID of background layer | ||
* **name** - name of provider | * **name** - name of provider | ||
- | * **mode** - wenig | + | * **mode** - kurz Beschreibung |
* | * | ||
- | * **url** - http:// | + | * **url** - http:// |
- | * **{x}** - ersetzen durch X tile | + | * **{x}** - ersetzt |
- | * **{y}** - ersetzen durch Y-Kachel | + | * **{y}** - ersetzt |
- | * **{z}** - ersetzen durch zoom level after angewandt | + | * **{z}** - ersetzt |
- | * **{s}** (optional) - ersetzen durch server text | + | * **{ts}** – TileScale ersetzt den Wert |
- | * **serverPart** - you can define | + | * **{s}** (optional) - ersetzt die server text |
- | * **zoomPart** - {z}-8 - syntax for neu berechnen | + | * **serverPart** - {s} item kann definiert werden |
+ | * **zoomPart** - {z}-8 - syntax for recomputing | ||
* **zoomMin** – minimaler Zoom | * **zoomMin** – minimaler Zoom | ||
* **zoomMax** – maximaler Zoom | * **zoomMax** – maximaler Zoom | ||
- | * **tileSize** - size of tiles in Pixel | + | * **tileSize** - size of tiles in Pixel |
- | * **countries** - list of countries (separated by Komma), Wobei Karte könnte genutzt werden. Diese Werte werden zum Trennen von Karten in „ | + | * **tileScale** – definiert den Skalierungsfaktor (multi) auf 2x, die anzuwendende DPI (dpi, 0 = alle Geräte) und den Wert, der in der URL ersetzt wird (// |
- | * **usage** - list of possible | + | * **countries** - list of countries (separated by Kommas) relevant for the map. These values are used for separating maps in " |
- | * **extraHeader** - extra Http request that wird sein added to tile request on server. These additional data consist of two parts with syntax part1# | + | * **usage** - list of possible |
- | * **attribution** - klein text displayed at map screen | + | * **extraHeader** - extra Http request that is hinzugefügt zu tile request on server. These additional data consist of two parts with syntax part1# |
+ | * **attribution** - kurz text displayed at der Boden von map screen. Please use this when you're using urheberrechtlich geschützt | ||
- | ZoomValues (zoomMin, zoomMax) have to be counted as valid zoom level by 2^x. So whole world have one tile 256x256 px, which means 2^8, so X = 8!. That's why almost all maps in Locus start with zoomMin = 8 but have zoomPart {z} - 8. This is because in URL, zooms usually | + | ZoomValues (zoomMin, zoomMax) have to be counted as valid zoom level by 2^x. So ganze World has one tile 256x256 px, which means 2^8, so X = 8!. That's why almost all maps in Locus start with zoomMin = 8 but have zoomPart {z} - 8. This is because in URLs zooms usually |
- | I'm sure that this solution should be improved so if you have any ideas, tell me. Ebenfalls if here will be any little bit experienced developer on android, we sollte | + | Dieser solution should be improved so if you have any ideas, tell us. Ebenfalls, ein erfahrensten |
- | Now you know syntax of providers, so you should add your custom ones. Please, share links with others and enjoy | + | Now you know syntax of providers so you should add your custom ones. Please, share links with others and enjoy! |
==== Hints ==== | ==== Hints ==== | ||
- | * providers with same name will be grouped together! | + | * providers with same name will be grouped together |
- | * if you add PNG icon into custom directory with same name as provider name, am linken Bildschirmrand. wird angehängt | + | * if you add a PNG icon into custom directory with same name as provider name, it wird angehängt |
===== How to obtain required info ===== | ===== How to obtain required info ===== | ||
- | Suggested is to use Firefox browser with extension HttpFox | + | Wir empfehlen |
- | * Start Firefox browser and open webpage with map. Nice example | + | * Start Firefox browser and open a webpage with map. Nice example |
* Open HttpFox from Tools menu or by SHIFT-F2. And press top green Start button. | * Open HttpFox from Tools menu or by SHIFT-F2. And press top green Start button. | ||
- | * Now zoom by one level and you'll see list of requests on map server. | + | * Now zoom by one level and you'll see list of requests on map server. |
- | * So I' | + | * Ausgewählte URL-Zeile übernehmen. Erforderlich |
- | * Rest will be url part, so it will look http:// | + | * the rest is url part so it will look Gefällt mir http:// |
- | * These are main values needed to add map. Tilesize is usually | + | * These are main values needed to add map. Tilesize is usually |
{{ : | {{ : | ||
+ | |||
+ | Ein weiteres Beispiel für eine benutzerdefinierte Online-Karte kann die Strava Global Heatmap XML-Datei sein, die wir gemeinsam mit unseren Benutzern erstellt haben. Es enthält Rad- und Laufebenen und kann heruntergeladen werden {{: | ||
+ | </ | ||
+ | ===== Eigener Open Map Tile Server ===== | ||
+ | ==== Deaktivierung des Karten-Download-Limits ==== | ||
+ | Wenn Sie Ihren eigenen Kartenkachelserver betreiben, müssen Sie möglicherweise das in Locus standardmäßig festgelegte **Limit zum Herunterladen von Kacheln aufheben**, um einen angemessenen Download-Verkehr pro Anwendung aufrechtzuerhalten: | ||
+ | - **Mod_headers aktivieren**: | ||
+ | - **Bearbeiten Sie die Apache-Konfigurationsdatei** (/ |