What it does

XBL component which is rendered as a Google Maps widget on the page. It is bound to an address, and optionally to a longitude/latitude. In essence:

• An initial location can be provided to the component. When provided, if found by the Google Maps API, a marker will be placed on the map at that location.
• If a lat/long is provided, it takes precedence over the address and the marker will be placed at that lat/long instead of at the address.
  
• The user can move the pin to choose another location. The lat/long for the new position of the marker will be stored.

Usage

You use the map component with:

• address-ref points to a node containing the address, as one string.
• longitude-ref and latitude-ref points to the nodes optionally containing the initial longitude and latitude. The initial value can be empty. If the marker is moved by the user, the longitude/latitude of the new position will be stored in those nodes.
• style used as-is on the <div> which contains the actual map. You will typically want to use that attribute to set the size of the map.

Google API configuration

If you wish to deploy a form using the map component (other than accessing your form with a URL such as http://localhost:8080/orbeon/...), you need to apply for a Google Maps API Key. After you obtained your key, indicate it in the following property that you add to your config/properties-local.xml:

If you use Google Maps Premier, you don't need to set the oxf.xforms.xbl.fr.map.key property, but you need the oxf.xforms.xbl.fr.map.clientid property instead:

NOTE: Set your client id without the leading gme- prefix.

When using Google Maps Premier, you can in addition enable SSL with the following property: