Render - Get Map Static Image

string

Numéro de version de l’API Azure Maps. La version actuelle est 01/04/2024.

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.

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.

integer

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.

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 .

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

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

• 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

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.

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.

integer

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.

integer

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.