Utilitaire d'importation KML de Google Maps

1. Introduction
2. Ajouter un calque KML
3. Effacer un calque KML
4. Accéder aux conteneurs KML
5. Accéder aux repères KML et aux superpositions au sol KML
6. Accéder aux propriétés KML
7. Fonctionnalités KML compatibles

Introduction

KML est une extension du format de données XML et représente des données géographiques sur une carte. Cet utilitaire permet de convertir des objets KML en formes géographiques et d'effectuer le rendu sous forme de calque au-dessus d'une carte. Pour ajouter et supprimer vos données KML de la carte, appelez respectivement addLayerToMap() et removeLayerFromMap(). Vous pouvez accéder aux propriétés d'un objet KML en appelant getProperties() sur n'importe quel élément Placemark, GroundOverlay, Document ou Folder.

Ajouter un calque KML à la carte

Pour ajouter un calque de données à la carte, vous devez d'abord créer une instance de la classe KmlLayer. Il existe deux façons d'instancier un KmlLayer.

Pour importer et effectuer le rendu d'un jeu de données KML à partir d'une ressource locale, il vous faut :

• Un objet GoogleMap dans lequel le calque doit être affiché
• Un fichier de ressources local contenant les données KML
• Un objet Context nécessaire pour ouvrir un fichier de ressources local.

val layer = KmlLayer(map, R.raw.geojson_file, context)

      

KmlLayer layer = new KmlLayer(map, R.raw.geojson_file, context);

      

Pour importer et effectuer le rendu d'un jeu de données KML à partir d'un flux local, il vous faut :

• Un objet GoogleMap dans lequel le calque doit être affiché
• Un tableau (InputStream) contenant les données KML
• Un objet Context, nécessaire pour ouvrir les ressources locales.

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

Après avoir créé un KmlLayer, appelez addLayerToMap()() pour ajouter les données importées à la carte.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

Effacer un calque KML

Supposons que vous avez créé ce KmlLayer :

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

Pour supprimer le calque de la carte, appelez removeLayerFromMap() :

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

Accéder aux conteneurs KML

Pour accéder aux conteneurs qui ont été ajoutés à votre calque, vous pouvez appeler getContainers() sur le calque que vous avez créé. Pour savoir si un conteneur contient des conteneurs imbriqués, vous pouvez appeler hasContainers(). Pour accéder à ces conteneurs imbriqués, de la même manière que vous pouvez le faire dans votre calque, vous pouvez appeler getContainers().

Pour accéder aux conteneurs qui ne sont pas imbriqués dans un KmlLayer ni un KmlContainer:

for (containers in layer.containers) {
    // Do something to container
}

      

for (KmlContainer containers : layer.getContainers()) {
    // Do something to container
}

      

Pour accéder aux conteneurs qui sont imbriqués dans un KmlLayer ou un KmlContainer :

fun accessContainers(containers: Iterable<KmlContainer>) {
    for (container in containers) {
        if (container.hasContainers()) {
            accessContainers(container.containers)
        }
    }

      

public void accessContainers(Iterable<KmlContainer> containers) {
    for (KmlContainer container : containers) {
        if (container.hasContainers()) {
            accessContainers(container.getContainers());
        }
    }
}

      

Accéder aux repères KML et aux superpositions au sol KML

Pour accéder à un repère ou à une superposition au sol qui a été ajouté(e) au calque, vous pouvez appeler getPlacemarks() ou getGroundOverlays() sur un calque ou un conteneur. Le fait d'appeler l'une ou l'autre de ces méthodes renverra un itérable de KmlPlacemarks ou KmlGroundOverlays respectivement.

Par exemple, pour accéder aux objets KmlPlacemark à partir d'un calque :

for (placemark in layer.placemarks) {
    // Do something to Placemark
}

      

for (KmlPlacemark placemark : layer.getPlacemarks()) {
    // Do something to Placemark
}

      

Accéder aux propriétés KML

Pour accéder à n'importe quelle propriété d'un conteneur ou d'un repère, appelez getProperty() et attribuez-lui une clé de propriété. Vous pouvez également appeler hasProperty() pour vérifier qu'elle existe. Cet exemple montre comment extraire la valeur de propriété "name" d'un conteneur, si elle existe.

for (container in layer.containers) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"))
    }
}

      

for (KmlContainer container : layer.getContainers()) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"));
    }
}

      

Événements de clic sur la géométrie KML

Vous pouvez utiliser KmlLayer.OnFeatureClickListener() pour écouter les événements de clic sur les éléments géométriques de la carte. L'exemple suivant enregistre l'ID d'un élément géométrique lorsque l'utilisateur clique dessus :

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener { feature ->
    Log.i(
        "KML",
        "Feature clicked: " + feature.id
    )
}

      

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener(new KmlLayer.OnFeatureClickListener() {
    @Override
    public void onFeatureClick(Feature feature) {
        Log.i("KML", "Feature clicked: " + feature.getId());
    }
});

      

Voir l'application de démonstration

Pour savoir comment importer un fichier KML et créer un calque avec ce fichier, consultez KmlDemoActivity dans l'application de démonstration fournie avec la bibliothèque d'utilitaires. Le guide de configuration vous explique comment exécuter l'application de démonstration.

Fonctionnalités KML compatibles