Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Polymaps is a fancy JavaScript mapping library.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
docs
examples
lib
src
.gitignore
Makefile
README.mkd

README.mkd

CAVEATS, FEATURE REQUESTS AND KNOWN BUGS

API:

  • No defensive copying (on input or output).
  • No type coercion (e.g., String -> Number for zoom).
  • Using == instead of ===.
  • Many properties cannot be changed after load (e.g., tile size, URL).
  • No (easy) way to lookup a GeoJSON elements by feature id.
  • Missing in-code documentation, API reference.
  • Include support (not just examples) for TileCache, TileStache, Bing?

Events:

  • "move" event does not distinguish zoom / pan / zoom+pan events.
  • "show" events are not supported on image tiles.
  • There are no corresponding "unload" or "hide" events.
  • There is no "error" event if a tile fails to load.
  • Arrow control pans three times for two keydowns.

Sizing:

  • Maps with no explicit size are auto-resized on window resize;
    • This may miss resize based on DOM changes (e.g., element removal).
    • This may generate spurious resize events for fixed-size parents.
  • If the map is bigger than its parent, tiles are not automatically clipped.

Tiles:

  • Assumes Mercator projection, with Google-y transform.
  • Anti-aliasing artifacts are visible with smooth zooming / rescaled tiles.
  • When translucent tiles are rescaled, they can overlap with other resolutions.

Queue:

  • Should prioritize tile requests from the center out.
  • Create host-specific queues to allow more than 6 simultaneous requests?
Something went wrong with that request. Please try again.