J2ME Google 地圖 API

這裡有一個簡單的函式庫來查詢Google地圖，它有下面的功能：

地理編碼定址到其地理座標
擷取給定尺寸、格式及畫面遠近的靜態圖片
這個API有一個實例，你可以在這裡檢查：Java ME Google Maps API sample MIDlet

Contents [hide]
1 取得你自己的Google地圖API Key
2 使用代理伺服器來存取Google地圖服務
3 原始碼：GoogleMaps 類別
4 地圖捲動的使用方法
5 原始碼：範例使用


取得你自己的Google地圖API Key
注意：用免費的Google地圖API Key的程式使用會違反Google的條款和條件 (10.8節)，假如你想要使用Google地圖API在上面的範例中，你應該購買企業許可證。

要使用下面的程式碼，你應該取得你自己的Google地圖API Key，假如你沒有API key，你只能照著下面的操作：如何在手機應用程式中使用Google地圖資料

使用代理伺服器來存取Google地圖服務
注意：這個主題(代理的使用)可能不需要，我們仍然探討一下..
當你註冊取得Google地圖API key時，你可以輸入位址，這個位址使用那個key能夠存取地圖服務，因此，你應該設定代理伺服器在那個位址上，這樣就能從你的行動用戶端收到HTTP請求，轉發給Google地圖服務，收回Google的回饋反應。

在下面的程式碼裡你應該發送下面的請求：

