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");