heremaps/xyz-maps
heremaps/xyz-maps has 76 GitHub stars and 24 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 21:10 UTC. Last push 2026-11-10.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
XYZ Maps is an open-source map editor written in TypeScript.
Creative & MediaREADME.md
OriginalXYZ Maps JS
XYZ Maps is an experimental and work in progress open-source map editor written in TypeScript/JavaScript.
Overview
XYZ Maps consists of the following main modules:
- @here/xyz-maps-common : The Common module provides commonly used javascript functionality that is required by all other modules of XYZ Maps.
- @here/xyz-maps-core : The Core module provides the most basic functionality. Main functionalities of the module are: DataProviders, TileLayers, Geometric Classes and Styling definitions.
- @here/xyz-maps-display : The Display module is a highly customizable vector map display that's optimized for map editing, larger raw datasets and frequently changing data.
- @here/xyz-maps-editor : The Editor module provides an API for editing map data that can be used to easily access, add, remove and edit various types of map data.
All four modules provide UMD and ESM builds with TypeScript and browser-global typings.
Prerequisites
Start developing
Clone this repository
git clone https://github.com/heremaps/xyz-maps.git cd xyz-mapsInstall pnpm, if it is not installed yet
npm install -g pnpmThe project pins the pnpm version in
package.json(packageManager). pnpm switches to that version automatically. Installs withnpmoryarnare blocked on purpose.Install node module dependencies
pnpm installwatch for source code changes and build dev version
pnpm run watch-devBuilds are located in
./packages/*/dist/
Setup your XYZ token
Setup an XYZ token is only required if the XYZ Hub endpoint at xyz.api.here.com is used. You can get a token by following the instructions in this guide.
If you are using a local XYZ Hub simply set set-access-token to an empty string.
Running integration tests / playground and debug pages requires the XYZ token to be provided.
- Configure your XYZ token
pnpm run set-access-token YOUR_ACCESS_TOKEN
Serve debug page
- Start debug server (requires xyz access token)
browser will start and open http://localhost:8080/debug automaticallypnpm run server
Serve Playground
- Build and start the playground (requires xyz access token)
browser will start and open http://localhost:8081/packages/playground/dist automaticallypnpm run playground
Other Commands
Run tests on release build
pnpm run testBuild development version
pnpm run build-dev(located in docs/)Build release version only
pnpm run build-release(minified...)Build the documentation
pnpm run build-doc(located in packages/docs/dist/)Create full release bundle
pnpm run bundle-release(includes documentation and playground)Configure XYZ access token
pnpm run set-access-token YOUR_ACCESS_TOKEN
Guides
License
Copyright (C) 2019-2026 HERE Europe B.V.
This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details
