UrMap API Blog

UrMap API團隊將進行UrMapExt API的開發，本API的目的是要將UrMap API發揮的淋漓盡致，因此想召集大家的創意，若您在使用API上有任何的常用的功能可以獨立成元件或function也歡迎分享，有任何建議也歡迎提出。

目前規劃的功能：

• 在地圖上放flash物件。
• 地標可以拖拉。
• 地圖縮放動畫效果。

1.09 版 API 的新功能如下：

1. 改善 IE7 使用衛星地圖時的效能
2. 解決 IE 中無法列印 UPolyline 的 bug
3. 解決地圖列印時，zoombar 會留白的 bug
4. 調整地圖框選模式(U_BOX_ACTION)，當框選完畢時框框不會直接消失，要等使用者 click 地圖或移動地圖之後才會消失
5. UMap 類別新增 mousedown、mouseup、mousemove 等監聽事件的支援
6. UMap 類別新增 transformLatLngToContainerCoordinates 函式，可將地圖坐標轉換為螢幕坐標
7. UMarker 類別新增 mousedown、mouseup 等監聽事件的支援
8. UMap 及 UMarker 類別新增 removeListener、clearListeners 兩種取消註冊監聽函式的新函式
9. 新增 UPolygon 多邊形類別支援，可於地圖上套疊任意多邊形物件
   
10. 新增 UCircle 圓形類別支援，可於地圖上套疊圓形物件
    

以上新增功能的詳情請參考API 說明文件

經過三週的測試期，1.06 版 API 於今日起正式成為預設的 API 版本，嵌入時只需指定 v=1 即可。
要繼續使用 1.05 版 API 的網友請自行在嵌入語法中指定 v=1.05。

許多網友一直希望 UrMap 的解析度能提高，從 1.06 版起 UrMap API 中的向量地圖將開始支援到 Lv10 (也就是 UrMap 官網的第 11 層)，不過這僅限於向量地圖，衛星影像的部份仍然受限於原始衛星影像解析度的關係，僅支援 Lv0~9。
以下是 1.06 版 API 所增加的一些功能：

1. 修正 UMap.removeOverlay() 函式若傳入一個未被加入地圖中的 overlay 時會出錯的 bug。
2. 新增 Lv10 的向量地圖，若衛星影像或衛星地圖模式放大到 Lv10 時會自動跳回向量地圖模式。
3. 新增 UMap.enableDragging() 及 UMap.disableDragging() 函式，可設定地圖是否可以被滑鼠拖曳移動。
4. 新增框選操作模式(U_BOX_ACTION)，可以讓使用者用滑鼠在地圖上框選一塊矩形並透過程式得知其框範的坐標範圍。
   
   參考範例程式
5. 新增 UMap.showControls() 及 UMap.hideControls() 函式，可用來切換是否要顯示/隱藏地圖控制列。
6. 新增比例尺控制列(U_SCALE_CONTROL)，可以自動顯示比例尺。
   
7. UMarker 類別新增 mouseover Event，可用來偵測該地標是否有被滑鼠 mouse on。

請注意! 目前 getapi.jsp 預設會取得的 API 版本仍為 1.05 版，若要試用 1.06 版的 API，請將 getapi.jsp 後面的參數 v 指定為 1.06，即 getapi.jsp?v=1.06 即可。預計兩週後 1.06 版才會正式成為預設的 API，並且會在 Blog 中公告。

UrMap API 有一陣子沒推出新版了，其實應該說是站長偷懶了一陣子沒上來發布，因為之前一直在忙著幫 UrMap 首頁做改版，準備未來大幅推出新的功能。
言歸正傳，這次推出的 1.05 版主要有下列功能更新：

1. 修正過去 API 與 Safari 不相容的部份，如 double click、透明色等問題，目前 Safari 2.0 已完全相容於 1.05 版 API，至於 Safari 1.2 版就麻煩尚未升級的 Mac 族網友幫忙回報了(可以上 UrMap 網站試試是否所有功能均正常)。
2. 修正 UBounds.extend() 函式中的錯誤。
3. 新增 UBounds.getCenter() 函式，方便網友取得任意 Bounding Box 的中心點坐標。
4. 調整 UMap 的 click event 監聽行為，自 1.05 版起不論 user 有無 click 到 overlay(UMarker) 物件，在呼叫 listener 的 callback 函式時均會帶入 latlng 參數，也就是說無論何種情況下系統一定會把 click 位置的實際坐標值傳回。
5. 新增 UMap.transformContainerCoordinatesToLatLng() 函式，可以用來將地圖畫面的 container 螢幕坐標轉成實際的經緯度坐標。
6. UMap 類別新增測距模式，只要搭配 UMap.setMapAction() 與 UMap.getMeasureDistance() 函式即可使用。
7. 新推出 UPolyline 類別，可以用來在地圖上加入 polyline 線型物件，例如測距功能以及新版 UrMap 的導航路線均是使用 UPolyline 畫出來的。

