Annonce:De nouveaux styles de carte de base seront bientôt disponibles dans Google Maps Platform. Cette modification des styles de cartes inclut une nouvelle palette de couleurs par défaut, des épingles modernisées et une expérience utilisateur et une usabilité améliorées. Tous les styles de cartes seront automatiquement mis à jour en mars 2025. Pour en savoir plus sur la disponibilité et la façon de s'inscrire plus tôt, consultez Nouveau style de carte pour Google Maps Platform.

Cette page a été traduite par l'API Cloud Translation.

KML

Classe KmlLayer

Classe google.maps.KmlLayer

Un élément KmlLayer ajoute à la carte un balisage géographique à partir d'un fichier KML, KMZ ou GeoRSS hébergé sur un serveur Web accessible au public. Un objet KmlFeatureData est fourni pour chaque élément géographique lorsque vous cliquez dessus.

Cette classe étend MVCObject.

Accédez-y en appelant const {KmlLayer} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur
`KmlLayer`	`KmlLayer([opts])` Paramètres: `opts`: options `KmlLayerOptions optional` pour cette couche. Crée un `KmlLayer` qui affiche le contenu du fichier KML/KMZ (https://developers.google.com/kml/documentation/kmlreference) ou GeoRSS (http://www.georss.org) spécifié.

Méthodes
`getDefaultViewport`	`getDefaultViewport()` Paramètres:aucun Valeur renvoyée:`LatLngBounds` Obtenez la fenêtre d'affichage par défaut de la couche affichée.
`getMap`	`getMap()` Paramètres:aucun Valeur renvoyée:`Map` Obtenez la carte sur laquelle le calque KML est affiché.
`getMetadata`	`getMetadata()` Paramètres:aucun Valeur renvoyée:`KmlLayerMetadata` Récupérez les métadonnées associées à cette couche, comme indiqué dans le balisage de la couche.
`getStatus`	`getStatus()` Paramètres:aucun Valeur renvoyée:`KmlLayerStatus` Obtenez l'état de la couche, défini une fois le document demandé chargé.
`getUrl`	`getUrl()` Paramètres:aucun Valeur renvoyée:URL `string` Récupère l'URL du fichier KML affiché.
`getZIndex`	`getZIndex()` Paramètres:aucun Valeur renvoyée:`number` L'indice z. Récupère l'indice Z du calque KML.
`setMap`	`setMap(map)` Paramètres: `map`: `Map` Valeur renvoyée:aucune Affiche le calque KML sur la carte spécifiée. Si la carte est définie sur `null`, le calque est supprimé.
`setOptions`	`setOptions(options)` Paramètres: `options`: `KmlLayerOptions` Valeur renvoyée:aucune
`setUrl`	`setUrl(url)` Paramètres: `url`: `string` Valeur renvoyée:aucune Définit l'URL du fichier KML à afficher.
`setZIndex`	`setZIndex(zIndex)` Paramètres: `zIndex`: `number` Indice z à définir. Valeur renvoyée:aucune Définit l'indice Z du calque KML.
Hérité: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Événements
`click`	`function(kmlClickEvent)` Arguments: `kmlClickEvent`: `KmlMouseEvent` Cet événement se déclenche lorsqu'un utilisateur clique sur un élément de la couche.
`defaultviewport_changed`	`function()` Arguments:aucun Cet événement est déclenché lorsque la fenêtre d'affichage par défaut des calques KML a changé.
`status_changed`	`function()` Arguments:aucun Cet événement est déclenché lorsque le calque KML a fini de se charger. À ce stade, vous pouvez lire la propriété d'état pour déterminer si le calque a bien été chargé.

Interface KmlLayerOptions

Interface google.maps.KmlLayerOptions

Cet objet définit les propriétés pouvant être définies sur un objet KmlLayer.

Propriétés
`clickable optional`	Type:`boolean optional` Par défaut:`true` Si la valeur est `true`, la couche reçoit des événements de souris.
`map optional`	Type:`Map optional` Carte sur laquelle afficher le calque.
`preserveViewport optional`	Type:`boolean optional` Par défaut:`false` Si cette option est définie sur `true` ou si le centre et le zoom de la carte n'ont jamais été définis, la carte d'entrée est centrée et agrandie pour correspondre au cadre de délimitation du contenu du calque.
`screenOverlays optional`	Type:`boolean optional` Par défaut:`true` Indique si les superpositions d'écran doivent être affichées.
`suppressInfoWindows optional`	Type:`boolean optional` Supprimez l'affichage des fenêtres d'informations lorsque l'utilisateur clique sur des éléments du calque.
`url optional`	Type:`string optional` URL du document KML à afficher.
`zIndex optional`	Type:`number optional` Z-index de la couche.

Interface KmlLayerMetadata

Interface google.maps.KmlLayerMetadata

Métadonnées d'une seule couche KML, au format JSON.

Propriétés
`author`	Type:`KmlAuthor` `<atom:author>` de la couche, extrait du balisage de la couche.
`description`	Type:`string` `<description>` de la couche, extrait du balisage de la couche.
`hasScreenOverlays`	Type:`boolean` Indique si la couche comporte des superpositions d'écran.
`name`	Type:`string` `<name>` de la couche, extrait du balisage de la couche.
`snippet`	Type:`string` `<Snippet>` du calque, extrait de la balise du calque

Constantes KmlLayerStatus

Constantes google.maps.KmlLayerStatus

État renvoyé par KmlLayer une fois le chargement d'un document terminé. Spécifiez-les par valeur ou en utilisant le nom de la constante. (par exemple, 'OK' ou google.maps.KmlLayerStatus.OK).

Accédez-y en appelant const {KmlLayerStatus} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constantes
`DOCUMENT_NOT_FOUND`	Le document est introuvable. Il s'agit probablement d'une URL non valide ou du fait que le document n'est pas accessible au public.
`DOCUMENT_TOO_LARGE`	Le document dépasse les limites de taille de fichier de KmlLayer.
`FETCH_ERROR`	Impossible de récupérer le document.
`INVALID_DOCUMENT`	Le document n'est pas un fichier KML, KMZ ou GeoRSS valide.
`INVALID_REQUEST`	Le `KmlLayer` n'est pas valide.
`LIMITS_EXCEEDED`	Le document dépasse les limites d'éléments de KmlLayer.
`OK`	La couche a bien été chargée.
`TIMED_OUT`	Le document n'a pas pu être chargé dans un délai raisonnable.
`UNKNOWN`	Le document n'a pas pu être chargé pour une raison inconnue.

Interface KmlMouseEvent

Interface google.maps.KmlMouseEvent

Propriétés d'un événement de clic sur un document KML/KMZ ou GeoRSS.

Propriétés
`featureData`	Type:`KmlFeatureData` Objet `KmlFeatureData` contenant des informations sur l'élément géographique sur lequel l'utilisateur a cliqué.
`latLng`	Type:`LatLng` Position à laquelle ancrer une fenêtre d'informations sur l'élément cartographique sur lequel l'utilisateur a cliqué.
`pixelOffset`	Type:`Size` Décalage à appliquer à une fenêtre d'informations ancrée sur l'élément géographique sur lequel l'utilisateur a cliqué.

Interface KmlFeatureData

Interface google.maps.KmlFeatureData

Données d'un seul élément géographique KML au format JSON, renvoyées lorsqu'un élément géographique KML est sélectionné. Les données contenues dans cet objet reflètent celles associées à l'élément géographique dans le balisage KML ou GeoRSS dans lequel il est déclaré.

Propriétés
`author`	Type:`KmlAuthor` `<atom:author>` de l'élément géographique, extrait de la balise de calque (si spécifié).
`description`	Type:`string` `<description>` de l'élément géographique, extrait de la balise de calque.
`id`	Type:`string` `<id>` de l'élément géographique, extrait de la balise de calque. Si aucun `<id>` n'a été spécifié, un ID unique sera généré pour cette fonctionnalité.
`infoWindowHtml`	Type:`string` Texte de la fonctionnalité au format bulle, le cas échéant
`name`	Type:`string` `<name>` de l'élément géographique, extrait de la balise de calque.
`snippet`	Type:`string` `<Snippet>` de l'élément géographique, extrait de la balise de calque.

Interface KmlAuthor

Interface google.maps.KmlAuthor

Inclut des informations sur l'auteur d'un document ou d'un élément géographique KML.

Propriétés
`email`	Type:`string` Adresse e-mail de l'auteur ou chaîne vide si elle n'est pas spécifiée.
`name`	Type:`string` Nom de l'auteur ou chaîne vide si non spécifié.
`uri`	Type:`string` Page d'accueil de l'auteur ou chaîne vide si aucune valeur n'est spécifiée.

KML

Classe KmlLayer

Constructeur

Méthodes

Événements

Interface KmlLayerOptions

Propriétés

Interface KmlLayerMetadata

Propriétés

Constantes KmlLayerStatus

Constantes

Interface KmlMouseEvent

Propriétés

Interface KmlFeatureData

Propriétés

Interface KmlAuthor

Propriétés