Zh OpenStreetMap Internal File Parser

From Documentation
Jump to navigation Jump to search

File Parsers

This section describes using KML and GPX files.

Description Predefined Types

In Paths properties Layer type is

  • KML
  • GPX

When I start this extension I found omnivore library, which process file and you get correct layer and you can display it on map.

I used it to create paths, but I decided to have control of some properties from component.

Ie you can set color, hover color, width and etc properties for your KML or GPX data from Path properties. You have flexible appearance control.

Layer popup content is Name property in file

Path properties

The next Path properties can apply to layer

  • Color
  • Opacity
  • Weight
  • Fill Color
  • Fill Opacity
  • Hover Color
  • Hover Fill Color
  • Layer Show Type - if set to Zoom you get fit map bounds to display layer on max zoom
  • Suppress Popup


Map properties

The next Map properties can apply to layer

  • Disable AutoPan

Description Internal Parser Types

In Paths properties Layer type is

  • KML (Internal Parser)
  • GPX (Internal Parser)


By user requests I decided to create my own file parser.

For example, your file can contain not only one line with different colors (or other properties), and you want to use internal settings from file.

Moreover, when I have all data parsed, I can control and add different features. For exmple, you can use placemark clusterization for placemarks (Points or Waypoints) from file.


Now processed next tags

KML file

  • Style - style definition
    • IconStyle
      • Icon
        • href
        • scale
    • LineStyle
      • color
      • width
    • PolyStyle
      • color
      • outline
      • fill


  • StyleMap - styles (normal, highlight) - hovering case
    • Pair
      • key
      • styleUrl


  • Placemark - objects
    • Point - placemarks
      • coordinates
    • MultiGeometry
      • LineString - polylines
        • coordinates
      • Polygon - polygons
        • outerBoundaryIs - polygon shape
          • LinearRing
            • coordinates
        • innerBoundaryIs - polygon holes
          • LinearRing
            • coordinates
    • Polygon - polygons without MultiGeometry
      • outerBoundaryIs - polygon shape
        • LinearRing
          • coordinates
      • innerBoundaryIs - polygon holes
        • LinearRing
          • coordinates
    • MultiTrack
      • gx:Track - polylines
        • gx:coor
    • gx:Track - polylines without MultiTrack
      • gx:coor
  • Folder


  • Document


GPX file

  • trk - track definition
    • extensions
      • gpxx:TrackExtension
        • gpxx:DisplayColor - color
    • trkseg - track segments
      • trkpt - track point
  • wpt - waypoint definition


Path properties

The next Path properties can apply to layer

  • Layer Show Type - if set to Zoom you get fit map bounds to display layer on max zoom
  • Suppress Popup - suppress all popups, if you want to have fine control of popups set it to No and use the next properties
  • Popup content for Placemark
  • Popup content for Polyline
  • Popup content for Polygon
  • Tooltip content for Polyline
  • Tooltip content for Polygon

The values can be

  • Suppress - suppress feature
  • Name - use tag name for value
  • Description - use tag description (for KML) or desc (for GPX)
  • Description, if not defined then Name use value of Description, if it is not defined then Name


You can use Tooltips to show hover text for polylines and polygons, and flexible define what content will have popups.


Map properties

The next Map properties can apply to layer

  • Show placemarks in cluster - enable placemark clusterization
    • all properties of clusterer applied to Path Placemarks
  • Placemark Group Control - you can show/hide your paths
    • Manage Placemarks - allow show/hide not only your placemarks, but also Path Placemarks


Language: English  • русский