wimagguc / jquery-latitude-longitude-picker-gmaps

A jQuery plugin that creates a Latitude and Longitude picker using Google Maps.
http://www.wimagguc.com/
Other
152 stars 86 forks source link

jQuery Latitude and Longitude Picker for Google Maps

1.1.2

A jQuery Latitude and Longitude plugin to pick a location using Google Maps.

Supports multiple maps. Works on touchscreen. Easy to customize markup and CSS.

Check out the live demos.

Features

Basic functions

Map with location search field:

Map with reverse lookup:

Adjust latitude, longitude and zoom fields on the fly:

Before you start

To use the Maps JavaScript API and the Geocoding API, you must get an API key which you can then add to your website, or web server. The API key is used to track API requests associated with your project for usage and billing. https://developers.google.com/maps/documentation/javascript/get-api-key#get-an-api-key

Get started

Import jQuery and Google Maps (don't forget to change the Google Maps script import tag to include your API key):

  <script src="https://github.com/wimagguc/jquery-latitude-longitude-picker-gmaps/raw/master/js/jquery-2.1.1.min.js"></script>
  <script src="https://github.com/wimagguc/jquery-latitude-longitude-picker-gmaps/raw/master//maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&sensor=false"></script>

Import the plugin:

  <link rel="stylesheet" type="text/css" href="https://github.com/wimagguc/jquery-latitude-longitude-picker-gmaps/blob/master/css/jquery-gmaps-latlon-picker.css"/>
  <script src="https://github.com/wimagguc/jquery-latitude-longitude-picker-gmaps/raw/master/js/jquery-gmaps-latlon-picker.js"></script>

Add a HTML markup:

  <fieldset class="gllpLatlonPicker">
    <input type="text" class="gllpSearchField">
    <input type="button" class="gllpSearchButton" value="search">
    <div class="gllpMap">Google Maps</div>
    <input type="hidden" class="gllpLatitude" value="20"/>
    <input type="hidden" class="gllpLongitude" value="20"/>
    <input type="hidden" class="gllpZoom" value="3"/>
  </fieldset>

(See more options in the demos)

Customize default settings

If you want to modify the default parameters, you need to disable the auto-init procedure first. You can do this by adding the following code when importing the plugin scripts:

  <link rel="stylesheet" type="text/css" href="https://github.com/wimagguc/jquery-latitude-longitude-picker-gmaps/blob/master/css/jquery-gmaps-latlon-picker.css"/>
  <script>
    $.gMapsLatLonPickerNoAutoInit = 1;
  </script>
  <script src="https://github.com/wimagguc/jquery-latitude-longitude-picker-gmaps/raw/master/js/jquery-gmaps-latlon-picker.js"></script>

Then copy the init code from "jquery-gmaps-latlon-picker.js" and extend it. Here is an example:

<script>
  $(document).ready(function() {
    // Copy the init code from "jquery-gmaps-latlon-picker.js" and extend it here
    $(".gllpLatlonPicker").each(function() {
      $obj = $(document).gMapsLatLonPicker();

      $obj.params.strings.markerText = "Drag this Marker (example edit)";

      $obj.params.displayError = function(message) {
        console.log("MAPS ERROR: " + message); // instead of alert()
      };

      $obj.init( $(this) );
    });
  });
</script>

License

MIT, do-with-the-code-whatever-you-please License

This code uses the jQuery Javascript library and the Google Maps API. To read more about these, go to:

Special thanks

About

Richard Dancsi