Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Cartes statiques **Note** Les cartes statiques ne prennent en charge que les styles Standard et Satellite. Pour de plus amples informations, veuillez consulter [AWS styles et fonctionnalités de carte](map-styles.md). Les cartes statiques offrent une représentation pré-rendue des données géographiques avec la possibilité de superposer des marqueurs (ou épingles), des itinéraires et des zones polygonales, selon les besoins de votre application. La carte statique vous permet de générer des images cartographiques statiques (non interactives) en fonction de paramètres personnalisables et d'entrées de données. En personnalisant les superpositions, les formes ou en appliquant des styles personnalisés, Static Map vous permet de créer des visualisations cartographiques qui répondent à des besoins spécifiques, d'améliorer l'expérience de l'utilisateur final et de communiquer efficacement les informations géographiques. Le serveur personnalise les images cartographiques demandées et les fournit au client sous forme de fichiers JPEG. Vous pouvez demander et générer par programmation des images cartographiques adaptées à vos besoins spécifiques. L'*GetStaticMap API* génère une image statique d'une carte en fonction de paramètres spécifiés tels que les coordonnées du centre, les cadres de délimitation ou les superpositions. L'API permet de personnaliser les caractéristiques et le style des cartes, ce qui permet de les utiliser dans des applications Web ou mobiles sans fonctionnalité cartographique interactive. Pour plus d'informations, consultez [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)le manuel *Amazon Location Service API Reference*. Pour des exemples de requêtes, de réponses, de cURL et de commandes CLI pour cette API, reportez-vous à la section [Comment utiliser les cartes statiques](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html). ## Cas d’utilisation courants + **Cartes intégrées dans une application Web ou mobile :** les images de cartes statiques peuvent être intégrées efficacement dans des sites Web ou des applications mobiles pour fournir des visualisations de lieux, d'itinéraires ou de points d'intérêt à l'aide de cartes non interactives, réduisant ainsi les temps de chargement et l'utilisation des données. Les moteurs de recherche (tels que Yahoo) affichent des images cartographiques avec des résultats de recherche pour POIs. + **Informations de localisation dans les e-mails :** les images cartographiques statiques peuvent être utilisées pour partager des informations de localisation par e-mail afin d'aider vos utilisateurs finaux à comprendre le contexte de l'e-mail. Par exemple, les applications de livraison de nourriture ou de covoiturage utilisent des images cartographiques statiques pour afficher les lieux de prise en charge/dépôt, les itinéraires ou les zones environnantes dans des e-mails de livraison ou de livraison contenant une facture et un résumé après le voyage. + **Supports marketing et documents imprimés :** Des images cartographiques statiques personnalisées peuvent être incorporées dans des brochures, des dépliants ou d'autres supports imprimés, fournissant ainsi des représentations visuellement attrayantes des informations géographiques pertinentes au contenu. ## Comprendre la demande La demande inclut des paramètres d'URI facultatifs `BoundedPositions``BoundingBox`, tels que`Center`, et, entre autres, pour définir la zone visible et les superpositions de la carte. Les paramètres `Height` et `Width` sont nécessaires pour définir la taille de l'image. Pour en savoir plus, consultez [Personnaliser les cartes statiques](customizing-static-maps.md) et [Superposition sur la carte statique](overlaying-static-map.md). + `BoundedPositions`: coordonnées à inclure dans l'image. + `BoundingBox`: coordonnées définissant les bords sud-ouest et nord-est de la carte. + `Height`: Spécifie la hauteur de l'image. + `Width`: Spécifie la largeur de l'image. + `GeoJsonOverlay`: un objet GeoJSON valide pour ajouter des superpositions. ## Comprendre la réponse La réponse contient des en-têtes tels que `CacheControl` `ContentType``ETag`, et renvoie la carte statique sous forme de blob binaire au format JPEG ou PNG. Les en-têtes fournissent des métadonnées telles que le contrôle du cache, le type de contenu et la version pour les images statiques. + `CacheControl`: Spécifie les configurations de mise en cache pour l'image cartographique. + `ContentType`: indique le format de l'image cartographique (JPEG ou PNG). + `ETag`: identifiant de la version de l'image cartographique statique. + `Blob`: représente l'image cartographique au format JPEG ou PNG. # Personnaliser les cartes statiques **Note** Les cartes statiques ne prennent en charge que le style Satellite. Pour de plus amples informations, veuillez consulter [AWS styles et fonctionnalités de carte](map-styles.md). Cette section explique comment personnaliser les cartes statiques générées à l'aide d'Amazon Location Service. Il couvre diverses fonctionnalités, telles que le réglage de la position, de la taille, de la langue, de l'échelle, des superpositions et de l'attribution de la carte, ce qui vous permet d'adapter la carte à vos besoins spécifiques. Pour plus d'informations, consultez [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)le manuel *Amazon Location Service API Reference*. ## Position La position permet de définir le centre et les limites de la carte. Vous pouvez contrôler le focus de la carte en définissant les coordonnées du centre, un cadre de délimitation ou en utilisant un niveau de zoom pour déterminer la surface à afficher. Pour savoir comment cela fonctionne, voir[Comment obtenir une carte statique d'une position spécifique](get-static-map-specific-position.md). + `Center`: définit le point central de la carte à l'aide des coordonnées de longitude et de latitude. + `Radius`: Spécifie le rayon (distance par rapport au centre) qui sera affiché sur la carte statique. + `Bounding Box`: définit une zone rectangulaire de la carte, définie en fournissant les coordonnées des coins supérieur gauche et inférieur droit. + `Zoom`: Contrôle le niveau de zoom de la carte. Les niveaux de zoom élevés affichent plus de détails dans une zone plus petite, tandis que les niveaux de zoom inférieurs montrent moins de détails sur une zone plus grande. ## Dimension et qualité Vous pouvez personnaliser la taille et la qualité visuelle de la carte statique en définissant ses dimensions (hauteur et largeur) et en ajoutant du rembourrage pour une meilleure présentation des marqueurs et autres éléments. Pour savoir comment cela fonctionne, voir[Comment obtenir une carte statique d'une dimension spécifique](get-static-map-specific-dimension.md). + `Height and Width`: Spécifie la taille de l'image cartographique statique en définissant sa hauteur et sa largeur en pixels. + `Padding`: ajoute de l'espace sur les bords de la carte, ce qui permet une meilleure visualisation lors du placement de marqueurs, de lignes ou de formes. ## Échelle L'échelle permet de contrôler l'échelle de la carte et définit les unités (kilomètres, miles) pour mesurer les distances. Cela est utile pour représenter avec précision la taille de la carte et les relations de distance. Pour savoir comment cela fonctionne, voir[Comment ajouter de l'échelle à une carte statique](add-scale-static-map.md). + `Scale Unit`: définit les unités de la barre d'échelle de la carte (par exemple, les kilomètres ou les miles), permettant aux utilisateurs d'évaluer avec précision les distances sur la carte. ## Superposition Vous pouvez ajouter des marqueurs, des lignes pour afficher les itinéraires, des polygones pour afficher les zones, etc. Pour savoir comment cela fonctionne, voir [Comment ajouter un marqueur sur une carte statique](add-marker-static-map.md)[Comment ajouter une ligne à une carte statique](how-to-add-line-static.md), ou[Comment ajouter un itinéraire à une carte statique](how-to-add-route.md). # Superposition sur la carte statique Cette section explique comment superposer des informations supplémentaires sur des cartes statiques à l'aide d'Amazon Location Service. Vous pouvez personnaliser vos cartes statiques en ajoutant diverses caractéristiques géographiques, telles que des points, des lignes et des polygones, afin d'améliorer la représentation visuelle de la carte. Amazon Location Service prend en charge plusieurs formats, notamment GeoJSON et un format de superposition compact, afin de fournir des méthodes flexibles et efficaces pour ajouter des superpositions. Pour plus d'informations, consultez [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)le manuel *Amazon Location Service API Reference*. ## Avec GeoJSON GeoJSON est un format polyvalent qui vous permet de superposer des données personnalisées sur des cartes statiques. En définissant des caractéristiques géographiques telles que des points, des lignes et des polygones, vous pouvez améliorer la représentation visuelle de vos cartes, fournissant ainsi un contexte précieux aux utilisateurs. GeoJSON est largement pris en charge et offre de la flexibilité lorsqu'il s'agit de styliser et de personnaliser les superpositions de cartes, ce qui en fait un format idéal pour afficher des régions, tracer des itinéraires ou montrer des relations spatiales. Avec Amazon Location Service, vous pouvez utiliser GeoJSON pour ajouter des fonctionnalités dynamiques basées sur la localisation directement sur vos cartes statiques. Cela vous permet de créer des superpositions hautement personnalisables qui peuvent être adaptées aux besoins spécifiques de votre entreprise. GeoJSON prend en charge plusieurs types de géométrie, notamment`Point`, et `LineString` `Polygon``MultiPolygon`, ce qui vous permet d'afficher un large éventail d'entités, des marqueurs aux itinéraires en passant par les représentations de zones complexes. ## Couleurs Lorsque vous stylisez des entités GeoJSON, vous pouvez définir les couleurs de manière flexible. Vous pouvez spécifier les couleurs en utilisant différents formats, tels que des valeurs hexadécimales (comme \$1ff0000 pour le rouge) ou avec une transparence alpha (comme \$1ff000080 pour un rouge semi-transparent). Cela garantit que vos superpositions peuvent être visuellement cohérentes avec le style de la carte. Si aucune couleur n'est spécifiée, la couleur par défaut du style de carte sélectionné sera appliquée. ## Ordre de dessin Les superpositions personnalisées sont dessinées dans un ordre précis afin de maintenir la clarté et d'éviter l'encombrement visuel. Dans Amazon Location Service, les entités de superposition telles que les polygones, les lignes et les points apparaîtront au-dessus de la carte de base, mais sous les étiquettes de la carte. L'ordre de dessin donne d'abord la priorité aux polygones, puis aux lignes, puis aux points ou aux marqueurs. ## Unités de mesure Pour les propriétés telles que `width` et`outline-width`, vous pouvez utiliser différentes unités de mesure pour définir la taille, notamment les pixels (px), les mètres (m), les kilomètres (km), les miles (mi) et les pourcentages (%). L'unité de pourcentage ajuste la propriété par rapport à une valeur par défaut, offrant ainsi une plus grande flexibilité dans le style de vos superpositions. ## Types de géométrie Amazon Location Service prend en charge plusieurs types de géométrie GeoJSON, tels que`Point`, `LineString``Polygon`, et. `MultiPolygon` Chaque type de géométrie peut être stylisé et ajusté à l'aide de l'objet properties dans GeoJSON, ce qui permet une personnalisation étendue des marqueurs, des itinéraires et des zones de votre carte. ## Avec revêtement compact **Note** La superposition compacte prend en charge les types de géométrie suivants : point, ligne et polygone. Cela ne prend pas en charge `multiPoint``multiLine`, ou`multiPolgyon`. L'option de superposition compacte vous permet d'afficher efficacement plusieurs géométries sur une carte statique en utilisant un seul paramètre de requête. Cette approche rationalisée simplifie le format des demandes et réduit leur taille, facilitant ainsi la transmission de données superposées. Les clients peuvent saisir différents types de géométrie et leurs propriétés de style correspondantes dans un seul paramètre de requête, et Amazon Location Service se chargera du gros du travail en analysant et en affichant la superposition comme indiqué. Lorsque vous utilisez le format de superposition compact, gardez à l'esprit que la taille de l'URL de demande est limitée. Bien qu'Amazon Location Service optimise la requête, veillez à ce que votre demande reste dans des limites raisonnables, en particulier lorsqu'il s'agit de plusieurs géométries et de leurs propriétés associées. ## Format Le format de superposition compact est structuré comme suit : `geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...` Chaque type de géométrie est défini avec ses propriétés de style. Plusieurs géométries sont séparées par un opérateur de tube (\$1), et les propriétés de chaque géométrie sont séparées par un point-virgule. ## Types de géométrie pris en charge Amazon Location Service prend en charge plusieurs types de géométries `Point``MultiPoint`, notamment`LineString`,`Polygon`,, et`MultiPolygon`. Ces types de géométrie peuvent être combinés et stylisés dans le même paramètre de requête à l'aide du format de superposition compact. ## Propriétés coiffantes Chaque géométrie peut être personnalisée à l'aide de différentes propriétés de style, telles que la couleur, la couleur du contour, la taille, etc. Ces propriétés vous permettent de contrôler l'apparence de chaque géométrie sur la carte, en veillant à ce que la superposition corresponde aux exigences de votre entreprise.