Skip to content


Repository files navigation

Continuous Testing


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.


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

See instructions for further details.


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="" checked></layer->

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="{z}/{x}/{y}.png"></map-link>


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


TODO: Write history


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


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.