Utilitário de importação de KML do Google Maps

1. Introdução
2. Adicionar uma camada KML
3. Limpar uma camada KML
4. Acessar contêineres KML
5. Acessar marcadores de local KML e sobreposições de solo KML
6. Acessar propriedades KML
7. Recursos permitidos do KML

Introdução

KML é uma extensão do formato de dados XML e representa os dados geográficos em um mapa. O uso desse utilitário permite converter objetos KML em formas geográficas e renderizá-las como uma camada sobre um mapa. Para adicionar e remover dados KML do mapa, chame addLayerToMap() e removeLayerFromMap(), respectivamente. Para acessar propriedades em um objeto KML, chame getProperties() em qualquer marcador de local, GroundOverlay, documento ou pasta.

Adicionar uma camada KML ao mapa

Para adicionar uma camada de dados ao mapa, primeiro crie uma instância da classe KmlLayer. Há duas maneiras de instanciar uma KmlLayer.

Para importar e renderizar um conjunto de dados KML de um recurso local são necessários:

• Um objeto GoogleMap em que a camada será renderizada
• Um arquivo de recursos local contendo os dados KML
• Um objeto Context, que é necessário para abrir um arquivo de recursos local

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

      

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

      

Para importar e renderizar um conjunto de dados KML de um stream local, são necessários:

• Um objeto GoogleMap em que a camada será renderizada
• Um InputStream contendo os dados KML
• Um objeto Context, que é necessário para abrir recursos locais

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);

      

Depois de criar um KmlLayer, chame addLayerToMap()() para adicionar os dados importados ao mapa.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

Limpar uma camada KML

Vamos supor que você criou esta 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);

      

Para remover a camada do mapa, chame removeLayerFromMap():

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

Acessar contêineres KML

Para acessar qualquer contêiner que tenha sido adicionado à sua camada, chame getContainers() na camada criada. Para verificar se qualquer contêiner tem contêineres aninhados, chame hasContainers(). Para acessar esses contêineres aninhados, de modo semelhante ao que você pode fazer na camada, chame getContainers().

Para acessar contêineres que não estão aninhados em KmlLayer ou KmlContainer:

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

      

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

      

Para acessar contêineres que estão aninhados em KmlLayer ou 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());
        }
    }
}

      

Acessar marcadores de local KML e sobreposições de solo KML

Para acessar qualquer marcador de local ou sobreposição de solo que tenha sido adicionado à camada, você pode chamar getPlacemarks() ou getGroundOverlays() em uma camada ou contêiner. Chamar um dos dois retornará um iterável de KmlPlacemarks ou KmlGroundOverlays, respectivamente.

Por exemplo, para acessar um objeto KmlPlacemark de uma camada:

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

      

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

      

Acessar propriedades KML

Para acessar qualquer propriedade em um contêiner ou marcador de local, chame getProperty() e atribua a ela uma chave de propriedade. Você também pode chamar hasProperty() para verificar se ela existe. Este exemplo mostra como recuperar o valor de propriedade "name" de um contêiner, se houver.

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"));
    }
}

      

Eventos de clique de geometria KML

É possível usar KmlLayer.OnFeatureClickListener() para ouvir os eventos de cliques nos recursos de geometria no mapa. O exemplo a seguir registra o ID de um recurso quando o usuário clica nele:

// 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());
    }
});

      

Conferir o app de demonstração

Para ver um exemplo de como importar um arquivo KML e criar uma camada com ele, consulte KmlDemoActivity no app de demonstração que acompanha a biblioteca de utilitários. O guia de configuração mostra como executá-lo.

Recursos permitidos do KML