web-map-custom-element

web-map customized built-in HTML <map> or custom <mapml-viewer>


Keywords
web-components, web, maps, map, web-map, geo-map, map layer, custom-elements, dom, hypertext, mapml, progressive-enhancement, web-platform
License
W3C
Install
npm install web-map-custom-element@0.8.0

Documentation

Continuous Testing

<mapml-viewer>

The <mapml-viewer> is a declarative vocabulary for Web mapping that extends HTML to include modern Web maps. It is a pilot / reference implementation of the proposed and evolving Map Markup Language Web standard.

Installation

$ npm install @maps4html/web-map-custom-element

See instructions for further details.

Usage

You create a map with one or more layers via the <mapml-viewer> HTML tag. Add layers via the <layer-> tag with content OR a src attribute pointing to a MapML document (must be served as either text/mapml or application/xml content type):

<mapml-viewer projection="OSMTILE" zoom="0" lat="0.0" lon="0.0" controls>
  <layer- label="OpenStreetMap" src="https://geogratis.gc.ca/mapml/en/osmtile/osm/" checked></layer->
</mapml-viewer>

OR inline content

<mapml-viewer projection="OSMTILE" lat="10" lon="0" zoom="1" controls>
  <layer- label="OpenStreetMap" checked>
    <map-extent units="OSMTILE">
      <map-input name="z" type="zoom" value="18" min="0" max="18"></map-input>
      <map-input name="x" type="location" units="tilematrix" axis="column" min="0" max="262144"></map-input>
      <map-input name="y" type="location" units="tilematrix" axis="row" min="0" max="262144"></map-input>
      <map-link rel="tile" tref="https://tile.openstreetmap.org/{z}/{x}/{y}.png"></map-link>
    </map-extent>
  </layer->
</mapml-viewer>

Contributing

See CONTRIBUTING for details, but generally:

  1. Join our Community Group
  2. Fork it!
  3. Create your feature branch: git checkout -b my-new-feature
  4. Commit your changes: git commit -am 'Add some feature'
  5. Push to the branch: git push origin my-new-feature
  6. Submit a pull request :D

History

TODO: Write history

Credits

Map for HTML Community members and supporters past, present and future.

License

All Reports in this Repository are licensed by Contributors under the W3C Software and Document License.
Contributions to Specifications are made under the W3C CLA.