Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Small, fast & simple map control as a jQuery plugin

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 dist
Octocat-spinner-32 docs
Octocat-spinner-32 js
Octocat-spinner-32 libs
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .jshintrc
Octocat-spinner-32 CONTRIBUTING.md
Octocat-spinner-32 Gruntfile.js
Octocat-spinner-32 LICENSE-GPL
Octocat-spinner-32 LICENSE-MIT
Octocat-spinner-32 README.md
Octocat-spinner-32 apple-touch-icon.png
Octocat-spinner-32 dev-journal-ryan.txt
Octocat-spinner-32 favicon.ico
Octocat-spinner-32 geo.jquery.json
Octocat-spinner-32 index-full.html
Octocat-spinner-32 index.html
Octocat-spinner-32 package.json
README.md

jQuery Geo

After years of internal development, we are pleased to bring our JavaScript map widget and spatial analysis tools to the open-source world in the form of a jQuery plugin.

Getting Started

Using jQuery Geo requires adding one element, including one script (apart from jQuery itself) and calling one function. The following copy-and-paste snippet will help you get started.

<div id="map" style="height: 320px;"></div>
<script src="http://code.jquery.com/jquery-1.9.1.min.js"></script>
<script src="http://code.jquerygeo.com/jquery.geo-1.0.0-b1.5.min.js"></script>
<script>
  $(function() {
    $( "#map" ).geomap( ); // you've got a map!
  });
</script>

You can also download the latest release as a minified JavaScript file or a full, uncompressed one.

Documentation

The latest docs are hosted at: http://docs.jquerygeo.com

Release and other announcements via @jQueryGeo on Twitter: https://twitter.com/jQueryGeo

News and smaller updates via @ryanttb on Twitter: https://twitter.com/ryanttb

Contributing

Important notes

Please don't edit files in the dist subdirectory as they are generated via Grunt. You'll find source code in the js subdirectory.

Code style

Regarding code style like indentation and whitespace, follow the conventions you see used in the source already.

Please follow jQuery Foundation's JavaScript Style Guide and/or idomatic.js.

Submitting pull requests

  1. Create a new branch, please don't work in your master branch directly.
  2. Fix stuff.
  3. Run grunt to verify that your code is lint-free. Repeat steps 2-3 until done.
  4. Update the documentation to reflect any changes.
  5. Push to your fork and submit a pull request.

Building with grunt

  • install node.js ~0.8
  • install grunt-cli (info):
npm install -g grunt-cli
  • uninstall versions of grunt < 0.4.1
  • install grunt 0.4.1 locally into your project folder (info):
cd path/to/geo
npm install grunt
  • install required grunt build tasks locally
npm install grunt-contrib-clean
npm install grunt-contrib-concat
npm install grunt-contrib-uglify
npm install grunt-contrib-qunit
npm install grunt-contrib-jshint
  • run grunt:
grunt

Unless you have downloaded a tagged release, grunt will create a test version of jQuery Geo: dist/jquery.geo-1.0.0-test.min.js

Release History

1.0.0-b2

  • geomap - [bug] map does not always redraw shapes after interactiveTransform, a pan will fix them
  • docs - geomap - make zoomFactor an init-only public option
  • geomap - make zoomFactor an init-only public, option
  • geomap - support touch/mouse events on hybrid devices
  • docs - geomap - top-level map label links are clickable
  • docs - geomap - click mode
  • geomap - click mode
  • geomap - decrease z-index from attr & shape label links & document how to hide them behind non-map conent
  • geomap - [bug] removing a shape from one service that has been appended to two services causes an error in the second service
  • geographics - [bug] graphics stretch after resize
  • project - upgrade to gruntjs 0.4.1
  • geomap - support Windows 8 Store apps
  • geomap - [bug] #93 mac and some pc touchpads zoom too quickly
  • geomap - [bug] static string urls for service object src do not work with jQuery > 1.7

