Knowledge Base

Diese Seite ist schreibgeschützt. Sie können die Quelle anzeigen, aber nicht ändern. Fragen Sie Ihren Administrator, wenn Sie denken, dass dies falsch ist.
====== Benutzerdefinierte Online-Karten ====== ---- ===== Grundlegende Informationen ===== * **XML-Datei** - enthält Beschreibung von Online-Kartenanbietern (mehr unten).  Name und Pfad zu dieser Datei auf der Speicherkarte (oder dem internen Speicher) ist ///CARD_ROOT/Locus/mapsOnline/custom/ .xml// (Sie können mehr als eine XML im Ordner haben, Locus Map fügt sie alle hinzu) * **PNG-Bilder (optional)** - für jeden Kartenanbieternamen.  Dieses Symbol wird nicht benötigt!  Es wird einfach neben dem Kartennamen im Kartenmanager angezeigt.  Der Name dieses Symbols sollte mit dem Text im Namensschild übereinstimmen.
 ===== Beispielkarte ===== Ein Beispiel einer OpenPiste-Karte (OSM-basiert), die aus drei Ebenen erstellt wurde: - Hintergrundebene, die in der Kartenliste nicht sichtbar, aber erforderlich ist.
 - Konturschicht, sichtbar, aber nicht wirklich erforderlich.  Wenn diese Ebene an einigen Stellen nicht sichtbar ist und der Server den 404-Code für fehlende Kacheln zurückgibt, können Sie immer noch die Hintergrundebene sehen.
 - Schattenschicht, ebenfalls nicht erforderlich.  Diese Ebene ist in der Kartenliste sichtbar - füllen Sie den korrekten "Modus" und "Bereich" aus (optional).  Der dem Header hinzugefügte Referer wird in diesem Fall nicht empfohlen.  ==== Kartencode in der Datei provider.xml ====  OSM background {z}-1.0 8 1000 0 Referer#http://locus.asamm.cz/ OSM contours {z}-1 8 8 24 Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-256 0 2.0 19 World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-1001 0 1000 8 Referer#http://locus.asamm.cz/ OSM contours {z}-8 24 256 0 Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-2.0 19 1002 0 World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-1001 2 8 8 Referer#http://locus.asamm.cz/ OSM contours {z}-24 256 0 2.0 Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-19 1000 XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ OSM background {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM contours {z}-XNUMX XNUMX XNUMX XNUMX Referer#http://locus.asamm.cz/ OSM OpenPiste {z}-XNUMX XNUMX XNUMX XNUMX World hiking,ski Referer#http://locus.asamm.cz/ ==== Angaben zur Kartendefinition ==== * **id** - erforderliche Kennung, muss größer oder gleich XNUMX sein.  Niedrigere Werte sind für Locus Map reserviert.
 * **Typ** - Typ des Kartenanbieters * **0** - Kugelmercator, Projektion Kugel, inverses Y * **1** - Kugelmercator, Projektion Kugel, normales Y * **2** - Kugelmercator , Projektion Ellipsoid, invers Y * **3** - Kugelmercator, Projektion Ellipsoid, normal Y * **4** - Kugelmercator, Projektion Kugel, Y vom Mittelpunkt * **5** - Kugelmercator, Projektion Kugel, Quadkey-Kartensystem (weitere Informationen hier: http://msdn.microsoft.com/en-us/library/bb259689.aspx) * Verwenden Sie {c} nur für den Koordinatenteil.  Es gibt keine X-, Y-, Z-Koordinaten in der URL, nur {c}!
 * **sichtbar** - Sichtbarkeit des Anbieters in der Liste * **erforderlich** - Kachel von diesem Anbieter erforderlich?  Wenn der Server 404 zurückgibt, Rest der mehrschichtigen Karte verwenden oder nicht?
 * **Hintergrund** - ID der Hintergrundebene * **Name** - Name des Anbieters * **Modus** - Kurzbeschreibung * Bereich - veraltet, nicht mehr verwendet * **url** - http://tile...  - Basis-URL für Kacheln, die sich bei Anfragen nicht ändert.  {z}/{x}/{y}-Syntax für Kacheln, wobei {x} und andere X-, Y-Koordinaten ersetzen und Zoom * **{x}** - ersetzt X-Kachel * **{y}** - ersetzt Y-Kachel * **{z}** – ersetzt die Zoomstufe, nachdem die **zoomPart**-Berechnung angewendet wurde * **{ts}** – tileScale ersetzt den Wert * **{s}** (optional) – ersetzt den Server text * **serverPart** - {s} Element kann in der Haupt-URL definiert werden.  In serverPart kann dann ein Array von Items definiert werden, die zufällig als {s} Item gesetzt werden.  Also zum Beispiel 0;1;2 und URL begann als  {z}/{x}/{y}.png]]> wird bei jedem Aufruf zufällig http://tiles0.open..., oder http://tiles1.open..., oder http://tiles2.open...\\ **ServerPart** Parameter setzen können auch durch //x, y// und Parameter in einer einfachen mathematischen Formel definiert werden:\\ ({x}+{y})%4 * **zoomPart** - {z}-8 - Syntax zur Neuberechnung des korrekten Zoomwerts für die Anfrage.  Dieser Wert ist normalerweise Zoom - minimaler Zoom, kann aber unterschiedlich sein * **zoomMin** - minimaler Zoom * **zoomMax** - maximaler Zoom * **tileSize** - Größe der Kacheln in Pixel * **tileScale** - definiert Skalierungsfaktor (multi) auf 2x, DPI auf die angewendet werden soll (dpi, 0 = alle Geräte) und Wert, der in URL ersetzt wird (//replace//, darf nicht leer sein) * **Länder** - Liste der für die Karte relevanten Länder (durch Kommas getrennt).  Diese Werte werden zum Trennen von Karten in der Registerkarte "Online-Karte" verwendet.
 * **Verwendung** - Liste möglicher Verwendungen dieser Karte (durch Kommas getrennt).  Aktuelle Optionen sind: //Aero, City, Cycle, Hiking, Nautical, Overlay, Photo, Road, Ski, Transport//.  Diese Werte werden zum Trennen von Karten in der Registerkarte "Online-Karte" verwendet.
 * **extraHeader** – zusätzliche Http-Anforderung, die der Kachelanforderung auf dem Server hinzugefügt wird.  Diese Zusatzdaten bestehen aus zwei Teilen mit der Syntax part1#part2.  Teil1 ist der Anforderungsname, Teil2 ist der Anforderungswert.  Auch dieser TAG sollte bei jedem Anbieter mehr als einmal im XML vorhanden sein.
 * **Attribution** - Kurztext, der unten auf dem Kartenbildschirm angezeigt wird.  Bitte verwenden Sie dies, wenn Sie urheberrechtlich geschützte Karten verwenden, die in ihren Nutzungsbedingungen eine Zuordnung erfordern.
 ZoomValues (zoomMin, zoomMax) müssen 2^x als gültige Zoomstufe gezählt werden.  Die ganze Welt hat also eine Kachel 256x256 px, was 2^8 bedeutet, also X = 8!.  Deshalb beginnen fast alle Karten in Locus mit zoomMin = 8, haben aber zoomPart {z} - 8.  Dies liegt daran, dass Zooms in URLs normalerweise bei 0 bis zu einem bestimmten Maximalwert beginnen.
 Diese Lösung sollte verbessert werden. Wenn Sie also Ideen haben, teilen Sie uns dies mit.  Außerdem sollte ein erfahrener Android-Entwickler in der Lage sein, einen Mechanismus zum Hinzufügen externer Anbieter über ContentProviders oder Dienste zu erstellen.
 Jetzt kennen Sie die Syntax von Anbietern, also sollten Sie Ihre benutzerdefinierten hinzufügen.  Bitte teilen Sie die Links mit anderen und genießen Sie!
 ==== Hinweise ==== * Anbieter mit demselben Namen werden zusammen gruppiert * Wenn Sie ein PNG-Symbol mit demselben Namen wie der Anbietername in ein benutzerdefiniertes Verzeichnis einfügen, wird es an den Online-Kartenbildschirm angehängt ===== So erhalten Sie die erforderlichen Informationen ===== Wir empfehlen die Verwendung des Firefox-Browsers mit der Erweiterung HttpFox: * Starten Sie den Firefox-Browser und öffnen Sie eine Webseite mit Karte.  Ein nettes Beispiel ist http://www.openstreetmap.org/.
 * Öffnen Sie HttpFox im Menü Extras oder mit SHIFT-F2.  Und drücken Sie die obere grüne Starttaste.
 * Zoomen Sie jetzt um eine Stufe und Sie sehen die Liste der Anfragen auf dem Kartenserver.  Siehe Screenshot unten.
 * Ausgewählte URL-Zeile übernehmen.  Die erforderliche URL befindet sich auf der rechten Seite. Wenn wir also den Teil mit den Koordinaten trennen, wird 12/2215/1389 als cooPart geschrieben als {z}/{x}/{y}.
 * Der Rest ist ein URL-Teil, also sieht es so aus: http://c.tile.openstreetmap.org/{c}.png.
 * Dies sind die wichtigsten Werte, die zum Hinzufügen einer Karte benötigt werden.  Tilesize ist normalerweise 256 px.  Min- und Max-Zoomwerte müssen manuell getestet werden.  Auch zoomPart ist normalerweise z-8, was bedeutet, dass Zoom 20 in Locus als 12 in der Anfrage auf dem Server bereitgestellt wird.
 {{ :manual:advanced:customization:osm_requests.png?nolink |}} Ein weiteres Beispiel für eine benutzerdefinierte Online-Karte kann die Strava Global Heatmap XML-Datei sein, die wir zusammen mit unseren Benutzern erstellt haben.  Es enthält Fahrrad- und Laufebenen und kann {{:manual:advanced:customization:strava2.providers.zip|hier >>}} heruntergeladen werden.  Entpacken Sie es einfach in das Verzeichnis Locus/mapsOnline/custom und genießen Sie es!
Knowledge Base

Benutzertools

Site-Tools
