Render - Get Map Static Image

Service:

Maps

Version d'API:

2024-04-01

Cette API de rendu produit des vues de carte statiques et rastérisées d’une zone définie par l’utilisateur. Il convient aux applications web légères, lorsque l’expérience utilisateur souhaitée ne nécessite pas de contrôles de carte interactifs ou lorsque la bande passante est limitée. Cette API est également utile pour incorporer des cartes dans des applications en dehors du navigateur, dans les services principaux, la génération de rapports ou les applications de bureau.

Cette API inclut des paramètres pour la visualisation des données de base :

• Épingles étiquetées dans plusieurs styles.
• Rendu des types de géométrie de cercle, de chemin et de polygone.

Pour plus d’informations et des exemples détaillés, consultez Rendre des données personnalisées sur une carte raster.

Les dimensions du paramètre bbox sont limitées, en fonction du niveau de zoom. Cela garantit que l’image obtenue a un niveau de détail approprié.

Niveau de zoom	Plage de lon min	Plage maximale de Lon	Plage de lat min	Plage maximale de lats
0	56,25	360.0	30.1105585173	180.0
1	28,125	360.0	14.87468995	180.0
2	14.063	351.5625	7.4130741851	137.9576312246
3	7.03125	175.78125	3.7034501005	73.6354071932
4	3.515625	87.890625	1.8513375155	35.4776115315
5	1.7578125	43.9453125	0.925620264	17.4589959239
6	0.87890625	21.97265625	0.4628040687	8.6907788223
7	0.439453125	10.986328125	0.2314012764	4.3404320789
8	0.2197265625	5.4931640625	0.1157005434	2.1695927024
9	0.1098632812	2.7465820312	0.0578502599	1.0847183194
10	0.0549316406	1.3732910156	0.0289251285	0.5423494021
11	0.0274658203	0.6866455078	0.014462564	0.2711734813
12	0.0137329102	0.3433227539	0.007231282	0.1355865882
13	0.0068664551	0.171661377	0.003615641	0.067793275
14	0.0034332275	0.0858306885	0.0018078205	0.0338966351
15	0.0017166138	0.0429153442	0.0009039102	0.0169483173
16	0.0008583069	0.0214576721	0.0004519551	0.0084741586
17	0.0004291534	0.0107288361	0.0002259776	0.0042370793
18	0.0002145767	0.005364418	0.0001129888	0.0021185396
19	0.0001072884	0.002682209	5.64944E-05	0.0010592698
20	5.36442E-05	0.0013411045	2.82472E-05	0.0005296349

Remarque : le paramètre center ou bbox doit être fourni à l’API.

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01

