Afficher une carte nommée selon la vue centre et zoom
Description
Renvoie une image d'une carte au format défini à un emplacement et un niveau de zoom définis.
Format d'URL GET HTTP
Les requêtes GET HTTP se présentent au format suivant :
HTTP GET /maps/map name/image.image type;w=width;h=height;c=x,y,srs;
z=zoom;[r=resolution]/
Paramètres
Pour plus d'informations sur les types de paramètres répertoriés ci-dessous, reportez-vous à la section Types de données d'URL de requête.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| map name | Chaîne | oui | Nom de la carte à afficher. La carte est définie par une balise RegEx pour la carte nommée à afficher basée sur l'emplacement de la carte nommée dans le référentiel. Le nom de la carte nommée est défini entre la portion /maps de l'URL et la portion /image.image type de l'URL. Par exemple, pour afficher une carte nommée se trouvant à l'emplacement /earth/Europe du référentiel, l'URL suivante est utilisée : http://.../maps/earth/Europe/image.png;... |
| image type | Chaîne | oui | Type d'image à renvoyer (gif, png, jpg, bmp, jpeg ou tiff) |
| w=width | Entier | oui | Largeur de l'image en pixels. |
| h=height | Entier | oui | Hauteur de l'image en pixels. |
| c=x, y, srs | Double, Double, Chaîne | oui | Centre de la vue sous forme de coordonnées géographiques constituées des positions x, y et du nom SRS (Spatial Reference System – Système de référence spatiale). |
| z=zoom | Entier, Chaîne | oui | Zoom ou distance sur la vue en unités linéaires. Le zoom est représenté par une chaîne comportant un nombre, suivi d'un ou de plusieurs espaces, suivis d'une abréviation d'unité linéaire (par exemple, mi, km, m, etc.). |
| r=resolution | Entier | non | Résolution PPP de la carte sous forme d'entier. PPP mesure la résolution des images de carte en points par pouce (nombre de points individuels qui peuvent être placés sur un pouce linéaire). Si ces paramètres ne sont pas précisés, les paramètres du serveur par défaut sont utilisés. |
| bc=background color | Chaîne | non | Couleur de l'arrière-plan à utiliser pour l'image de la carte, exprimée au format RRGGBB. Si aucune valeur n'est fournie, la couleur de l'arrière-plan sera transparente. Remarque : Contrairement à l'API SOAP, le caractère # ne doit pas précéder la couleur Web hexadécimale.
|
| bo=background opacity | Double | non |
Opacité de la couleur de l'arrière-plan. Si les attributs background et backgroundOpacity sont spécifiés, ces valeurs seront utilisées pour dessiner l'arrière-plan. Si l'arrière-plan n'est pas utilisé, il sera totalement transparent indépendamment de l'attribut backgroundOpacity. Si l'arrière-plan est utilisé, mais qu'aucune opacité n'est spécifiée, alors l'arrière-plan sera totalement opaque. |
Résultat
Renvoie une image au format défini.
Exemple
Affiche une carte nommée aux format PNG aux dimensions de 640 x 480 pixels ; la carte est centrée à (-2,5, 38,5) au format WGS 84, la vue se déploie sur 500 miles, la résolution PPP est de 96.
GET http://<server>:<port>/rest/Spatial/MappingService/maps/Samples/NamedMaps/WorldMap/image.png;w=640;h=480;c=-2.5,38.5,epsg:4326;z=500%20mi;r=96
Content-type: application/json
Authorization: <Basic or Spectrum Token>