LocationTextField | Vaadin


LocationTextField is an add-on that geocodes addresses using a configurable geocoder. Any class implementing org.vaadin.addons.locationtextfield.LocationProvider can be used to geocode addresses with LocationTextField.

At a minimum an instance of LocationProvider is necessary to use this add-on. There are currently two LocationProvider implementations provided; one using Google's geocoder and the other using OpenStreetMap's Nominatim. Adding new implementations is trivial. Results for the geocoded address are available to choose from in a drop-down menu.

Configuration can be done via typical setters or via the new fluent API in version 2.0.0+.

Note: It is the user's responsibility to make sure he or she abides by any rules or requirements for geocoder use. For instance, Google's geocoder will not even work unless it is used in a browser with GMaps in the DOM. OpenStreetMap has a usage limit upon which they will cut you off; however, MapQuest uses the OpenStreetMap code and has no limit. MapQuest should be added next.


Link to this version
StableReleased 15 April 2019Apache License 2.0
Framework Support
Vaadin 8.0+
Also supported:
Vaadin 6 (3.0.1)Vaadin 7 (2.1.8)
Browser Compatibility
Install with
Release notes - Version 3.0.2
  • Added 'key' parameter to Google Geocoder. This parameter is now REQUIRED by Google to use the geocoder.