1.0.0-b1.5 (2013-01-17)

  • examples - drawing markers
  • geomap - ie8 - [bug] graphics do not resize with window
  • examples - kml points
  • docs - geomap - default action for shift option should be dragBox in dragBox mode
  • geomap - default action for shift option should be dragBox in dragBox mode
  • geomap - don't empty graphics on map interaction
  • geographics - build labels in background, replace html once
  • geomap - [bug] sometimes interaction with other elements doesn't work right on a page with a map
  • geographics - don't empty labels on map interaction
  • geomap - allow label links to be clicked

1.0b1.1 (2012-08-24)

  • geomap - [bug] shingled deferred services lose img elements when changing scales slowly
  • geomap - [bug] shapes don't render on smaller windows when zoomed in
  • geomap - [bug] changing the zoom & center options at the same time does not zoom to the correct location

1.0b1 (2012-07-30)

  • geographics - use canvas compositing for Polygons with holes
  • geographics - [bug] on polygons with holes, stroke draws a line from exterior ring to interior one
  • docs - geomap - trigger a shape event when a user finishes measuring
  • geomap - trigger a shape event when a user finishes measuring
  • geomap - [bug] elements inside the map div lose their position setting
  • geomap - trigger bboxchange when we update the map size after the window resizes
  • geomap - [bug] multiple map widgets share the same compiled measureLabels template names and overwrite each other
  • examples - inset map/multiple maps example
  • geomap - [bug] in zoom mode, dragging from bottom-right to top-left draws box but doesn't zoom
  • geomap - [bug] any mouse down triggers refresh, even without pan
  • cdn - fix caching ** Cache-Control header max-age set to 5 years ** remove Expires header
  • geomap - upgrade to jsrender 1.0pre
  • deploy - build releases using grunt
  • deploy - make a package for new jQuery plugin directory ** https://github.com/jquery/plugins.jquery.com/blob/master/docs/package.md
  • deploy - lint JavaScript files
  • docs - geomap - dragBbox mode
  • docs - geo - polygonize function for bbox
  • geo - polygonize function for bbox
  • geomap - dragBbox mode
  • docs - geomap - shift option (default, zoom, dragBbox, off)
  • geomap - shift option (default, zoom, dragBbox, off)
  • docs - geomap - loadstart, loadend events
  • docs - geomap - allow append to take an array of shapes
  • docs - geomap - allow remove to take an array of shapes
  • docs - geomap - improve services option documentation
  • geomap - clamp measure labels to [0, 0]
  • geo - clamp centroid to bbox
  • geomap - measure label for polygon should be in centroid
  • geomap - merge interactive pan and zoom into one, faster system (pan/zoom rewrite)
  • geomap - [bug] iOS - panning is visually jumpy but settles on the correct bbox in the end
  • geomap - pinch-zoom doesn't follow user's fingers close enough when scaling
  • geomap - [bug] pinch zoom on iPad 2 (iOS 5) doesn't refresh tiles when zooming out
  • geomap - request new image in shingled service during interactive pan
  • geomap - [bug] zoom in more than once with zoom method moves tiles to the wrong spot
  • geomap - [bug] only services that have finished refreshing move when the user pans
  • geomap - [bug] map panning is jumpy, appears to be related to shapes and/or drawing context
  • geomap - [bug] pan sometimes lags on first drag
  • geomap - tiled data-scaleOrigin should be stored as an array
  • geomap - android - [bug] cannot always pan map after appending shapes
  • geomap - android - browser stops pan/zoom after 7 logos on logo demo
  • geomap - [bug] mouse wheel on bad or missing tile doesn't zoom out on first rotate
  • geomap - increase mobile performance by 9000
  • docs - geomap - add argument to refresh to force reload of images for dynamic data
  • docs - geomap - allow service-level refresh
  • docs - geomap - zoomMax option (tiled & shingled)
  • docs - geo - include method for bbox
  • geomap - bboxMax should reset center & pixelSize
  • geomap - [bug] initializing center, zoom, & bbox doesn't set all properties
  • geo - [bug] polygonize doesn't return valid polygon when using geodetic coordinates
  • geomap - [bug] dragBbox doesn't include the bbox property in the shape
  • geomap - dragBbox should send a Point (with bbox) for single clicks
  • docs - geomap - dragCircle mode
  • geo - include method for bbox
  • geomap - dragCircle mode
  • geomap - [regression] refresh & toggle methods no longer keep original service objects in sync
  • geomap - [bug] when a singled image hasn't loaded after pan and you double click on empty space, the zoomed bbox seems wrong
  • geomap - allow service-level refresh
  • geographics - remove the blit canvas from the DOM, i.e., don't attach
  • geomap - don't initialze service-level geographics until they're used
  • geomap - add argument to refresh to force reload of images (in case of dynamic data)
  • geomap - loadstart, loadend events
  • geomap - allow append to take an array of shapes
  • geomap - allow remove to take an array of shapes
  • geomap - zoomMax option
  • geomap - [bug] cannot interact with other elements on the page on iOS after panning the map (#71)
  • geomap - iOS - [bug] after one finger is removed, stop processing as if multitouch is still on
  • geomap - dumb high-precision mice down on tiled maps ** otherwise, the high precision rounds down to zero change in zoom
  • geomap - use linear distance for pinch zoom calculation
  • docs - geomap - zoomMin option
  • geomap - zoomMin option
  • docs - geomap - use MapQuest Open by default; can't deny that it looks much nicer
  • geomap - use MapQuest Open by default; can't deny that it looks much nicer
  • docs - geomap - rename dragBbox to dragBox
  • geomap - rename dragBbox to dragBox
  • geomap - [bug] error using tiled deferred services

1.0a4 (2012-02-19)

  • geomap - [bug] changing the tilingScheme doesn't update pixelSize, maxPixelSize, center or centerMax
  • geomap - [bug] shingled services throw exception during resize
  • docs - geomap - axisLayout option
  • geomap - axisLayout option
  • docs - upgrade to jQuery Mobile rc3
  • docs - allow page refreshing
  • docs - geomap - more modes: measureDistance, measureArea, static
  • docs - geomap - append label argument
  • docs - geomap - toPixel/toMap should take all coordinate dimensions like the proj functions
  • geomap - toPixel/toMap should take all coordinate dimensions like the proj functions
  • geomap - move the drawing container instead of individual points during pan
  • geomap - [bug] drawStyle resets after window resize
  • geomap - append label argument
  • docs - geomap - measureLabels option
  • geomap - measureLabels option
  • geomap - measureDistance mode
  • geomap - measureArea mode
  • docs - geomap - service-level shapeStyle
  • docs - geomap - getUrl string option
  • geomap - [bug] create doesn't clear drawing shapes
  • docs - geomap - service-level shapes
  • docs - geo - detect geodetic coordinates and call $.geo.proj automatically, don't require devs to set $.geo.proj to null
  • docs - geomap - add projection section explaining how bbox & center affect map unit type
  • docs - geomap - rename getUrl to src
  • docs - geomap - scroll option
  • docs - geomap - pannable option
  • geomap - src string option
  • examples - string service src
  • geomap - [bug] map tracks mouse when not panning if click on other elements
  • geomap - pannable option
  • geomap - scroll option
  • geomap - [bug] shapesContainer is being cleared twice during mouse wheel zoom
  • geomap - support pinch zoom on iOS
  • docs - geo - add recenter function for bbox
  • geomap - static mode
  • docs - geomap - allow Deferred or Promise as return value from src function
  • geomap - [bug] widget factory merges first service with default sometimes causing exceptions with shingled services
  • geomap - allow Deferred or Promise as return value from src function
  • geomap - [bug] resize event triggered too many times during resize
  • geomap - service-level shapes
  • geomap - service-level find
  • geographics - add a resize method, call from geomap.resize
  • geo - add recenter function for bbox
  • geomap - [bug] errors creating second un-tiled map after destroying a first on same element
  • geomap - refresh shouldn't request new images if the map element is hidden
  • geomap - [bug] delayed multitouch isn't nearly as smooth as true multitouch
  • geomap - [bug] tiled pinch zoom isn't smooth
  • geo - detect geodetic coordinates and call $.geo.proj automatically, don't require devs to set $.geo.proj to null
  • geomap - [bug] mouse wheel doesn't work with jQuery 1.7 ** upgrade to latest jquery.mousewheel plugin
  • geomap - service object visibility and opacity options should be moved to a style property
  • geomap - use currentServices in all functions unless we actually need to update the public options services object
  • geomap - don't change user's service objects in opacity/toggle
  • geomap - show attr text
  • docs - geomap - selector argument to find method
  • geomap - selector argument to find method
  • geomap - pan mode should use a hand cursor by default
  • geomap - [bug] only services that have finished refreshing move when the user pans ** for a4: hide unfinished services
  • geomap - [bug] a user can mess with the center option, e.g., convert numbers to strings, and it can wreck havoc with map state
  • geomap - [bug] zoom option doesn't return proper values for shingled services
  • geomap - [bug] non-tiled maps can zoom out past zoom 0
  • geomap - don't request tiles that are -y index
  • geomap - [bug] initializing tiled map by non-geodetic bbox always causes zoom level 0
  • docs - geomap - empty string needed for label element
  • geomap - label divs should have class="geo-label" & style="position: absolute;"
  • geomap - [bug] double tap to end shapes adds two points before ending the shape, in different places
  • geomap - [bug] lifting fingers after pinch zoom in drawLineString or drawPolygon modes sometimes adds fake visual coordinate on touch point last lifted
  • docs - upgrade to jQuery 1.7.2
  • geomap - [bug] scroll=off doesn't zoom map but also doesn't allow document scroll
  • geomap - [bug] changing mode does not reset measure drawing
  • geomap - [bug] jQuery UI Widget Factory no longer passes pageX & pageY event properties during trigger when using jQuery 1.7 ** upgrade to Widget Factory 1.8.17
  • examples - all demo (shingled)
  • docs - geomap - custom modes
  • examples - all demo (tiled)

1.0a3 (2011-11-01)

  • docs - geomap - more modes: zoom, drawPoint, drawLineString, drawPolygon
  • geomap - [bug] tiles do not show when pixel sizes are near or lower than 1.0
  • geo - cache bbox as geoBbox to match namespacing convention started by jQuery Mobile
  • docs - geo - initial bbox operations: center, height/width, expandBy, scaleBy & reaspect functions
  • docs - geo - initial geometry operations: bbox, distance, contains, centroid
  • docs - geomap - shape event
  • docs - geomap - refresh argument in append, remove & empty
  • docs - geomap - document the resize method
  • docs - launch jquerygeo.com
  • docs - upgrade to jQuery Mobile b3
  • docs - services - remove id property, explain the class property
  • docs - rename getPixelSize to just pixelSize
  • docs - services - change visible to visibility so it matches shapeStyle & CSS
  • docs - geomap - allow child selector syntax to target service elements with toggle & opacity methods
  • geomap - split servieTypes to different files
  • geomap - add data-geo-service to all service container elements, set to type of service
  • geomap - add data-geo-map to map divs initialized with geomap, remove on destroy
  • geomap - allow child selector syntax to target service elements with toggle & opacity methods
  • geomap - [bug] toggle does not refresh the map services being shown for the first time
  • geomap - [bug] destroy keeps window resize handler
  • geomap - [bug] destroy erases content originally inside map div
  • geomap - serviceType objects' destroy method isn't being called
  • geomap - [bug] destroyed geomaps remember appended shapes
  • docs - geomap - zoom method
  • geomap - zoom method
  • geo - calculate bbox in projected coordinates
  • docs - proj - mention that Geodetic methods can also do bbox
  • geo - geometry - bbox function
  • docs - geomap - destroy method
  • geo - bbox - center function
  • geo - bbox - height/width function
  • geo - bbox - expandBy function
  • geo - bbox - scaleBy function
  • geo - bbox - reaspect function
  • docs - geomap - drawStyle option
  • geomap - [bug] shapeStyle not maintained after resize
  • geomap - [bug] second drag while in inertial pan causes map to jump back
  • geomap - drawPoint mode
  • geomap - drawLineString mode
  • geomap - refreshShapes should check bbox cache before drawing
  • geomap - drawPolygon mode
  • geomap - port zoom mode
  • geomap - port shift-zoom mode for pan & draw modes
  • geo - geometry - distance function
  • examples - distance
  • geomap - rename getPixelSize to just pixelSize
  • geomap - [bug] zoom method doesn't work with shingled map
  • geomap - store service state data as jQuery data on serviceContainer element
  • geo - geometry - contains function
  • geomap - rename service.visible to visibility having either "visible" or "hidden" values
  • geo - geometry - centroid function
  • geomap - make service id property optional, add HTML id to serviceContainer if present
  • geomap - append should cache the shape's bbox (instead of the bbox function)
  • geomap - remove should remove the shape's bbox cache
  • geomap - empty should remove the bbox cache for all shapes
  • geomap - make the refresh argument in append public, add one to remove & empty
  • geomap - disable shape redraw during interactive zoom if more than 255 shapes
  • geomap - [bug] shape bbox culling hides shapes that are partially on screen & should be drawn
  • docs - geomap - make pixelSize a read-only option instead of a function
  • geomap - make pixelSize a read-only option instead of a function
  • docs - geomap - make shapeStyle an option
  • geomap - make shapeStyle an option
  • examples - rewrite shapeStyle example

1.0a2.5 (2011-08-03)

  • geomap - find - [bug] does not handle GeoJSON features
  • geomap - find - allow for 0 pixel tolerance
  • geomap - find - check for bbox on non-Point geometries before getting too specific
  • geo - bbox - cache shape bboxes
  • docs - do not suggest that it's ok to change the geometry now that we're caching bbox
  • geomap - jsperf test of bbox query vs. geom query on point data
  • geographics - [bug] 0 opacity acts as full opacity
  • geomap - add opacity to service type objects & call from geomap's opacity method
  • geomap - add toggle to service type objects & call from geomap's toggle method
  • geo.proj - update bundled web mercator projection code (removed 150 lines of code)
  • geomap - auto-handle window resize events
  • docs/geomap - scale map according to cursor location instead of re-centering during double-click zoom
  • geomap - iOS - [bug] second tap can be anywhere & cause a zoom
  • geomap - shingled - [bug] map doesn't resize correctly
  • examples - geomap drawStyle option

1.0a2 (2011-06-29)

  • geomap - Support dynamic map services
  • geomap - [BUG] geomap causes a script error if jQuery UI is already included
  • docs - Document shape methods
  • geomap - [BUG] Port of soft double-click does not work
  • geomap - [BUG] Cannot see dev-supplied inner content if not set to rel/abs position
  • geomap - Add mobile test page
  • geographics - Port graphic code from internal control
  • geomap - Implement append method
  • geographics - drawArc should use style's width and height and only take center as an argument
  • geomap - Document and implement the public refresh method
  • geomap - Implement shapeStyle method
  • geographics - Draw points as rounded rectangles via width, height & borderRadius properties on shapeStyle, drop oval functionality
  • geomap - Remove the pixels property from position events and add the type property to make the event argument a true GeoJSON Point
  • proj - support up to four dimentional array to convert MultiPolygon coordinates in one shot
  • proj - add functions to convert individual positions that developers can re-implement for their own projection
  • geomap - implement remove method
  • geomap - implement find method
  • geomap - [bug] toPixel should round pixel values
  • geomap - [bug] GeometryCollection shapes do not draw with their parent shape's style
  • geomap - implement empty method

1.0a1 (2011-05-09)

  • docs - Document a new interface to our internal map control
  • geomap - Port interactive map widget base to jQuery UI widget factory
  • geomap - Support tiled map services

License

Copyright (c) 2012 Applied Geographics, Inc. Project lead by Ryan Westphal Licensed under the MIT, GPL licenses.

Something went wrong with that request. Please try again.