UNCLASSIFIED

DEVELOPER DOCUMENTATION

GEOINT Services provides Open Street Map (OSM) basemaps through XYZ and WMTS Application Programming Interfaces (APIs). These basemaps are available in 3 styles and both Web Mercator (EPSG:3857) and Plate Carrée (EPSG:4326) projections. The geospatial data used to generate these basemaps is kept up-to-date with the latest OpenStreetMap.org updates.

OSM X/Y/Z API

The tile service supports map tile access via the OSM X/Y/Z API format.

The X/Y/Zoom API is available at following URLs:

URL Style Projection Zoom Levels
https://osm.gs.mil/tiles/default/<zoom>/<x>/<y>.png default Web Mercator (EPSG:3857) 0 - 20
https://osm.gs.mil/tiles/bright/<zoom>/<x>/<y>.png bright Web Mercator (EPSG:3857) 0 - 20
https://osm.gs.mil/tiles/humanitarian/<zoom>/<x>/<y>.png humanitarian Web Mercator (EPSG:3857) 0 - 20
https://osm.gs.mil/tiles/default_pc/<zoom>/<x>/<y>.png default Plate Carrée (EPSG:4326) 0 - 20
https://osm.gs.mil/tiles/bright_pc/<zoom>/<x>/<y>.png bright Plate Carrée (EPSG:4326) 0 - 20
https://osm.gs.mil/tiles/humanitarian_pc/<zoom>/<x>/<y>.png humanitarian Plate Carrée (EPSG:4326) 0 - 20

OGC Web Map Tile Service (WMTS) API

The WMTS service can be configured using the following URLs:

https://osm.gs.mil/wmts/1.0.0/WMTSCapabilities.xml - RESTful WMTS

https://osm.gs.mil/ows?SERVICE=WMTS&REQUEST=GetCapabilities - Key-Value Pair (KVP) WMTS

__

Parallel access to tiles from browser applications can be done using numbered versions of these URLs (osm-1 through osm-4).

For example, Leaflet can be configured as follows:

L.tileLayer('https://osm-{s}.gs.mil/tiles/default/{z}/{x}/{y}.png', { subdomains: '1234', … });

OpenLayers and OpenSphere can be configured as follows:

new TileLayer({source: new OSM({url: 'https://osm-{1-4}.gs.mil/tiles/default/{z}/{x}/{y}.png', … })});

__

Additionally, the API usage is documented on the OpenStreetMap wiki. Both Leaflet and OpenLayers have built-in support for the tile service API, so their documentation might be a good supplement to the information on the OSM wiki.

http://wiki.openstreetmap.org/wiki/Using_OpenStreetMap

DIDN'T FIND WHAT YOU WERE LOOKING FOR?

UNCLASSIFIED