whoots-js

WebJar for whoots-js

License	ISC
Categories	JavaScript Languages
GroupId	org.webjars.npm
ArtifactId	whoots-js
Last Version	2.0.0
Release Date	Jun 15, 2016
Type	jar
Description	whoots-js WebJar for whoots-js
Project URL	http://webjars.org
Source Code Management	https://github.com/mapbox/whoots-js

Download whoots-js

Filename	Size
whoots-js-2.0.0.pom
whoots-js-2.0.0.jar	592 KB
whoots-js-2.0.0-sources.jar	22 bytes
whoots-js-2.0.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/whoots-js/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>whoots-js</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/whoots-js/
implementation 'org.webjars.npm:whoots-js:2.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/whoots-js/
implementation ("org.webjars.npm:whoots-js:2.0.0")

Apache Buildr

'org.webjars.npm:whoots-js:jar:2.0.0'

Apache Ivy

<dependency org="org.webjars.npm" name="whoots-js" rev="2.0.0">
  <artifact name="whoots-js" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='whoots-js', version='2.0.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "whoots-js" % "2.0.0"

Leiningen

[org.webjars.npm/whoots-js "2.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

whoots-js

Request tiles from WMS servers that support EPSG:3857.

This project is a JavaScript port of https://github.com/timwaters/whoots by Tim Waters.

What is it?

Given a z/x/y tile coordinate like 19/154308/197167, whoots-js can request imagery from an EPSG:3857 supporting WMS server like this:

https://img.nj.gov/imagerywms/Natural2015?
  bbox=-8242663.382160267,4966572.349857613,-8242586.945131982,4966648.786885899
  &format=image/png&service=WMS&version=1.1.1&request=GetMap&srs=EPSG:3857
  &width=256&height=256&layers=Natural2015

Usage

var WhooTS = require('@mapbox/whoots-js');

// Get an image url for a given tile coordinate
var baseUrl = 'https://img.nj.gov/imagerywms/Natural2015';
var layer = 'Natural2015';
var url = WhooTS.getURL(baseUrl, layer, 154308, 197167, 19);

Server

This project includes a sample redirecting wms proxy server in server.js.

npm run start will start a local server on port 8080 that redirects tile requests.

Valid tile requests look like:

http://localhost:8080/tms/{z}/{x}/{y}/{layer}/{endpoint}
http://localhost:8080/tms/19/154308/197167/Natural2015/https://img.nj.gov/imagerywms/Natural2015

Documentation

Complete API documentation is here: http://mapbox.github.io/whoots-js/

Mapbox

Mapbox is the location data platform for mobile and web applications. We're changing the way people move around cities and explore our world.

Versions

Version
2.0.0 Jun 15, 2016