Abrufen eines Musters für einen Layer
Beschreibung
Gibt ein einzelnes Muster für einen Layer einer benannten Karte zurück, indem die Muster-URL erstellt wird. Sie enthält die benannte Karte, die Legende (Layer) und den Zeilenindex innerhalb der Karte, die Mustergröße und den MIME-Typ des Musters. Das Muster wird als tatsächliches Inline-Bild für das Muster auf dem Server zurückgegeben.
ACL-Autorisierungsfluss
Um ein einzelnes Muster für einen Layer einer benannten Karte zurückzugeben, benötigt der Benutzer (oder alle Rollen, denen er angehört) wie folgt die Ausführungsberechtigung für den benannten Layer:
- „EXECUTE“ für den Entitätstyp „Location Intelligence.Named Resources“
URL-Format von HTTP-GET-Anforderungen
Das folgende Format wird für HTTP-GET-Anforderungen verwendet:
HTTP GET /maps/map name/legends/legend index/rows/row index/swatch/widthxheight.image type;
[r=resolution]
Parameter
Weitere Informationen zu den unten aufgeführten Parametertypen finden Sie unter URL-Anforderungsdatentypen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| map name | Zeichenfolge | ja | Der Name der Karte, die das Muster zurückgeben soll. Die Karte wird durch einen Regex für die benannte Karte angegeben, um basierend auf dem Speicherort der benannten Karte in der Datenbank zu rendern. Der Name der benannten Karte wird zwischen dem „/maps“-Teil und dem „/legends“-Teil der URL definiert. Zum Rendern einer benannten Karte, die sich z. B. unter „earth/Europe“ in der Datenbank befindet, würde die folgende URL verwendet werden: |
| legend index | Ganze Zahl | ja | Die Legende zum Abrufen des Musters aus der benannten Karte. Da die meisten Karten mehrere Layer enthalten, müssen Sie angeben, in welcher Legende sich das Muster befindet. Der erste Legendeneintrag wäre der Legendenindex 0 (null). |
| row index | Ganze Zahl | ja | Die Musterposition (Zeile) innerhalb der Legende. Da einige Layer mehrere Muster innerhalb einer Legende enthalten, müssen Sie die Zeile für das spezifische Muster angeben. Der erste Mustereintrag (Zeile) in der Legende ist 0 (null). |
| width | Ganze Zahl | ja | Breite des einzelnen Legendenmusters in Pixeln |
| height | Ganze Zahl | ja | Höhe des einzelnen Legendenmusters in Pixeln |
| image type | Zeichenfolge | ja | Der Typ des Bildes, das das Muster zurückgeben soll (z. B. gif, png usw.) |
| r=Auflösung | Ganze Zahl | no | Die DPI-Auflösung des Musters als ganze Zahl. DPI misst die Auflösung der Bilder in Punkten pro Zoll (die Anzahl der einzelnen Punkte, die im Bereich von einem linearen Zoll angeordnet werden können). Ist dieser Wert nicht angegeben, wird der Serverstandard verwendet. |
Gibt zurück:
Gibt das angegebene Musterbild zurück.
Beispiel
Geben Sie das Muster für die erste Legende und die erste Zeile der benannten WorldMap-Karte zurück, die sich im Verzeichnis „/Samples/NamedMaps“ der Datenbank befindet. Das Muster ist 32 × 32 Pixel groß, im PNG-Format mit einer Auflösung von 96 DPI.
http://www.pbbi.com/rest/Spatial/MappingService/maps/Samples/NamedMaps/WorldMap/legends/0/
rows/0/swatch/32x32.png;r=96