Mapcode Library for JavaScript

Copyright (C) 2014 Stichting Mapcode Foundation (http://www.mapcode.com)

---

Online documentation can be found at: http://mapcode-foundation.github.io/mapcode-js/

If you plan to use mapcodes in HTML/Javascript extensively, you may be interested in looking at running an instance of a Mapcode REST API server in your applications landscape.

This reduces the payload the HTML/Javascript tremendously, as the mapcode tables will not need to be transported to the client.

You can find the Mapcode REST API sources, ready to be deployed on any JVM server, like Tomcat or Jetty, on: https://github.com/mapcode-foundation/mapcode-rest-service

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Original C library created by Pieter Geelen. Work on Java version of the Mapcode library by Rijn Buve and Matthew Lowden.

Javascript Files for Mapcode Support

mapcode.js  - Key routines for mapcode support
ndata.js    - Data table for mapcode support

sample.html - Sample code to interpret / generate mapcodes
ctrynams.js - Optional js array with the names of territories (in English)

Version History

• July 2015

  • 2.0.0

  Fixes to the data rectangles (primarily intended for ISO proposal), see Word document for details.

• June 2015

  • 1.54

  Removed unneeded mminfo flags (no effect on functionality).

• May 2015

  • 1.50.3

  Redesign of the API to conform to Javascript standards and match the Java implementation of the mapcode system

  • 1.50.1

  Bugfix for mapcodes in IN-DD (in India).

  • 1.50

  Major release. This version is not backwards compatible with mapcode 1.4x: is has dropped support for Antartica AT0-8 codes and has a changed (improved) way of dealing with the Greek alphabet.

  Added 22-chararcter post-processing of all-digit mapcodes for the Greek alphabet.

  Retired legacy aliases EAZ and SKM, AU-QL, AU-TS, AU-NI and AU-JB.

  Retired legacy Antarctica claims AT0 through AT8.

• January 2015

  • 1.41

  Added the India state Telangana (IN-TG), until 2014 a region in Adhra Pradesh.

• August 2014

  • 1.33

  Normalise results when longitude below -180 degrees.

  • 1.32

  Prevent FIJI failing to decode at exactly 180 degrees; prevent invalid filtering near the territory bounding rectangle.

• April 2014

  • 1.31

  Make iso2ccode() even more forgiving by allowing a state alias to be recognized in context.

  • 1.3

  Disable 7-char state codes for large states in India, and instead generate country mapcodes for states.

  • 1.28

  Fix for starpipe "zoning" error, causing the last 2 mapcode characters to be ignored in certain areas.

  • 1.27

  Support undefined ranges in data array (useful for partial JavaScript builds).

• May 2013

  • 1.26

  Added alias OD for India, and 2.3 code for Daman and Diu.

  • 1.25

  Ccode2iso(c,2) support added.

  • 1.24

  Public domain release.