Initial version with Mendix 5 features like snippets.

Author: RoelandSalij

.gitignore

@@ -0,0 +1,9 @@
+**/proxies/
+src/javasource/com
+src/javasource/system
+src/deployment/
+src/.classpath
+src/.project
+*.launch
+*.tmp
+*.lock

README.md

@@ -1,2 +1,22 @@
 # GoogleMapsModule
-Module utilizing the googlemaps api to determine coordinates based on an address. 
+Module utilizing the Google Maps api to determine coordinates based on an address. For licensing and terms using this Google API, please refer to the [Terms of Service](https://developers.google.com/maps/terms)
+
+## Contributing
+For more information on contributing to this repository visit [Contributing to a GitHub repository](https://world.mendix.com/display/howto50/Contributing+to+a+GitHub+repository)!
+
+## Typical usage scenario
+Determine latitude and longitude based on an address. With these coordinates it becomes possible to view a location on a Google map, using the Mendix Google Maps Widget.
+
+## Configuration
+The module contains snippets and example pages which you can use in your project. The example pages are excluded from the project by default in order to reduce the dependency on layouts (which might not be available in your project).
+You can find the Snippets in the '_Use me' folder in the project navigation. You can find the example pages in '_Example pages' folder in the project navigation.
+
+#### Snippets
+Copy the snippets which you would like to use to a page in your project.
+
+#### Example pages
+Copy the example pages which you would like to use in your project to a module in your project structure. (E.g MyFirstModule) Include the page in your project by right-clicking the page in the project navigation and clicking 'Include in project'.
+
+
+
+

src/Google Maps Widget.mpr

@@ -0,0 +1,65 @@
+// This file was generated by Mendix Business Modeler.
+//
+// WARNING: Only the following code will be retained when actions are regenerated:
+// - the import list
+// - the code between BEGIN USER CODE and END USER CODE
+// - the code between BEGIN EXTRA CODE and END EXTRA CODE
+// Other code you write will be lost the next time you deploy the project.
+// Special characters, e.g., é, ö, à, etc. are supported in comments.
+
+package googlemaps.actions;
+
+import com.mendix.core.Core;
+import com.mendix.systemwideinterfaces.core.UserAction;
+import googlemaps.actions.GeoCoder.Location;
+import java.io.IOException;
+import java.security.AccessControlException;
+import com.mendix.systemwideinterfaces.core.IMendixObject;
+import com.mendix.systemwideinterfaces.core.IContext;
+import com.mendix.webui.CustomJavaAction;
+
+/**
+ * 
+ */
+public class CalculateGeo extends CustomJavaAction<Boolean>
+{
+	private IMendixObject __locationObj;
+	private googlemaps.proxies.Location locationObj;
+	private String addressString;
+
+	public CalculateGeo(IContext context, IMendixObject locationObj, String addressString)
+	{
+		super(context);
+		this.__locationObj = locationObj;
+		this.addressString = addressString;
+	}
+
+	@Override
+	public Boolean executeAction() throws Exception
+	{
+		this.locationObj = __locationObj == null ? null : googlemaps.proxies.Location.initialize(getContext(), __locationObj);
+
+		// BEGIN USER CODE
+		Location loc;
+		
+		loc = GeoCoder.getLocation(addressString);
+				
+		locationObj.setLatitude(loc.lat);
+		locationObj.setLongitude(loc.lon);
+		
+		return true;
+		// END USER CODE
+	}
+
+	/**
+	 * Returns a string representation of this action
+	 */
+	@Override
+	public String toString()
+	{
+		return "CalculateGeo";
+	}
+
+	// BEGIN EXTRA CODE
+	// END EXTRA CODE
+}

src/javasource/googlemaps/actions/CalculateGeo.java

@@ -0,0 +1,105 @@
+package googlemaps.actions;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.net.URL;
+import java.net.URLEncoder;
+import java.security.AccessControlException;
+
+import org.json.JSONArray;
+import org.json.JSONObject;
+
+public class GeoCoder {
+	private final static String ENCODING = "UTF-8";
+	private final static String STATUS_OK = "OK"; //indicates that no errors occurred; the address was successfully parsed and at least one geocode was returned.
+	private final static String STATUS_ZERO_RESULTS ="ZERO_RESULTS"; //indicates that the geocode was successful but returned no results. This may occur if the geocode was passed a non-existent address or a latlng in a remote location.
+	private final static String STATUS_OVER_QUERY_LIMIT ="OVER_QUERY_LIMIT"; //indicates that you are over your quota.
+	private final static String STATUS_REQUEST_DENIED ="REQUEST_DENIED"; //indicates that your request was denied, generally because of lack of a sensor parameter.
+	private final static String STATUS_INVALID_REQUEST ="INVALID_REQUEST"; //generally indicates that the query (address or latlng) is missing.
+	private final static String STATUS_UNKNOWN_ERROR = "UNKNOWN_ERROR"; //indicates that the request could not be processed due to a server error. The request may succeed if you try again.
+	
+	
+	public static class Location {
+		public Double lon, lat;
+		
+		private Location (Double lat, Double lon) {
+			this.lon = lon;
+			this.lat = lat;
+		}
+		
+		public String toString() {
+			return "Lat: "+lat+", Lon: "+lon;
+		}
+	}
+	
+	public static Location getLocation (String address) throws IOException {
+		
+		StringBuilder sb = new StringBuilder();
+		Location location = null;
+		
+		
+		BufferedReader in = new BufferedReader (
+			new InputStreamReader (
+				new URL ("https://maps.googleapis.com/maps/api/geocode/json?address="+URLEncoder.encode (address, ENCODING)+"&sensor=false")
+				.openStream ()
+			)
+		);
+		String line;
+		
+		int statusCode = -1;
+		while ((line = in.readLine ()) != null) {
+			sb.append(line);	
+		}
+		
+		in.close();
+				
+		
+		JSONObject json = new JSONObject(sb.toString());
+		
+		JSONArray jsonresults = (json.getJSONArray("results"));
+		
+		String  jsonstatus = (json.getString("status"));
+		
+		if(jsonstatus.equals(STATUS_OK))
+		{
+		
+			if(jsonresults.length()>0)
+			{
+			
+				JSONObject jsongeometry = (jsonresults.getJSONObject(0).getJSONObject("geometry"));
+				
+				if(!jsongeometry.equals(null))
+				{
+					JSONObject jsonlocation = (jsongeometry.getJSONObject("location"));
+				
+					location = new Location (
+							(jsonlocation.getDouble("lat")),
+							(jsonlocation.getDouble("lng")));
+				}
+			}
+		}
+		else{
+			if(jsonstatus.equals(STATUS_OVER_QUERY_LIMIT)) throw new IOException("GEOCODE request failed: you are over your quota");
+			else if(jsonstatus.equals(STATUS_ZERO_RESULTS)) throw new IOException("The geocode request was successful but returned no results");
+			else if(jsonstatus.equals(STATUS_REQUEST_DENIED)) throw new IOException("The geocode request is denied");
+			else if(jsonstatus.equals(STATUS_INVALID_REQUEST)) throw new IOException("The geocode request is invalid (generally indicates that the query (address or latlng) is missing)");
+			else if(jsonstatus.equals(STATUS_UNKNOWN_ERROR)) throw new IOException("The geocode request was not succesfull due to a google server error. The request may succeed if you try again.");
+		}
+		
+		if (location == null) {
+			switch (statusCode) {
+				case 400: throw new IOException ("Bad Request");
+				case 500: throw new IOException ("Unknown error from Google Encoder");
+				case 601: throw new IOException ("Missing query");
+				case 602: throw new IOException ("Address could not be found");
+				case 603: throw new IOException ("Legal problem");
+				case 604: throw new IOException ("No route");
+				case 610: throw new IOException ("Bad key");
+				case 620: throw new IOException ("Too many queries");
+			}
+		}
+		return location;
+		
+	}
+}