http://www.yourserver.com/geo 請求 http://maps.google.com/maps/geo
http://www.yourserver.com/staticmap 請 http://maps.google.com/staticmap
原始碼：GoogleMaps 類別
import java.io.ByteArrayOutputStream; import java.io.DataOutputStream; import java.io.IOException; import java.io.InputStream; import java.util.Vector; import javax.microedition.io.Connector; import javax.microedition.io.HttpConnection; import javax.microedition.lcdui.Image; public class GoogleMaps { private static final String URL_UNRESERVED = "ABCDEFGHIJKLMNOPQRSTUVWXYZ" + "abcdefghijklmnopqrstuvwxyz" + "0123456789-_.~"; private static final char[] HEX = "0123456789ABCDEF".toCharArray(); // these 2 properties will be used with map scrolling methods. You can remove them if not needed public static final int offset = 268435456; public static final double radius = offset / Math.PI; private String apiKey = null; public GoogleMaps(String key) { apiKey = key; } public double[] geocodeAddress(String address) throws Exception { byte[] res = loadHttpFile(getGeocodeUrl(address)); String[] data = split(new String(res, 0, res.length), ','); if (data[0].compareTo("200") != 0) { int errorCode = Integer.parseInt(data[0]); throw new Exception("Google Maps Exception: " + getGeocodeError(errorCode)); } return new double[] { Double.parseDouble(data[2]), Double.parseDouble(data[3]) }; } public Image retrieveStaticImage(int width, int height, double lat, double lng, int zoom, String format) throws IOException { byte[] imageData = loadHttpFile(getMapUrl(width, height, lng, lat, zoom, format)); return Image.createImage(imageData, 0, imageData.length); } private static String getGeocodeError(int errorCode) { switch (errorCode) { case 400: return "Bad request"; case 500: return "Server error"; case 601: return "Missing query"; case 602: return "Unknown address"; case 603: return "Unavailable address"; case 604: return "Unknown directions"; case 610: return "Bad API key"; case 620: return "Too many queries"; default: return "Generic error"; } } private String getGeocodeUrl(String address) { return "http://maps.google.com/maps/geo?q=" + urlEncode(address) + "&output=csv&key=" + apiKey; } private String getMapUrl(int width, int height, double lng, double lat, int zoom, String format) { return "http://maps.google.com/staticmap?center=" + lat + "," + lng + "&format=" + format + "&zoom=" + zoom + "&size=" + width + "x" + height + "&key=" + apiKey; } private static String urlEncode(String str) { StringBuffer buf = new StringBuffer(); byte[] bytes = null; try { ByteArrayOutputStream bos = new ByteArrayOutputStream(); DataOutputStream dos = new DataOutputStream(bos); dos.writeUTF(str); bytes = bos.toByteArray(); } catch (IOException e) { // ignore } for (int i = 2; i < bytes.length; i++) { byte b = bytes[i]; if (URL_UNRESERVED.indexOf(b) >= 0) { buf.append((char) b); } else { buf.append('%').append(HEX[(b >> 4) & 0x0f]).append(HEX[b & 0x0f]); } } return buf.toString(); } private static byte[] loadHttpFile(String url) throws IOException { byte[] byteBuffer; HttpConnection hc = (HttpConnection) Connector.open(url); try { hc.setRequestMethod(HttpConnection.GET); InputStream is = hc.openInputStream(); try { int len = (int) hc.getLength(); if (len > 0) { byteBuffer = new byte[len]; int done = 0; while (done < len) { done += is.read(byteBuffer, done, len - done); } } else { ByteArrayOutputStream bos = new ByteArrayOutputStream(); byte[] buffer = new byte[512]; int count; while ( (count = is.read(buffer)) >= 0 ) { bos.write(buffer, 0, count); } byteBuffer = bos.toByteArray(); } } finally { is.close(); } } finally { hc.close(); } return byteBuffer; } private static String[] split(String s, int chr) { Vector res = new Vector(); int curr; int prev = 0; while ( (curr = s.indexOf(chr, prev)) >= 0 ) { res.addElement(s.substring(prev, curr)); prev = curr + 1; } res.addElement(s.substring(prev)); String[] splitted = new String[res.size()]; res.copyInto(splitted); return splitted; } }
地圖捲動的使用方法
假如你需要捲動你的地圖，你將需要對你的靜態圖片計算一個新的中心，下面的adjust()方法傳回新的地圖中心的經緯度，接受以下的參數：

目前中心的經度及緯度座標
新地圖中心的deltaX及deltaY像素值
新地圖畫面遠近程度

原來的程式碼是用JavaScript寫的，可以在：http://www.polyarc.us/adjust.js下載

注意：如果你使用的是CLDP 1.0的話，要使用下面的方法，你必須將MicroFloat函式庫可在這裡下載：MicroFloat網站含括到你的專案裡，現在在CLDP 1.1已經支援float及double了！

public double[] adjust(double lat, double lng, int deltaX, int deltaY, int z){ return new double[]{ XToL(LToX(lng) + (deltaX<<(21-z))), YToL(LToY(lat) + (deltaY<<(21-z))) };}double LToX(double x){ return round(offset + radius * x * Math.PI / 180);} double LToY(double y){ return round( offset - radius * Double.longBitsToDouble(MicroDouble.log( Double.doubleToLongBits( (1 + Math.sin(y * Math.PI / 180)) / (1 - Math.sin(y * Math.PI / 180)) ) )) / 2);} double XToL(double x){ return ((round(x) - offset) / radius) * 180 / Math.PI;} double YToL(double y){ return (Math.PI / 2 - 2 * Double.longBitsToDouble( MicroDouble.atan( MicroDouble.exp(Double.doubleToLongBits((round(y)-offset)/radius)) ) )) * 180 / Math.PI;}double round(double num){ double floor = Math.floor(num); if(num - floor >= 0.5) return Math.ceil(num); else return floor;}
原始碼：範例使用

要使用這個類別，首先先用你的API金鑰：

GoogleMaps gMap = new GoogleMaps("API_KEY");
要地理編碼一個地址，你可以使用geocodeAddress()方法：

double[] lanLng = gMap.geocodeAddress("中壢市永泰街129號");
要擷取地圖圖像：

Image map = gMap.retrieveStaticImage(320, 240, 51.510605, -0.130728, 8, "png32");