Avec des paramètres facultatifs:

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId={tilesetId}&trafficLayer={trafficLayer}&zoom={zoom}&center={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
api-version	query	True	string	Numéro de version de l’API Azure Maps. La version actuelle est 01/04/2024.
bbox	query		number[]	Un cadre englobant est défini par deux latitudes et deux longitudes qui représentent les quatre côtés d’une zone rectangulaire sur la Terre. Format : 'minLon, minLat, maxLon, maxLat' (en double). Remarque : bbox ou center sont des paramètres obligatoires. Ils s’excluent mutuellement. bbox ne doit pas être utilisé avec la hauteur ou la largeur. Les plages maximale et minimale autorisée pour Lat et Lon sont définies pour chaque niveau de zoom dans le tableau en haut de cette page.
center	query		number[]	Coordonnées du point central en double. Format : 'lon,lat'. Plage de longitude : -180 à 180. Plage de latitude : -90 à 90. Remarque : center ou bbox sont des paramètres obligatoires. Ils s’excluent mutuellement.
height	query		integer int32	Hauteur de l’image obtenue en pixels. Plage comprise entre 80 et 1500. La valeur par défaut est 512. Il ne doit pas être utilisé avec bbox.
language	query		string	Langue dans laquelle les résultats de la recherche doivent être retournés. Doit être l’une des balises de langue IETF prises en charge, sans respect de la casse. Lorsque les données dans la langue spécifiée ne sont pas disponibles pour un champ spécifique, la langue par défaut est utilisée. Pour plus d’informations, consultez Langues prises en charge .
path	query		string[]	Style et emplacements du chemin d’accès (en double). Utilisez ce paramètre pour ajouter éventuellement des lignes, des polygones ou des cercles à l’image. Le style de chemin décrit l’apparence du trait et du remplissage. (Veillez à encoder correctement les valeurs url de ce paramètre, car il contiendra des caractères réservés tels que des canaux et des signes de ponctuation.) Le paramètre path est pris en charge dans la référence SKU de compte Azure Maps à partir de S1. Plusieurs instances du paramètre path permettent de spécifier plusieurs géométries avec leurs styles. Le nombre de paramètres par demande est limité à 10 et le nombre d’emplacements est limité à 100 par chemin. Pour afficher un cercle dont le rayon est de 100 mètres et le point central à 45°N de latitude et 122°O de longitude à l’aide du style par défaut, ajoutez le paramètre de chaîne de requête path=ra100||-122 45 Notez que la longitude est antérieure à la latitude. Après l’encodage d’URL, cela ressemblera à path=ra100%7C%7C-122+45 Tous les exemples ci-dessous montrent le paramètre de chemin d’accès sans encodage d’URL, pour plus de clarté. Pour afficher une ligne, séparez chaque emplacement par un caractère de canal. Par exemple, utilisez path=||-122 45|-119.5 43.2|-121.67 47.12 Un polygone est spécifié avec un chemin fermé, où le premier et le dernier points sont égaux. Par exemple, utilisez path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 La valeur de longitude pour les emplacements des lignes et des polygones peut être comprise entre -360 et 360 pour permettre le rendu des géométries traversant l’antiméridien. Modificateurs de style Vous pouvez modifier l’apparence du chemin en ajoutant des modificateurs de style. Ceux-ci sont ajoutés avant les emplacements. Les modificateurs de style ont chacun un nom à deux lettres. Ces noms abrégés sont utilisés pour réduire la longueur de l’URL. Pour modifier la couleur du plan, utilisez le modificateur de style « lc » et spécifiez la couleur à l’aide du format de couleur RVB HTML/CSS, qui est un nombre hexadécimal à six chiffres (le formulaire à trois chiffres n’est pas pris en charge). Par exemple, pour utiliser une couleur rose foncée que vous spécifieriez comme #FF1493 dans CSS, utilisez path=lcFF1493||-122 45|-119.5 43.2 Plusieurs modificateurs de style peuvent être combinés pour créer un style visuel plus complexe. lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6 Résumé du modificateur de style Modificateur Description Type Plage Lc Couleur de ligne string 000000 à FFFFFF fc Couleur de remplissage string 000000 à FFFFFF la Ligne alpha (opacité) float 0 à 1 fa Remplissage alpha (opacité) float 0 à 1 Lw Largeur de ligne int32 (0, 50] Ra Rayon de cercle (mètres) float Supérieure à 0
pins	query		string[]	Style et instances d’épingles. Utilisez ce paramètre pour ajouter éventuellement des épingles à l’image. Le style d’épingle décrit l’apparence des épingles, et les instances spécifient les coordonnées des épingles (en double) et les étiquettes facultatives pour chaque broche. (Veillez à encoder correctement les valeurs d’URL de ce paramètre, car il contiendra des caractères réservés tels que des canaux et une ponctuation.) La référence SKU S0 du compte Azure Maps ne prend en charge qu’une seule instance du paramètre pins. D’autres références SKU autorisent plusieurs instances du paramètre pins à spécifier plusieurs styles de broches. Pour afficher une punaise à la latitude 45°N et à la longitude 122°W à l’aide du style d’épingle intégré par défaut, ajoutez le paramètre de chaîne de requête pins=default||-122 45 Notez que la longitude arrive avant la latitude. Après l’encodage de l’URL, cela ressemblera à pins=default%7C%7C-122+45 Tous les exemples ci-dessous montrent le paramètre pins sans encodage d’URL, pour plus de clarté. Pour afficher une broche à plusieurs emplacements, séparez chaque emplacement avec un caractère de canal. Par exemple, utilisez pins=default||-122 45|-119.5 43.2|-121.67 47.12 La référence SKU du compte Azure Maps S0 n’autorise que cinq épingles. Les autres références SKU de compte n’ont pas cette limitation. Modificateurs de style Vous pouvez modifier l’apparence des repères en ajoutant des modificateurs de style. Ils sont ajoutés après le style, mais avant les emplacements et les étiquettes. Les modificateurs de style ont chacun un nom à deux lettres. Ces noms abrégés sont utilisés pour réduire la longueur de l’URL. Pour modifier la couleur de l’épingle, utilisez le modificateur de style « co » et spécifiez la couleur à l’aide du format de couleur RVB HTML/CSS, qui est un nombre hexadécimal à six chiffres (la forme à trois chiffres n’est pas prise en charge). Par exemple, pour utiliser une couleur rose profond que vous spécifiez comme #FF1493 dans CSS, utilisez pins=default|coFF1493||-122 45 Étiquettes pushpin Pour ajouter une étiquette aux broches, placez l’étiquette entre guillemets simples juste avant les coordonnées. Évitez d’utiliser des caractères spéciaux tels que | ou || dans l’étiquette. Par exemple, pour étiqueter trois broches avec les valeurs « 1 », « 2 » et « 3 », utilisez pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 Il existe un style d’épingle intégré appelé « none » qui n’affiche pas d’image pushpin. Vous pouvez l’utiliser si vous souhaitez afficher des étiquettes sans aucune image de broche. Par exemple, pins=none||'A'-122 45|'B'-119.5 43.2 Pour modifier la couleur des étiquettes pushpin, utilisez le modificateur de style de couleur d’étiquette « lc ». Par exemple, pour utiliser des épingles roses avec des étiquettes noires, utilisez pins=default|coFF1493|lc000000||-122 45 Pour modifier la taille des étiquettes, utilisez le modificateur de style de taille d’étiquette 'ls'. La taille de l’étiquette représente la hauteur approximative du texte de l’étiquette en pixels. Par exemple, pour augmenter la taille de l’étiquette à 12, utilisez pins=default|ls12||'A'-122 45|'B'-119 43 Les étiquettes sont centrées au niveau de la broche « ancre d’étiquette ». L’emplacement d’ancre est prédéfini pour les punaises intégrées et se trouve au centre supérieur des épingles personnalisées (voir ci-dessous). Pour remplacer l’ancre d’étiquette, utilisez le modificateur de style « la » et fournissez les coordonnées de pixels X et Y pour l’ancre. Ces coordonnées sont relatives à l’angle supérieur gauche de l’image pushpin. Les valeurs X positives déplacent l’ancre vers la droite, et les valeurs Y positives déplacent l’ancre vers le bas. Par exemple, pour positionner l’ancre d’étiquette de 10 pixels à droite et de 4 pixels au-dessus du coin supérieur gauche de l’image en épingle, utilisez pins=default|la10 -4||'A'-122 45|'B'-119 43 Épingles personnalisées Pour utiliser une image d’épingle personnalisée, utilisez le mot « custom » comme nom de style d’épingle, puis spécifiez une URL après les informations d’emplacement et d’étiquette. La taille maximale autorisée pour une image d’étiquette personnalisée est de 65 536 pixels. Utilisez deux caractères de canal pour indiquer que vous avez terminé de spécifier des emplacements et que vous démarrez l’URL. Par exemple, pins=custom||-122 45||http://contoso.com/pushpins/red.png Après l’encodage d’URL, cela ressemblerait à pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png Par défaut, les images de punaise personnalisées sont dessinées au niveau des coordonnées de l’épingle. Cela n’est généralement pas idéal, car il masque l’emplacement que vous essayez de mettre en évidence. Pour remplacer l’emplacement d’ancrage de l’image d’épingle, utilisez le modificateur de style « an ». Cela utilise le même format que le modificateur de style d’ancre d’étiquette 'la'. Par exemple, si votre image d’épingle personnalisée a le bout de l’épingle dans le coin supérieur gauche de l’image, vous pouvez définir l’ancre sur cet emplacement à l’aide de pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png Remarque : Si vous utilisez le modificateur de couleur « co » avec une image de punaise personnalisée, la couleur spécifiée remplacera les canaux RVB des pixels dans l’image, mais laissera le canal alpha (opacité) inchangé. Cela ne se fait généralement qu’avec une image personnalisée en couleur unie. Mise à l’échelle, rotation et opacité Vous pouvez augmenter ou diminuer la taille des repères, ainsi que celle de leurs étiquettes à l’aide du modificateur de style de l’échelle « sc ». Il s’agit d’une valeur supérieure à zéro. La valeur 1 représente l’échelle standard. Les valeurs supérieures à 1 agrandissent les repères tandis que les valeurs qui lui sont inférieures les diminuent. Par exemple, pour dessiner les punaises 50 % plus grandes que la normale, utilisez pins=default|sc1.5||-122 45 Vous pouvez faire pivoter les punaises et leurs étiquettes à l’aide du modificateur de style de rotation « ro ». Il s’agit d’un certain nombre de degrés de rotation dans le sens des aiguilles d’une montre. Utilisez un nombre négatif pour effectuer une rotation dans le sens inverse des aiguilles d’une montre. Par exemple, pour faire pivoter les punaises de 90 degrés dans le sens des aiguilles d’une montre et doubler leur taille, utilisez pins=default|ro90|sc2||-122 45 Vous pouvez rendre les punaises et leurs étiquettes partiellement transparentes en spécifiant le modificateur de style alpha « al ». Il s’agit d’un nombre compris entre 0 et 1 indiquant l’opacité des punaises. Zéro les rend complètement transparents (et non visibles) et 1 les rend complètement opaques (ce qui est la valeur par défaut). Par exemple, pour rendre les punaises et leurs étiquettes opaques à 67 %, utilisez pins=default|al.67||-122 45 Résumé du modificateur de style Modificateur Description Type Plage al Alpha (opacité) float 0 à 1 an Ancre d’épingler <int32, int32> * co Couleur de l’épingle string 000000 à FFFFFF la Ancre d’étiquette <int32, int32> * Lc Couleur de l’étiquette string 000000 à FFFFFF ls Taille de l’étiquette float Supérieure à 0 ro Rotation float -360 à 360 Sc Scale float Supérieure à 0 Les coordonnées X et Y peuvent se trouver n’importe où dans l’image d’épingle ou une marge autour de celle-ci. La taille de la marge est la largeur et la hauteur minimales de la broche.
tilesetId	query		TilesetId	Style de carte à retourner. Les valeurs possibles sont microsoft.base.road, microsoft.base.darkgrey et microsoft.imagery. La valeur par défaut est microsoft.base.road. Pour plus d’informations, consultez Render TilesetId.
trafficLayer	query		TrafficTilesetId	Valeur facultative, indiquant qu’aucun flux de trafic n’est superposé sur le résultat de l’image. Les valeurs possibles sont microsoft.traffic.relative.main et none. La valeur par défaut est none, ce qui indique qu’aucun flux de trafic n’est retourné. Si le tilesetId lié au trafic est fourni, retourne l’image de carte avec la couche de trafic correspondante. Pour plus d’informations, consultez Render TilesetId.
view	query		LocalizedMapView	Le paramètre View (également appelé paramètre « région utilisateur ») vous permet d’afficher les cartes correctes pour un pays/région spécifique pour les régions géopolitiquement contestées. Les différents pays/régions ont des vues différentes de ces régions, et le paramètre View permet à votre application de se conformer à l’affichage requis par le pays/la région que votre application servira. Par défaut, le paramètre View est défini sur « Unified », même si vous ne l’avez pas défini dans la requête. Il vous incombe de déterminer l'emplacement de vos utilisateurs, puis de définir correctement le paramètre Affichage correspondant à cet emplacement. Vous avez aussi la possibilité de définir le paramètre d’affichage « Vue=Auto », qui retourne les données cartographiques correspondant à l’adresse IP de la requête. Le paramètre View dans Azure Maps doit être utilisé conformément aux lois applicables, y compris celles relatives au mappage, du pays/de la région où les cartes, images et autres données et contenus tiers auxquels vous êtes autorisé à accéder via Azure Maps sont mis à disposition. Exemple : view=IN. Reportez-vous à Vues prises en charge pour plus d’informations et pour voir les vues disponibles.
width	query		integer int32	Largeur de l’image obtenue en pixels. Plage comprise entre 80 et 2000. La valeur par défaut est 512. Il ne doit pas être utilisé avec bbox.
zoom	query		integer int32	Niveau de zoom souhaité de la carte. Prise en charge de la plage de valeurs de zoom comprise entre 0 et 20 (inclus) pour tilesetId étant microsoft.base.road ou microsoft.base.darkgrey. Prise en charge de la plage de valeurs de zoom comprise entre 0 et 19 (inclus) pour tilesetId étant microsoft.imagery. La valeur par défaut est 12. Pour plus d’informations, consultez Niveaux de zoom et Grille de mosaïques.

En-tête de la demande

Nom	Obligatoire	Type	Description
x-ms-client-id		string	Spécifie quel compte est destiné à être utilisé conjointement avec le modèle de sécurité de l’ID Microsoft Entra. Il représente un ID unique pour le compte Azure Maps et peut être récupéré à partir de l’API Compte du plan de gestion Azure Maps. Pour utiliser la sécurité des ID Microsoft Entra dans Azure Maps, consultez les articles suivants pour obtenir des conseils.
Accept		MediaType	Le champ Accepter l’en-tête peut être utilisé pour spécifier des préférences concernant les types de supports de réponse. Les types de médias autorisés incluent image/jpeg et image/png. Renvoyer l’image dans image/png si l’en-tête Accepter n’est pas spécifié.

Réponses

Nom	Type	Description
200 OK	object	Cette image est retournée à partir d’un appel d’image statique get map réussi. Media Types: "image/jpeg", "image/png" En-têtes Content-Type: string
Other Status Codes	ErrorResponse	Une erreur inattendue s’est produite. Media Types: "image/jpeg", "image/png"

Sécurité

AADToken

Il s’agit des flux OAuth Microsoft Entra 2.0 . Lorsqu’il est associé au contrôle d’accès en fonction du rôle Azure , il peut être utilisé pour contrôler l’accès aux API REST Azure Maps. Les contrôles d’accès en fonction du rôle Azure sont utilisés pour désigner l’accès à un ou plusieurs comptes de ressources Ou sous-ressources Azure Maps. Tout utilisateur, groupe ou principal de service peut se voir accorder l’accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs autorisations aux API REST Azure Maps.

Pour implémenter des scénarios, nous vous recommandons d’afficher les concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour modéliser des applications via des objets capables de contrôler l’accès sur des API et des étendues spécifiques.

Notes

• Cette définition de sécurité nécessite l’utilisation de l’en-tête x-ms-client-id pour indiquer à quelle ressource Azure Maps l’application demande l’accès. Vous pouvez l’acquérir à partir de l’API de gestion Maps.

Authorization URL est spécifique à l’instance de cloud public Azure. Les clouds souverains ont des URL d’autorisation uniques et des configurations d’ID Microsoft Entra. * Le contrôle d’accès en fonction du rôle Azure est configuré à partir du plan de gestion Azure via le portail Azure, PowerShell, l’interface CLI, les SDK Azure ou les API REST. * L’utilisation du KIT de développement logiciel (SDK) web Azure Maps permet une configuration basée sur la configuration d’une application pour plusieurs cas d’usage.

• Pour plus d’informations sur la plateforme d’identités Microsoft, consultez Vue d’ensemble de la plateforme d’identités Microsoft.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Il s’agit d’une clé partagée qui est provisionnée lors de la création d’une ressource Azure Maps via le plan de gestion Azure via le portail Azure, PowerShell, l’interface CLI, les SDK Azure ou les API REST.

Avec cette clé, toute application est autorisée à accéder à toutes les API REST. En d’autres termes, celles-ci peuvent actuellement être traitées comme des clés principales du compte pour lequel elles sont émises.

Pour les applications exposées publiquement, nous vous recommandons d’utiliser l’accès de serveur à serveur des API REST Azure Maps, où cette clé peut être stockée en toute sécurité.

Type: apiKey
Dans: header

SAS Token

Il s’agit d’un jeton de signature d’accès partagé créé à partir de l’opération List SAS sur la ressource Azure Maps via le plan de gestion Azure via le portail Azure, PowerShell, l’interface CLI, les SDK Azure ou les API REST.

Avec ce jeton, toute application est autorisée à accéder avec des contrôles d’accès en fonction du rôle Azure et un contrôle de grain précis à l’expiration, au taux et aux régions d’utilisation pour le jeton particulier. En d’autres termes, le jeton SAP peut être utilisé pour permettre aux applications de contrôler l’accès de manière plus sécurisée que la clé partagée.

Pour les applications exposées publiquement, notre recommandation est de configurer une liste spécifique d’origines autorisées sur la ressource de compte Map afin de limiter les abus de rendu et de renouveler régulièrement le jeton SAP.

Type: apiKey
Dans: header

Exemples

Successful Static Image Request

Exemple de requête

HTTP

GET https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079

Exemple de réponse

Code d’état:

200

Content-Type: image/png

"{file}"

Définitions

Nom	Description
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
LocalizedMapView	Le paramètre View (également appelé paramètre « région utilisateur ») vous permet d’afficher les cartes correctes pour un pays/région spécifique pour les régions géopolitiquement contestées. Les différents pays/régions ont des vues différentes de ces régions, et le paramètre View permet à votre application de se conformer à l’affichage requis par le pays/la région que votre application servira. Par défaut, le paramètre View est défini sur « Unified », même si vous ne l’avez pas défini dans la requête. Il vous incombe de déterminer l'emplacement de vos utilisateurs, puis de définir correctement le paramètre Affichage correspondant à cet emplacement. Vous avez aussi la possibilité de définir le paramètre d’affichage « Vue=Auto », qui retourne les données cartographiques correspondant à l’adresse IP de la requête. Le paramètre View dans Azure Maps doit être utilisé conformément aux lois applicables, y compris celles relatives au mappage, du pays/de la région où les cartes, images et autres données et contenus tiers auxquels vous êtes autorisé à accéder via Azure Maps sont mis à disposition. Exemple : view=IN. Reportez-vous à Vues prises en charge pour plus d’informations et pour voir les vues disponibles.
MediaType	Le champ Accepter l’en-tête peut être utilisé pour spécifier des préférences concernant les types de supports de réponse. Les types de médias autorisés incluent image/jpeg et image/png. Renvoyer l’image dans image/png si l’en-tête Accepter n’est pas spécifié.
TilesetId	Style de carte à retourner. Les valeurs possibles sont microsoft.base.road, microsoft.base.darkgrey et microsoft.imagery. La valeur par défaut est microsoft.base.road. Pour plus d’informations, consultez Render TilesetId.
TrafficTilesetId	Valeur facultative, indiquant qu’aucun flux de trafic n’est superposé sur le résultat de l’image. Les valeurs possibles sont microsoft.traffic.relative.main et none. La valeur par défaut est none, ce qui indique qu’aucun flux de trafic n’est retourné. Si le tilesetId lié au trafic est fourni, retourne l’image de carte avec la couche de trafic correspondante. Pour plus d’informations, consultez Render TilesetId.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

LocalizedMapView

Le paramètre View (également appelé paramètre « région utilisateur ») vous permet d’afficher les cartes correctes pour un pays/région spécifique pour les régions géopolitiquement contestées. Les différents pays/régions ont des vues différentes de ces régions, et le paramètre View permet à votre application de se conformer à l’affichage requis par le pays/la région que votre application servira. Par défaut, le paramètre View est défini sur « Unified », même si vous ne l’avez pas défini dans la requête. Il vous incombe de déterminer l'emplacement de vos utilisateurs, puis de définir correctement le paramètre Affichage correspondant à cet emplacement. Vous avez aussi la possibilité de définir le paramètre d’affichage « Vue=Auto », qui retourne les données cartographiques correspondant à l’adresse IP de la requête. Le paramètre View dans Azure Maps doit être utilisé conformément aux lois applicables, y compris celles relatives au mappage, du pays/de la région où les cartes, images et autres données et contenus tiers auxquels vous êtes autorisé à accéder via Azure Maps sont mis à disposition. Exemple : view=IN.

Reportez-vous à Vues prises en charge pour plus d’informations et pour voir les vues disponibles.

Nom	Type	Description
AE	string	Émirats Arabes Unis (affichage arabe)
AR	string	Argentine (affichage argentin)
Auto	string	Retourne les données cartographiques correspondant à l’adresse IP de la requête.
BH	string	Bahreïn (affichage arabe)
IN	string	Inde (affichage indien)
IQ	string	Irak (affichage arabe)
JO	string	Jordanie (affichage arabe)
KW	string	Koweït (affichage arabe)
LB	string	Liban (affichage arabe)
MA	string	Maroc (affichage marocain)
OM	string	Oman (affichage arabe)
PK	string	Pakistan (affichage pakistanais)
PS	string	Autorité palestinienne (affichage arabe)
QA	string	Qatar (affichage arabe)
SA	string	Arabie Saoudite (affichage arabe)
SY	string	Syrie (affichage arabe)
Unified	string	Affichage unifié (Autres)
YE	string	Yémen (affichage arabe)

MediaType

Le champ Accepter l’en-tête peut être utilisé pour spécifier des préférences concernant les types de supports de réponse. Les types de médias autorisés incluent image/jpeg et image/png. Renvoyer l’image dans image/png si l’en-tête Accepter n’est pas spécifié.

Nom	Type	Description
image/jpeg	string	Renvoyer l’image au format jpeg.
image/png	string	Renvoyer l’image au format png.

TilesetId

Style de carte à retourner. Les valeurs possibles sont microsoft.base.road, microsoft.base.darkgrey et microsoft.imagery. La valeur par défaut est microsoft.base.road. Pour plus d’informations, consultez Render TilesetId.

Nom	Type	Description
microsoft.base.darkgrey	string	TilesetId contient toutes les couches avec notre style gris foncé.
microsoft.base.road	string	TilesetId contient tous les calques avec le style principal de rendu.
microsoft.imagery	string	TilesetId contient une combinaison d’images satellite et aérienne.

TrafficTilesetId

Valeur facultative, indiquant qu’aucun flux de trafic n’est superposé sur le résultat de l’image. Les valeurs possibles sont microsoft.traffic.relative.main et none. La valeur par défaut est none, ce qui indique qu’aucun flux de trafic n’est retourné. Si le tilesetId lié au trafic est fourni, retourne l’image de carte avec la couche de trafic correspondante. Pour plus d’informations, consultez Render TilesetId.

Nom	Type	Description
microsoft.traffic.relative.main	string	TilesetId lié au trafic pris en charge.
none	string	Valeur par défaut, aucune superposition de flux de trafic.