libs/js/jquery-geo-1.0a4/README

   1 == ABOUT ==
   2
   3 After years of internal development, we are pleased to bring our JavaScript map control to the open-source world in the form of a jQuery plugin.
   4
   5 == DOCS ==
   6
   7 Documentation is hosted at http://jquerygeo.com
   8
   9 News and updates via ryanttb on Twitter: https://twitter.com/ryanttb
  10
  11 == CHANGELOG ==
  12
  13 === 1.0a4 ===
  14 * geomap - [bug] changing the tilingScheme doesn't update pixelSize, maxPixelSize, center or centerMax
  15 * geomap - [bug] shingled services throw exception during resize
  16 * docs - geomap - axisLayout option
  17 * geomap - axisLayout option
  18 * docs - upgrade to jQuery Mobile rc3
  19 * docs - allow page refreshing
  20 * docs - geomap - more modes: measureDistance, measureArea, static
  21 * docs - geomap - append label argument
  22 * docs - geomap - toPixel/toMap should take all coordinate dimensions like the proj functions
  23 * geomap - toPixel/toMap should take all coordinate dimensions like the proj functions
  24 * geomap - move the drawing container instead of individual points during pan
  25 * geomap - [bug] drawStyle resets after window resize
  26 * geomap - append label argument
  27 * docs - geomap - measureLabels option
  28 * geomap - measureLabels option
  29 * geomap - measureDistance mode
  30 * geomap - measureArea mode
  31 * docs - geomap - service-level shapeStyle
  32 * docs - geomap - getUrl string option
  33 * geomap - [bug] create doesn't clear drawing shapes
  34 * docs - geomap - service-level shapes
  35 * docs - geo - detect geodetic coordinates and call $.geo.proj automatically, don't require devs to set $.geo.proj to null
  36 * docs - geomap - add projection section explaining how bbox & center affect map unit type
  37 * docs - geomap - rename getUrl to src
  38 * docs - geomap - scroll option
  39 * docs - geomap - pannable option
  40 * geomap - src string option
  41 * examples - string service src
  42 * geomap - [bug] map tracks mouse when not panning if click on other elements
  43 * geomap - pannable option
  44 * geomap - scroll option
  45 * geomap - [bug] shapesContainer is being cleared twice during mouse wheel zoom
  46 * geomap - support pinch zoom on iOS
  47 * docs - geo - add recenter function for bbox
  48 * geomap - static mode
  49 * docs - geomap - allow Deferred or Promise as return value from src function
  50 * geomap - [bug] widget factory merges first service with default sometimes causing exceptions with shingled services
  51 * geomap - allow Deferred or Promise as return value from src function
  52 * geomap - [bug] resize event triggered too many times during resize
  53 * geomap - service-level shapes
  54 * geomap - service-level find
  55 * geographics - add a resize method, call from geomap.resize
  56 * geo - add recenter function for bbox
  57 * geomap - [bug] errors creating second un-tiled map after destroying a first on same element
  58 * geomap - refresh shouldn't request new images if the map element is hidden
  59 * geomap - [bug] delayed multitouch isn't nearly as smooth as true multitouch
  60 * geomap - [bug] tiled pinch zoom isn't smooth
  61 * geo - detect geodetic coordinates and call $.geo.proj automatically, don't require devs to set $.geo.proj to null
  62 * geomap - [bug] mouse wheel doesn't work with jQuery 1.7
  63 ** upgrade to latest jquery.mousewheel plugin
  64 * geomap - service object visibility and opacity options should be moved to a style property
  65 * geomap - use _currentServices in all functions unless we actually need to update the public options services object
  66 * geomap - don't change user's service objects in opacity/toggle
  67 * geomap - show attr text
  68 * docs - geomap - selector argument to find method
  69 * geomap - selector argument to find method
  70 * geomap - pan mode should use a hand cursor by default
  71 * geomap - [bug] only services that have finished refreshing move when the user pans
  72 ** for a4: hide unfinished services
  73 * geomap - [bug] a user can mess with the center option, e.g., convert numbers to strings, and it can wreck havoc with map state
  74 * geomap - [bug] zoom option doesn't return proper values for shingled services
  75 * geomap - [bug] non-tiled maps can zoom out past zoom 0
  76 * geomap - don't request tiles that are -y index
  77 * geomap - [bug] initializing tiled map by non-geodetic bbox always causes zoom level 0
  78 * docs - geomap - empty string needed for label element
  79 * geomap - [bug] double tap to end shapes adds two points before ending the shape, in different places
  80 * geomap - [bug] lifting fingers after pinch zoom in drawLineString or drawPolygon modes sometimes adds fake visual coordinate on touch point last lifted
  81 * docs - upgrade to jQuery 1.7.1
  82 * geomap - [bug] scroll=off doesn't zoom map but also doesn't allow document scroll
  83 * geomap - [bug] changing mode does not reset measure drawing
  84 * geomap - [bug] jQuery UI Widget Factory no longer passes pageX & pageY event properties during _trigger when using jQuery 1.7
  85 ** upgrade to Widget Factory 1.8.17
  86 * examples - all demo (shingled)
  87 * docs - geomap - custom modes
  88 * examples - all demo (tiled)
  89
  90 === 1.0a3 ===
  91 * docs - geomap - more modes: zoom, drawPoint, drawLineString, drawPolygon
  92 * geomap - [bug] tiles do not show when pixel sizes are near or lower than 1.0
  93 * geo - cache bbox as geoBbox to match namespacing convention started by jQuery Mobile
  94 * docs - geo - initial bbox operations: center, height/width, expandBy, scaleBy & reaspect functions
  95 * docs - geo - initial geometry operations: bbox, distance, contains, centroid
  96 * docs - geomap - shape event
  97 * docs - geomap - refresh argument in append, remove & empty
  98 * docs - geomap - document the resize method
  99 * docs - launch jquerygeo.com
 100 * docs - upgrade to jQuery Mobile b3
 101 * docs - services - remove id property, explain the class property
 102 * docs - rename getPixelSize to just pixelSize
 103 * docs - services - change visible to visibility so it matches shapeStyle & CSS
 104 * docs - geomap - allow child selector syntax to target service elements with toggle & opacity methods
 105 * geomap - split servieTypes to different files
 106 * geomap - add data-geo-service to all service container elements, set to type of service
 107 * geomap - add data-geo-map to map divs initialized with geomap, remove on destroy
 108 * geomap - allow child selector syntax to target service elements with toggle & opacity methods
 109 * geomap - [bug] toggle does not refresh the map services being shown for the first time
 110 * geomap - [bug] destroy keeps window resize handler
 111 * geomap - [bug] destroy erases content originally inside map div
 112 * geomap - serviceType objects' destroy method isn't being called
 113 * geomap - [bug] destroyed geomaps remember appended shapes
 114 * docs - geomap - zoom method
 115 * geomap - zoom method
 116 * geo - calculate bbox in projected coordinates
 117 * docs - proj - mention that *Geodetic methods can also do bbox
 118 * geo - geometry - bbox function
 119 * docs - geomap - destroy method
 120 * geo - bbox - center function
 121 * geo - bbox - height/width function
 122 * geo - bbox - expandBy function
 123 * geo - bbox - scaleBy function
 124 * geo - bbox - reaspect function
 125 * docs - geomap - drawStyle option
 126 * geomap - [bug] shapeStyle not maintained after resize
 127 * geomap - [bug] second drag while in inertial pan causes map to jump back
 128 * geomap - drawPoint mode
 129 * geomap - drawLineString mode
 130 * geomap - refreshShapes should check bbox cache before drawing
 131 * geomap - drawPolygon mode
 132 * geomap - port zoom mode
 133 * geomap - port shift-zoom mode for pan & draw modes
 134 * geo - geometry - distance function
 135 * examples - distance
 136 * geomap - rename getPixelSize to just pixelSize
 137 * geomap - [bug] zoom method doesn't work with shingled map
 138 * geomap - store service state data as jQuery data on serviceContainer element
 139 * geo - geometry - contains function
 140 * geomap - rename service.visible to visibility having either "visible" or "hidden" values
 141 * geo - geometry - centroid function
 142 * geomap - make service id property optional, add HTML id to serviceContainer if present
 143 * geomap - append should cache the shape's bbox (instead of the bbox function)
 144 * geomap - remove should remove the shape's bbox cache
 145 * geomap - empty should remove the bbox cache for all shapes
 146 * geomap - make the refresh argument in append public, add one to remove & empty
 147 * geomap - disable shape redraw during interactive zoom if more than 255 shapes
 148 * geomap - [bug] shape bbox culling hides shapes that are partially on screen & should be drawn
 149 * docs - geomap - make pixelSize a read-only option instead of a function
 150 * geomap - make pixelSize a read-only option instead of a function
 151 * docs - geomap - make shapeStyle an option
 152 * geomap - make shapeStyle an option
 153 * examples - rewrite shapeStyle example
 154
 155 === 1.0a2.5 (2011-08-03) ===
 156 * geomap - find - [bug] does not handle GeoJSON features
 157 * geomap - find - allow for 0 pixel tolerance
 158 * geomap - find - check for bbox on non-Point geometries before getting too specific
 159 * geo - bbox - cache shape bboxes
 160 * docs - do not suggest that it's ok to change the geometry now that we're caching bbox
 161 * geomap - jsperf test of bbox query vs. geom query on point data
 162 * geographics - [bug] 0 opacity acts as full opacity
 163 * geomap - add opacity to service type objects & call from geomap's opacity method
 164 * geomap - add toggle to service type objects & call from geomap's toggle method
 165 * geo.proj - update bundled web mercator projection code (removed 150 lines of code)
 166 * geomap - auto-handle window resize events
 167 * docs/geomap - scale map according to cursor location instead of re-centering during double-click zoom
 168 * geomap - iOS - [bug] second tap can be anywhere & cause a zoom
 169 * geomap - shingled - [bug] map doesn't resize correctly
 170 * examples - geomap drawStyle option
 171
 172 === 1.0a2 (2011-06-29) ===
 173 * geomap - Support dynamic map services
 174 * geomap - [BUG] geomap causes a script error if jQuery UI is already included
 175 * docs - Document shape methods
 176 * geomap - [BUG] Port of soft double-click does not work
 177 * geomap - [BUG] Cannot see dev-supplied inner content if not set to rel/abs position
 178 * geomap - Add mobile test page
 179 * geographics - Port graphic code from internal control
 180 * geomap - Implement append method
 181 * geographics - drawArc should use style's width and height and only take center as an argument
 182 * geomap - Document and implement the public refresh method
 183 * geomap - Implement shapeStyle method
 184 * geographics - Draw points as rounded rectangles via width, height & borderRadius properties on shapeStyle, drop oval functionality
 185 * geomap - Remove the pixels property from position events and add the type property to make the event argument a true GeoJSON Point
 186 * proj - support up to four dimentional array to convert MultiPolygon coordinates in one shot
 187 * proj - add functions to convert individual positions that developers can re-implement for their own projection
 188 * geomap - implement remove method
 189 * geomap - implement find method
 190 * geomap - [bug] toPixel should round pixel values
 191 * geomap - [bug] GeometryCollection shapes do not draw with their parent shape's style
 192 * geomap - implement empty method
 193
 194 === 1.0a1 (2011-05-09) ===
 195 * docs - Document a new interface to our internal map control
 196 * geomap - Port interactive map widget base to jQuery UI widget factory
 197 * geomap - Support tiled map services