How to use Google Maps data within your mobile application
Note: You can find this article also on Forum Nokia Wiki: How to use Google Maps data in mobile applications
Today we’ll see how to use Google Maps data within a mobile application.
Google Maps offers REST services that allows accessing its data with simple HTTP requests, so we can easily integrate them within our mobile apps.
Signup for a Google Maps API key
First thing you must do is to signup on this page:
http://code.google.com/apis/maps/signup.html
Once done, you’ll get a key (a simple String) you’ll use for all your query to Google Maps services
Static maps
Standard Google Maps code is suited for web applications, since it includes alot of Ajax functionalities, that are not really useful if you’re building a mobile application. So, the solution is to use static maps service, that will allow us to retrieve single images, easily usable within our apps.
Static maps service supports different image formats (png32, gif, jpg) and customizable image size, so that we can get perfect images for all our needs. As an example, suppose we want to retrieve the location at:
- latitude: 41.867878
- longitude: 12.471516
We can simply retrieve this URL with an HTTP GET request:
http://maps.google.com/staticmap?center=41.867878,12.471516& format=png32&zoom=8&size=240x320&key=<API_KEY>
This way, we’ll get a PNG32 image, with a width of 240 pixels, and a height of 320, centered at point (41.867878,12.471516), and with a zoom level of 8 (zoom can go from 0 to a maximum level of 19).
Geocode an address
From Google Maps docs:
Geocoding is the process of converting addresses (like “1600 Amphitheatre Parkway, Mountain View, CA”) into geographic coordinates (like latitude 37.423021 and longitude -122.083739)
So, let’s assume we want to build an application that displays the address typed by our user. We should firstly geocode its address to geographics coordinates.
To do this, Google Maps offer another REST service easily accessible with simple HTTP requests.
Let’s say you want to geocode this address “Leicester Square, London”, then you’ll request this URL:
http://maps.google.com/maps/geo?q=Leicester%20Square,%20London &output=csv&key=<API_KEY>
and you’ll get this output:
200,6,51.510605,-0.130728
Where:
- the first number is a code, that in this case (200) means that geocoding has been successfull (for a full list of status codes you can see here: [1])
- the second number gives a measure of geocoding accuracy (from 0 to 9 – maximum accuracy)
- 3rd and 4th numbers represent latitude and longitude of the geocoded address, so these are the coordinate we’ll use to retrieve the map through the static map service we’ve seen before
As you can see, there is an ‘output’ parameter within the geocode request, and this means that we can choose the output format we prefer for our needs. Supported formats are:
- xml
- kml (same as xml, but with different Content-Type)
- json (not really useful for mobile apps)
- csv (comma separated values)
Proxy server, usage limits
Since your Google Maps API key is bound to a specific URL, to access map services you should setup a proxy server that will receive HTTP requests from your mobile application and forward them to Google Maps REST URLs, giving back Google responses to mobile clients.
Also, be aware that there is a limit to the number of requests (both for static maps and geocode service) you can do each day. For personal uses they’re more than enough, anyway consider this point if you plan to develop commercial services.
Google Maps J2ME API and sample application
Now, you want code right? Here it is:
- a J2ME class to access Google Maps REST services: http://wiki.forum.nokia.com/index.php/J2ME_Google_Maps_API
- a sample application using Google Maps data: http://www.jappit.com/index.php?page=emulator&midlet=google_maps
Francesco 4:37 pm on May 22, 2008 Permalink
Hi!
I’m trying to execute the code you posted on the Forum Nokia Wiki. I use the Sun Wireless Toolkit and the EsclipseME IDE.
I get the following exception when invoking the retrieveStaticImage method:
java.lang.IllegalArgumentException:
at javax.microedition.lcdui.ImmutableImage.(+11)
at javax.microedition.lcdui.Image.createImage(+40)
at GoogleMaps.retrieveStaticImage(+28)
…
could you help me?
thanks a lot,
francesco
pit 4:43 pm on May 22, 2008 Permalink
Hi Francesco,
this has probably something to do with illegal/corrupt data coming from server. If you try getting the map URL directly in your browser, does it work?
Also, which format are you using for your static maps?
Pit
Francesco 12:06 pm on May 23, 2008 Permalink
Hi Pit,
thanks for your fast answer. I tried to change the format for the static map to png16 (I was using png32) and it works
Now I have a problem with displaying the image: I can see just the first few pixels while the rest of the screen is black (width is alright, while the problem is with the height)
My code is pretty simple:
Image map = gMap.retrieveStaticImage(320, 240, lanLng[0], lanLng[1], 15, “png16″);
Form f = new Form(“Image”);
f.append(map);
display.setCurrent(f);
It is my first approach to midlets and I don’t really know what’s wrong. I also trying using canvas but I get the same result. Do you have any suggestion?
thanks again,
francesco
pit 10:58 am on June 9, 2008 Permalink
Hi Francesco,
sorry for the delay of my answer, but I totally missed your reply… :-/
Anyway, do you have this problem on emulators, or on real devices?
Pit
Olaseni 8:39 am on June 22, 2008 Permalink
Hi,
Please I need help in finding a source code for designing a map on mobile application, I intend using a scanned image for the map.
Paul 6:32 am on November 24, 2008 Permalink
Hi,
I’ve run into the same problem as Francesco. Only the first 50 or so pixels of the image from the top going down loads. This is in the emulator. Any thoughts on what may be happening would be much appreciated.
Thanks for the great guide.
IKP Lab 1:32 pm on January 21, 2009 Permalink
Try to use DataInputStream() and readFully(). That solved my problems which were the same like yours – approximately 50pix of the image were displayed on the screen. Hope it helps.
ravi 7:25 am on February 12, 2009 Permalink
i want to geocode in my midlet application can any one help me
Guzzler 1:24 am on February 17, 2009 Permalink
Hello,
Can you explain more the DataInputStream() and readFully() version?
I replaced the InputStream() with DataInputStream() instead. I don’t understand how to use the readFully().Can you post the altered code like the examples above?
I have the same problem with the black piece of the image. Thanks in advance.
Guzzler 1:36 am on February 17, 2009 Permalink
Nevermind. My mistake. Found it. Thanks a lot guys!
Ernesto 7:09 am on May 12, 2009 Permalink
Hello guys!!
Guzzler, can you tell us what was your problem, please??? Im gettin a NullPointerException. I changed as Francesco said to png16 but it doesn’t work for me. As the matter of fact I can get the image by the URL in the browser, but not in code.
Please can anybody help me out???
Preethi 5:42 pm on August 20, 2009 Permalink
Hi Ernesto,
Did you find a solution to your problem even i get the same exception …
startApp threw an Exception
java.lang.NullPointerException
Please help me to solve this problem…
vfede 4:59 pm on September 24, 2009 Permalink
Ciao jappit,
sto usando la tua ottima classe “GoogleMaps” del forum nokia per delle prove con J2ME, funziona tutto ma solo se tolgo tutte le var double e le sostituisco con int, altrimenti mi da un “Error preverifying class GoogleMaps”. sai indirizzarmi verso la soluzione del problema? come faccio riconoscere i double a J2ME? te ne sarei molto grato, grazie ^_^
vfede
Nilesh 1:02 pm on October 8, 2009 Permalink
Hello All;
I am Developing an Application to get current location on googleMap for that i got Api Key.
I am developing this application on wtk & eclipse Ganymede. I am getting Exception
java.lang.ArrayIndexOutOfBoundsException
at AT.RetrieveLocation.checkLocation(+288)
at AT.RetrieveLocation.run(+12)
thanks in Advance