Repository files navigation

The <mapml-viewer> is a declarative vocabulary for Web mapping that extendsHTML to include modern Web maps. It is a pilot / reference implementation of theproposed and evolvingMap Markup Language (MapML)Web standard.

$npm install @maps4html/mapml

Seeinstructions for further details.

You create a map with one or more layers via the <mapml-viewer> HTML tag. Addlayers via the <map-layer> tag with content OR a src attribute pointing to aMapML document (must be served as eithertext/mapml orapplication/xml contenttype):

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

OR inline content

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

SeeCONTRIBUTING for details, but generally:

0. Join ourCommunity Group
1. Discuss your proposed changes or requirements in a GitHub issue in maps4html organization
2. Once agreement is reached on your ideas, 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
7. Iterate as required.

The idea of standardizing maps in the web platform arose from discussions at aW3C linking spatial data workshop in 2014. A secondonline workshop focused on maps for the web was held in 2020, and from the latter,many detailed requirements for maps on the web were presented. The MapMLpolyfill attempts to track and implement these (evolving) requirements, with theintent being to eventually fully specify and the requirements of web mapusers as an update to the HTML Living Standard, implemented by browsers.

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

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

Professional conduct on the partof our members is required and expected by ourstatus as a project of theW3C Community and Business Groups program.