以上各項新功能的詳細使用方式請見 API 說明文件。

1.03 版的推出主要是修正了先前一些網友所回報的 bug，並且提供了幾個好用的新函式，之前許多網友一直詢問是否有能自訂訊息視窗大小的函式也在這次一併推出了。以下是 1.03 版的主要變動內容：

1. 修正 UMap.zoomOut() 不能使用的問題
2. 修正同一時間有兩個造成地圖滑移事件的衝突情形
3. UMap 的 zoom event 修正為 zoom level 值改變之後才觸發
4. 呼叫 openInfoWindow() 時，訊息視窗不會再被地圖控制列擋住
5. 新增 UMap.checkResize() 函式，可在地圖 container 元件的大小改變時呼叫，讓地圖自動去 fit 新地圖視窗的大小

Read the rest of this entry 深入閱讀 »

這次所推出的 1.02 版，主要是新增了 UMarker 物件對 mouse on 訊息的支援(與 UrMap 網站所使用的類似，但更強大)，詳細的語法說明與使用範例請大家參考 API 網站的說明文件。
下面提供一張 screenshot 讓大家了解使用後的效果：

大家好，雖然 1.0 版才剛發佈三天，但是為了補足功能的完整性，1.01 版的 API 在 API 團隊不眠不休的趕工下正式於今天跟大家見面，以下是 1.01 版 API 的主要更新內容：

1. UMap 類別新增 addControl 函式，取代原有的 setControlType 函式(setControlType 暫時不會拿掉以相容於各位已開發的程式，未來請改為使用 addControl)，此一函式可用來在地圖中增加縮放工具列以及地圖/衛星切換工具列，如圖所示 詳細使用方式請見使用說明。
2. 增加下列三種控制列種類，可用於 addControl 函式：
   • U_TYPE_CONTROL，地圖類型控制列，可用來切換衛星影像及電子地圖
   • U_FULLZOOM_CONTROL，完整縮放控制列，包含放大縮小及每一顯示比例的按鈕，等於1.0版的 U_FULL_CONTROL
   • U_MINIZOOM_CONTROL，迷你縮放控制列，只包含放大縮小按鈕，等於1.0版的 U_MINI_CONTROL
3. 呼叫 openInfoWindow 函式時不會再自動做 centerMap 的動作，只有在訊息視窗會超出地圖顯示範圍時才會以滑動的方式將訊息視窗移進地圖內，與 Google Maps 的作法類似。
4. 新增 setMapType 函式，可以直接設定目前地圖要展現的模式，例如呼叫 setMapType(U_SATELLITE_TYPE) 可以將地圖切換為衛星模式，另外還有地圖模式(U_MAP_TYPE)與衛星地圖模式(U_HYBRID_TYPE)可以使用。(2/28補充)

1.01 版的 API 會自動套用到各位已開發的網頁上，各位不須更動原本取得 API 的語法。

我們很榮幸的在此宣佈 1.0 版的 UrMap API 於今天正式上線啟用，觀迎各位網友儘量提供使用感想與錯誤回報，如果您需要了解 UrMap API 的詳細功能，請參考 http://www.urmap.com/SearchEngine/api/documentation/ 的線上說明文件

歡迎來到 UrMap API 專屬的 Blog，我們希望藉由此 Blog 吸引台灣的電子地圖愛好者參與技術討論。在這裡您可以直接與 UrMap API 團隊溝通，不論是要提供建議、回報問題或是發表相關創作，我們都竭誠歡迎。

在此我們會提供下列服務：

• 新版本訊息發佈及更新內容說明
• 重大 API 問題討論與解答
• 介紹優良 API 應用網站

如果您尚未使用過 UrMap API，建議您立刻前往API 首頁申請一組授權碼，開始享受自行創作電子地圖的樂趣吧。