describeNamedMaps

Beschreibung

Nutzt eine Kartenliste als Eingabe in der Anforderung und gibt die Beschreibung dieser Karten zurück.

ACL-Autorisierungsfluss

Um die Beschreibung der Karten zurückzugeben, benötigt der Benutzer (oder alle Rollen, denen er angehört) wie folgt die Ausführungsberechtigung für die benannten Karten:

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

Nachrichten

In der folgenden Tabelle sind die Anforderungs- und Antwortnachrichten für den Vorgang describeNamedMaps aufgelistet.

Klicken Sie auf einen Nachrichtennamen, um mehr Informationen zu dieser Nachricht zu erhalten.

Nachricht Beschreibung
DescribeNamedMapsRequest Die Anforderungsnachricht für den Vorgang describeNamedMaps.
DescribeNamedMapsResponse Die Antwortnachricht für den Vorgang describeNamedMaps.

Beispiele

Beispiel für SOAP-Anforderung:

<?xml version="1.0"?>   
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:v1="http://www.mapinfo.com/midev/service/mapping/v1">  
   <S:Header/>  
   <S:Body>  
      <v1:DescribeNamedMapsRequest>  
        <v1:NamedMap>/Samples/NamedMaps/MapWithLayerStyle</v1:NamedMap>  
        <v1:NamedMap>/Samples/NamedMaps/USAWithGradSymLayer</v1:NamedMap>  
        <v1:NamedMap>/DoesNotExist</v1:NamedMap>  
      </v1:DescribeNamedMapsRequest>  
   </S:Body>  
</S:Envelope>
Beispiel für SOAP-Antwort:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
       <soap:Body>
              <DescribeNamedMapsResponse 
		xmlns="http://www.mapinfo.com/midev/service/mapping/v1" 
		xmlns:ns2="http://www.mapinfo.com/midev/service/mappingcommon/v1" 
		xmlns:ns3="http://www.mapinfo.com/midev/service/table/v1" 
		xmlns:ns4="http://www.mapinfo.com/midev/service/style/v1" 
		xmlns:ns5="http://www.mapinfo.com/midev/service/featurecollection/v1" 
		xmlns:ns6="http://www.mapinfo.com/midev/service/geometries/v1" 
		xmlns:ns7="http://www.mapinfo.com/midev/service/theme/v1" 
		xmlns:ns8="http://www.mapinfo.com/midev/service/common/v1" 
		xmlns:ns9="http://www.mapinfo.com/midev/service/units/v1">
                     <Map name="/Samples/NamedMaps/MapWithLayerStyle">
                           ...
                     </Map>
                     <Map name="/Samples/NamedMaps/USAWithGradSymLayer">
                           ...
                     </Map>
                     <ErrorMessages>
                           <ns8:ErrorMessage name="/DoesNotExist">
				RepositoryEx_ResourceNotFound: 
				Resource was not found - /DoesNotExist</ns8:ErrorMessage>
                     </ErrorMessages>
              </DescribeNamedMapsResponse>
       </soap:Body>
</soap:Envelope>
Beispiel für einen SOAP-Stub für Java:
package mapping.sample;

import mapping.utility.Preference;
import mapping.utility.PrintMappingResponse;

import com.mapinfo.midev.service.mapping.v1.DescribeNamedMapsRequest;
import com.mapinfo.midev.service.mapping.v1.DescribeNamedMapsResponse;
import com.mapinfo.midev.service.mapping.ws.v1.MappingServiceInterface;
import com.mapinfo.midev.service.mapping.ws.v1.ServiceException;

public class DescribeNamedMaps {
	private static DescribeNamedMapsRequest createDescribeNamedMapsRequest() throws Exception {
		DescribeNamedMapsRequest request = new DescribeNamedMapsRequest();
		request.getNamedMap().add("/Samples/NamedMaps/MapWithLayerStyle");
		request.getNamedMap().add("/Samples/NamedMaps/MapWithLayer");
		request.getNamedMap().add("/Samples/NamedMaps/USAWithGradSymLayer");
		return request;
	}

	public static void main(String[] args) {
		try {
			MappingServiceInterface mapping = Preference.getServiceinterface();
			DescribeNamedMapsRequest request = createDescribeNamedMapsRequest();
			DescribeNamedMapsResponse response = mapping.describeNamedMaps(request);
			PrintMappingResponse.printDescribeNamedMapsResponse(response);
		} catch (ServiceException se) {
			PrintMappingResponse.printError(se);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}
Beispiel für einen SOAP-Stub für .NET:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using System.ServiceModel;
using MappingSamples.MappingService;

namespace MappingSamples
{
    class DescribeNamedMaps
    {
        static void Main(string[] args)
        {
            try
            {
                // create the client to communicate to the service
                MappingServiceInterfaceClient client = Preference.getServiceInterface();

                // create the DescribeNamedMapsRequest.
                DescribeNamedMapsRequest request = createDescribeNamedMapsRequest();

                // call the describeNamedMaps function.
                DescribeNamedMapsResponse response = client.describeNamedMaps(request);
                if (response.Map == null)
                {
                    Console.WriteLine("No maps found on the server.");
                }
                else
                {
                    foreach (Map map in response.Map)
                    {
                        if (map != null)
                        {
                            Console.WriteLine("Map information:");
                            PrintUtils.printMap(map);
                            Console.WriteLine("------");
                        }
                    }
                }
            }
            catch (FaultException<MapInfoDeveloperException> ee)
            {
                String s = ee.Message;
                Console.Out.WriteLine("Service Error returned: " + s);
            }
            catch (Exception ex)
            {
                String e = ex.ToString();
                Console.Out.WriteLine("Error: " + ex.ToString());
            }
            Console.Read();
        }

        // This creates a DescribeNamedMapsRequest.
        private static DescribeNamedMapsRequest createDescribeNamedMapsRequest()
        {
            // create the DescribeNamedMapsRequest
            DescribeNamedMapsRequest req = new DescribeNamedMapsRequest();
            req.NamedMap = new string[3];
            req.NamedMap[0] = "/Samples/NamedMaps/MapWithLayerStyle";
            req.NamedMap[1] = "/Samples/NamedMaps/MapWithLayer";
            req.NamedMap[2] = "/Samples/NamedMaps/USAWithGradSymLayer"; 

            return req;
        }
    }
}