KML

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Classe KmlLayer

Classe google.maps.KmlLayer

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

Cette classe étend MVCObject.

KmlLayer
KmlLayer([opts])
Paramètres:
Crée un KmlLayer qui affiche le contenu du fichier KML/KMZ spécifié (https://developers.google.com/KML/documentation/KMLreference) ou du fichier GeoRSS (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
Paramètres:aucun
Valeur renvoyée: LatLngBounds
Obtenez la vue par défaut du calque affiché.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée : Map
Obtenez la carte sur laquelle le calque KML est rendu.
getMetadata
getMetadata()
Paramètres:aucun
Valeur renvoyée: KmlLayerMetadata
Récupère les métadonnées associées à ce calque, comme spécifié dans le balisage du calque.
getStatus
getStatus()
Paramètres:aucun
Valeur renvoyée : KmlLayerStatus
Obtenez l'état du calque, défini après le chargement du document demandé.
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 z-index.
Récupère le z-index du calque KML.
setMap
setMap(map)
Paramètres:
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:
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 z-index à définir.
Valeur renvoyée : aucune
Définit le z-index du calque KML.
Hérité : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
Arguments:
Cet événement se déclenche lorsqu'un internaute clique sur un élément du calque.
defaultviewport_changed
function()
Arguments : aucun
Cet événement se déclenche lorsque la fenêtre d'affichage par défaut des calques KML a changé.
status_changed
function()
Arguments : aucun
Cet événement se déclenche lorsque le chargement du calque KML est terminé. À ce stade, vous pouvez lire la propriété d'état pour déterminer si le calque s'est bien chargé.

Interface KmlLayerOptions

google.maps.KmlLayerOptions interface

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

clickable optional
Type:boolean optional
Par défaut : true
Si la valeur est true, le calque 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 zoomée sur la boîte englobante du contenu du calque.
screenOverlays optional
Type:boolean optional
Par défaut:true
Afficher ou non les superpositions d'écran
suppressInfoWindows optional
Type:boolean optional
Supprimer l'affichage des fenêtres d'informations lorsque l'utilisateur clique sur les éléments géographiques du calque
url optional
Type : string optional
URL du document KML à afficher.
zIndex optional
Type : number optional
z-index du calque.

Interface KmlLayerMetadata

google.maps.KmlLayerMetadata interface

Métadonnées d'un seul calque KML, au format JSON.

author
Type : KmlAuthor
<atom:author> du calque, extraite du balisage du calque.
description
Type : string
<description> du calque, extraite du balisage du calque.
hasScreenOverlays
Type:boolean
Indique si le calque comporte des superpositions d'écran.
name
Type:string
<name> du calque, extraite du balisage du calque.
snippet
Type : string
Le <Snippet> du calque, extrait du balisage du calque

Constantes KmlLayerStatus

constantes google.maps.KmlLayerStatus

État renvoyé par KmlLayer à la fin du chargement d'un document. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'OK' ou google.maps.KmlLayerStatus.OK.

DOCUMENT_NOT_FOUND Le document est introuvable. Il s'agit très probablement d'une URL non valide ou du document n'est pas accessible au public.
DOCUMENT_TOO_LARGE Le document dépasse la taille maximale autorisée pour les fichiers KmlLayer.
FETCH_ERROR Impossible de récupérer le document.
INVALID_DOCUMENT Le document n'est pas un document KML, KMZ ou GeoRSS valide.
INVALID_REQUEST KmlLayer non valide.
LIMITS_EXCEEDED Le document dépasse la limite de fonctionnalités de KmlLayer.
OK Le calque a bien été chargé.
TIMED_OUT Impossible de charger le document dans un délai raisonnable.
UNKNOWN Échec du chargement du document pour une raison inconnue.

Interface KmlMouseEvent

google.maps.KmlMouseEvent interface

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

featureData
Un objet KmlFeatureData, contenant des informations sur la fonctionnalité sur laquelle l'utilisateur a cliqué.
latLng
Type : LatLng
Position à laquelle ancrer une fenêtre d'informations sur la fonctionnalité sur laquelle l'utilisateur a cliqué.
pixelOffset
Type:Size
Décalage à appliquer à une fenêtre d'informations associée à la fonctionnalité sur laquelle l'utilisateur a cliqué.

Interface KmlFeatureData

google.maps.KmlFeatureData interface

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

author
<atom:author> de l'élément géographique, extrait du balisage du calque (si spécifié).
description
Type:string
<description> de l'élément géographique, extrait du balisage du calque.
id
Type:string
<id> de l'élément géographique, extrait du balisage du calque. Si aucun élément <id> n'a été spécifié, un ID unique sera généré pour cet élément géographique.
infoWindowHtml
Type : string
Texte de style bulle de l'élément géographique, s'il est défini.
name
Type : string
<name> de l'élément géographique, extrait du balisage du calque.
snippet
Type:string
<Snippet> de l'élément géographique, extrait du balisage du calque.

Interface KmlAuthor

google.maps.KmlAuthor interface

Contient les détails de l'auteur d'un document ou d'un élément KML.

email
Type : string
Adresse e-mail de l'auteur ou chaîne vide si celle-ci n'est pas spécifiée.
name
Type:string
Nom de l'auteur ou chaîne vide si celle-ci n'est pas spécifiée.
uri
Type : string
Page d'accueil de l'auteur ou chaîne vide si celle-ci n'est pas spécifiée.