Beschreiben von benannten Layern

Beschreibung

Dieser Vorgang nutzt eine Layer-Liste als Eingabe in der Anforderung und gibt die Beschreibung dieser Layer zurück. Darin enthalten sind Tabellen, Beschriftungsquellen (benannt oder inline), Attribute, Designs und Sichtbarkeitseinschränkungen. Die Layer-Teile der sich hieraus ergebenden Antwort können in eine Kartendefinition aufgenommen werden. Diese kann anschließend in einer REST-Anforderung „Render Map“ oder „Render Map Legend“ verwendet werden.

ACL-Autorisierungsfluss

Um die Beschreibung der Layer aufzulisten, benötigt der Benutzer (oder alle Rollen, zu denen er gehört) wie folgt die Ausführungsberechtigung für die benannten Layer:

• „EXECUTE“ für den Entitätstyp „Location Intelligence.Named Resources“

URL-Format von HTTP-POST-Anforderungen

Für HTTP-POST-Anforderungen wird das folgende Format verwendet:

POST:	http://<server>:<port>/rest/Spatial/MappingService/layers.json
POST DATA:	{
                      "namedLayersList": [
			"layerPath1",
			"layerPath2"]
                 }
POST BODY: Content-Type:application/json {list of layers}

Gibt zurück:

Gibt die Metadaten der Layer zurück. Gibt eine vollständige Beschreibung der Beschriftungsquelle zurück, wenn ein Beschriftungslayer mit einer Inline-Beschriftungsquelle beschrieben wird; gibt eine Referenz zur benannten Beschriftungsquelle zurück, wenn ein Beschriftungslayer mit einer benannten Beschriftungsquelle beschrieben wird.

Beispiel

Diese Anforderung enthält eine Layer-Liste als Eingabe und kann entweder im GET- oder POST-Format erfolgen. Die Antwort enthält eine Beschreibung der Layer in der Anforderung. In diesem Fall wird nur die Beschreibung für „USALayer“ (Beschreibung, renderbar, Tabellentyp) zurückgegeben; die anderen Layer waren nicht vorhanden und gaben Fehlermeldungen zurück.

Verwenden einer POST-Anforderung:

http://<server>:<port>/rest/Spatial/MappingService/layers.json

{
"namedLayersList":[  
"/Samples/NamedLayers/USALayer",
"/Samples/NamedLayers/NonExistentLayer",
"/Samples/NamedLayers/WorldLabelLayers"]
}

Antwort:

{
  "layerDescriptions": [
    {
      "name": "/Samples/NamedLayers/USALayer",
      "layer": {
        "type": "FeatureLayer",
        "description": "USA",
        "renderable": true,
        "table": {
          "type": "NamedTable",
          "name": "/Samples/NamedTables/USA"
        },
        "namedLabelSourceRef": "/Samples/NamedLabelSources/StateNameLabelSource"
      }
    },
    {
      "name": "/Samples/NamedLayers/NonExistentLayer",
      "errorMessage": "RepositoryEx_ResourceNotFound: Resource was not found - /Samples/NamedLayers/NonExistentLayer"
    },
    {
      "name": "/Samples/NamedLayers/WorldLabelLayers",
      "layer": {
        "type": "LabelLayer",
        "description": "World Labels Layer",
        "renderable": true,
        "labelSource": [
          {
            "type": "NamedLabelSource",
            "renderable": true,
            "name": "/Samples/NamedLabelSources/WorldCountriesLabelSource"
          }
        ]
      }
    }
  ]
}