docs/8.0/ayanova/docs/form-home-user-settings.md

@@ -15,6 +15,33 @@ This is the email address used to send AyaNova related information to the user b
 
 This setting is not required (except for notifications if used) and the default value for this setting is empty.
 
+
+## Map URL template
+This setting controls which mapping provider to use for viewing addressible objects online on a map.
+If nothing is set it will default to Google maps. 
+
+AyaNova supports either geographic coordinates (latitude, longitude) or address based online mapping support.
+
+Several online mapping providers are provided for selection in the drop down box below this field.  Selecting one of these providers will automatically fill in this field with the correct (at time of release) URL to use.
+
+You can also enter any url you wish in this field for specific needs not covered by the defaults.
+
+### map url format
+
+AyaNova expects one or two url's per provider separated with the following special sequence of characters: `<|>` to separate urls if there are two.
+
+You can have an Address based url and / or a geocoordinate based url as most map providers support one or the other.
+AyaNova will favor the geo-coordinate version if both are supplied.  
+
+AyaNova will substitute the following tokens in the URL template before attempting to open the map url in your browser:
+
+`{ayaddress}` This token will be substituted with the Address fields favoring physical address fields over postal ones.  The order the url is constructed from an address is Street address, city, region (state or province), country, postal code.  If any of those fields are empty it will attempt to use the Postal version.
+
+`{latitude}`, `{longitude}` These tokens will be used if filled in on the addressible objects entry form.
+
+Use the preset examples as a reference if making your own custom url.
+
+
 ## Currency code
 The Currency Code controls how currency values are displayed and accepted for input in AyaNova.