https://github.com/bramus/google-maps-polygon-moveto

Programmatically move a google.maps.Polygon to a new google.maps.LatLng using Google Maps V3
https://github.com/bramus/google-maps-polygon-moveto

Last synced: 5 days ago
JSON representation

Programmatically move a google.maps.Polygon to a new google.maps.LatLng using Google Maps V3

• Host: GitHub
• URL: https://github.com/bramus/google-maps-polygon-moveto
• Owner: bramus
• License: mit
• Created: 2013-02-15T22:02:35.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2016-06-06T08:15:09.000Z (over 8 years ago)
• Last Synced: 2024-05-01T23:16:07.576Z (7 months ago)
• Language: JavaScript
• Homepage:
• Size: 4.88 KB
• Stars: 9
• Watchers: 6
• Forks: 6
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# google.maps.Polygon.moveTo()

Programmatically move a `google.maps.Polygon` to a new `google.maps.LatLng` using Google Maps V3

Built by Bramus! - [http://www.bram.us/](http://www.bram.us/)

## About

Since Google Maps v3.11 it's possible to move around a `google.maps.Polygon` by using the mouse _(if the `draggable` property is set to `true`)_. `google.maps.Polygon.moveTo()` is a Google Maps extension augmenting that functionality by allowing one to programmatically move a `google.maps.Polygon` on the map without any user/mouse interaction. The script works with both geodesic _(polygons that follow the curvature of the earth)_ and non-geodesic _(straight)_ polygons.

## Installation

* Include the scripts `js/google.maps.Polygon.getBounds.js` and `js/google.maps.Polygon.moveTo.js` in your HTML page

* Include the Google Maps script with the [Google Maps Geometry Library](https://developers.google.com/maps/documentation/javascript/geometry) included. You can do this by referencing `http://maps.googleapis.com/maps/api/js?v=3.exp&sensor=false&libraries=geometry`

## How to use

See the example. Basically just call `myPolygon.moveTo(new google.maps.LatLng(lat, lng))` to move the Polygon to the new Latitude/Longitude.

## Notes / Bugs

* Alas it's not perfect: Rounding errors occur _(You can see this best when moving a polygon with `geodesic` enabled to one location and then moving it back: you'll see that the shape seems to have tilted a bit)_

* When using non-geodesic polygons it's recommened to wrap `google.maps.Polygon#moveTo()` in a `setTimeout()` with a timing of `200` in order to have `google.maps.Map#getProjection()` available _(it's only available after the map has started rendering)_

## License

`google.maps.Polygon.moveTo()` is released under the MIT public license. See the enclosed `LICENSE` for details.