KML

Selecione a plataforma: Android iOS JavaScript

Nesta página, mostramos como renderizar dados geográficos no formato KML, usando GMUKMLParser em conjunto com GMUGeometryRenderer. KML é um formato conhecido para renderizar dados geográficos como pontos, linhas e polígonos.

A captura de tela a seguir mostra alguns exemplos de dados KML renderizados em um mapa:

Pré-requisitos e observações

GMUKMLParser faz parte da Biblioteca de utilitários do SDK do Maps para iOS. Se você ainda não configurou a biblioteca, siga o guia de configuração antes de ler o restante desta página.

Para ver o exemplo de código completo, consulte os apps de exemplo no GitHub (em inglês).

Renderização de dados KML

Para renderizar dados KML em um mapa, crie um GMUKMLParser com o caminho para um recurso KML (KML_Sample.kml neste exemplo). Em seguida, crie um GMUGeometryRenderer transmitindo a instância GMUKMLParser. Por fim, chame GMUGeometryRenderer.render(). O exemplo de código a seguir mostra a renderização de dados KML em um mapa:

Swift

import GoogleMapsUtils

class KML: NSObject {
  private var mapView: GMSMapView!

  func renderKml() {
    guard let path = Bundle.main.path(forResource: "KML_Sample", ofType: "kml") else {
      print("Invalid path")
      return
    }

    let url = URL(fileURLWithPath: path)

    let kmlParser = GMUKMLParser(url: url)
    kmlParser.parse()

    let renderer = GMUGeometryRenderer(
      map: mapView,
      geometries: kmlParser.placemarks,
      styles: kmlParser.styles
    )

    renderer.render()
  }
}
      

Objective-C

@import GoogleMapsUtils;

@implementation KML {
  GMSMapView *_mapView;
}

- (void)renderKml {
  NSString *path = [[NSBundle mainBundle] pathForResource:@"KML_Sample" ofType:@"kml"];
  NSURL *url = [NSURL fileURLWithPath:path];
  GMUKMLParser *parser = [[GMUKMLParser alloc] initWithURL:url];
  [parser parse];
  GMUGeometryRenderer *renderer = [[GMUGeometryRenderer alloc] initWithMap:_mapView
                                                                geometries:parser.placemarks
                                                                    styles:parser.styles];
  [renderer render];
}

@end