Skip to content

jumpinjackie/vscode-map-preview

Repository files navigation

VSCode Map Preview

This extension provides the ability to preview spatial data files and snippets on a map

Supported Formats

Support for various formats is available through the format drivers provided by the OpenLayers library

How to use this extension

Open any plain text file (or active open document) and run the Map Preview command (default keybinding: ALT+M) from the command palette. If the text content checks out as any of the above supported formats, it will be parsed into vector feature data to be shown on an interactive map in the HTML preview pane.

See attached gif for an example:

Partially supports simplestyle-spec for visualization:

  • for lines: "stroke", "stroke-width"

  • for polygons: "fill", "stroke", "stroke-width"

  • for points: "marker-color"

Any content not recognized by the preview command (ie. Doesn't check out as any of the above formats) will cause the following error to be shown

If you believe this to be incorrect (ie. You have legitimate content that should be one of the above formats), please report an issue on this

Configuration

Many aspects of this extension can be configurable. See the configuration reference

Release Notes

See the release notes document

Caveats/Limitations

  • The data you are previewing must be transformable to EPSG:3857 (Web Mercator) coordinates, in order to properly overlay against any of the provided base map layers. If that previous sentence didn't make much sense, the data you are previewing should be in latitude/longitude (known as EPSG:4326) or some other coordinate system that has an EPSG code representation
  • Will probably choke on really large data files (this extension is really meant for quick-and-dirty previews of small files and snippets)

License

MIT