2011-07-11

[轉載] Google Maps嵌入參數

為了製作 Blogger 上的地圖呈現,找到一篇詳細參數說明的翻譯,雖然可用的選項不多,但留著以後方便查。


轉載自:Google Maps嵌入参数
原文:http://mapki.com/wiki/Google_Map_Parameters


一般性的內容

q=
這是最常用的參數。

查詢- 所有被傳入這個參數的內容會被象maps.google.com中的查詢輸入框中所輸入的內容一樣被處理,特別是:

  • 要查找的精確地址,標記點或者在某個特殊點上顯示的信息框。
    • 提示:在附近不能有類似或者著名的地點的查詢值才是可靠的。例如,給出一個會議通知,告訴人們去128號門牌號碼的地點,但是只能在街區信息中發現一個12-8的位置(比如6/2010,誰會知道它以後會被匹配到什麼信息? )
  • 城鎮名字,或者前面的部分郵政編碼,會顯示到標記或者信息框裡。
  • 由緯度和經度信息指定的位置,用十進制形式,比如(52.123N,2.456W或52.123,-2.456),或者採用度/分/秒來表示(52 7 22.8N,2 27 21.6W或52 7 22.8,-2 27 21.6),或者度和分(52 7.38N,2 27.36W或52 7.38,-2 27.36)。
  • 在信息窗口和側邊欄中以粗體顯示的文本內容,增加括號()。你可以在不希望斷行的的時候使用%A0防止斷行發生。你還可以在行尾增加足夠多的%A0,並在後面跟一個空格(在URL中使用+號)來強制產生斷行。例子如原文指出:URL: http://maps.google.com?q=New+ York,+NY+(Mapki%A0is%A0a%A0very%A0good%A0Wiki%A0for%A0Google%A0Maps!%A0%A0%A0%A0%A0%A0%A0%A0+The%A0previous%A0line%A0is%A0now% A0sufficiently%A0long!)
  • to和from需要激活駕駛線路規劃功能。
  • 關鍵字near和loc:會激活本地搜索功能。
  • 兩個街之前可以用空格&空格形式,但是在URL裡需要使用+%26%或%20%26%20,而不是+&+或+&+。
  • 需要指出的是+號,其實它與,號的作用相同。
  • 位置信息也可以由在@符號後的十進制形式來表達,如(@52.123,-2.456)。這個方式應該會自動給出一個較低的縮放比例。使用這種格式會影響到查詢的其它參數。 @符號,而不是near或者loc:可以形成單一的查詢結果。而其它的方式可能返回數以千計的結果。
  • q=10+Downing+Str+is+not+here@51.50335,-0.227721
    可以在指定的地址放置一個自定義的提示標記,比如q=唐寧街10號不在這裡@51.50335,-0.227721。  

    • 這個標籤不能是國家的名字,或者沒有顯示出標記的時候。但是當給出座標的情況下,它可以是空白的。
  • 座標之外增加()標籤可以為Google地圖提供一些提示。
    1. http://maps.google.com/maps?q=24.197611,120.780512
      我們的位置正好在某被錯誤標識的知名地點附近。讀者應該可以注意到正確的綠色箭頭。
    2. http://maps.google.com/maps?q=Dan@24.197611,120.780512
      Dan標籤可以擴展成為某機場的名字(Danville Regional Airport)
    3. http://maps.google.com/maps?q=24.197611,120.780512+ (Dan)
      這種情況會安全一些。但是顯示的是一個黃色的標記。
    4. http://maps.google.com/maps?q=loc:24.197611,120.780512這是一個精確的地點表示。
  • 要注意用%表述非ASCII字符,比如(和)還有+是安全的,但是空格必須以%20表示。注意它們可能被用戶的瀏覽器解釋錯誤。
  • sky:前綴用來查詢由Sky產生的KML內容。這個參數是被Google Sky使用,並產生KML輸出。
  • 包含GeoRSS數據的Google Earth .KML/.KMZ文件或者RSS輸出的完整URL,可以被Google Earth使用,裡麵包含的信息可以被顯示在地圖上。

near=
可以使用位置信息的一部分,而不是像q=參數那樣輸入全部信息。

g=
這是一個給q參數提供額外上下文信息的地址或位置。 Google Maps在這裡自己用來保存上一次運行的搜索。注:如果這是第一次運行,它將包含你所開始的位置信息。所以它有潛在的信息洩露的風險,你需要檢查你是否真的明白並且要分享這個參數所對應的信息。


Search Mode/查詢模式

  • mrt=指出查詢的類型(空白表示所有內容-缺省)
    • mrt=all值為all指出查詢所有內容。
    • mrt=loc值為loc指出是進行位置信息查詢,它需要q=參數。
    • mrt=yp值為yp指出是商業查詢(即:黃頁),它也需要q=信息,一般情況下是位置信息。
    • mrt=websearch值為websearh指出映射的web頁面。這些網頁通過GoogleBot能夠指出地理位置信息。
    • mrt=realestate值為realstate為固定資產查詢。
    • mrt=ds值為ds時為相關的地圖。 Google的GeoRSS源索引(可能是KML?)
  • start=start=參數會跳過前(start-1)個匹配結果。
  • num=num=參數顯示,最多這個數量的匹配結果。合法的範圍是0到20(但是0有點沒有用處)。

Location/位置信息

  • ll= 顯示地圖時中心點的緯度、經度信息。要注意次序。而只接受十進制數值格式才可以。
    如果使用了這個參數但是沒有使用查詢,那麼地圖就以這個點為中心點顯示,但是沒有標記或信息窗口顯示。
  • sll=
    商業查詢執行時指定的點的緯度和經度。你可以使用它來執行一個偏離中心的商業搜索。 Google使用它,所以在執行完一個商業查詢後,中心移動後可以使用“鏈接到此頁”來記錄地圖位置。使用<math>map.getBounds().getSouthWest().toUrlValue()</math>將返回與maps.google.com相同的結果。
  • spn=spn=大致的經緯區域。如果沒有指縮放參數z=,那麼將調整縮放水平到一個合理的數值。
  • sspn=
    屏幕區域,計算方法:
    <math>new GLatL​​ng(map.getBounds().getNorthEast().lat() – map.getBounds().getSouthWest().lat(), map.getBounds().getNorthEast().lng() – map .getBounds().getSouthWest().lng()).toUrlValue()</math>
  • latlng=這是一個奇怪的參數。它有3個由,號分隔的數字。前兩個數字(大概相當於緯度和經度的100000倍)被忽略。第三個數字似乎是Google內部用來處理特殊業務的企業ID。比如latlng=0,0,14944637421527611642代表Blackpool社區教堂。指定此參數會執行一個針對該業務面頁的Google搜索,並顯示一個小地圖。其它參數,特別是q=參數,必須是有效的內容(但不一定涉到目標業務)。
  • cid= Similar to latitude and longitude, but generating a different map size.
    這個值似應該是地點的編號。原文的表述與latlang重複。
  • geocode=
    geocode值似乎是在線路規劃時各關鍵點的編碼。每個geocode之間使用%3B來分隔。
  • radius=在指定半徑內採用本地化信息。需要sll參數指定信息或者類似中心點位置才能使用。單位會採用英里,但是在公制國家可能會採用公里。這個參數有助預防Google結果遠離了結果城市,並讓它被限制在指定區域。

Map Display/地圖顯示

  • t=地圖類型。 m=>常規地圖,k=>衛星地圖,h=>混合地圖,p=>地域地圖,e=>GoogleEarth
  • z=縮放級別,取值範圍1~20。1比例尺最大,20比例尺最小。
  • layer=激活圖層。目前t表示交通情況。
  • lci=激活可以層疊的圖層。用,號分隔。
    • com.panoramio.all 來自Panoromio的圖片
    • com.youtube.all來自YouTube的視頻
    • org.wikipedia.en維基百科(英文)
    • com.google.ugc.c752d13e87c4fbd7來自Webcams.travel的網絡攝像頭。
    • transit公共交通
    • bike自行車線路
  • view=這個參數在測試的時候沒有看出分別。

Directions/路徑規劃

  • saddr= 出發點地址。
  • daddr=目標地址。
    “+to:” 可以使用+to:子句增加多地點線路規劃時的目標地址信息,比如daddr=大石洞村+to:馬欄廣場+to:棠梨溝
  • mra ?? 此參數涵義未知,可能的取值:dm/dpe/cc/ls…
  • mrcr ??此參數涵義未知,可能的取值:0
  • mrsp解析座標到街名。
    • mrsp=0打開從座標解析街名
    • mrsp=1關閉從座標解析街名
  • mrad= 附加目標地址。如果你的行程有三個地點,你可以用saddr=,daddr=和mrad=表示,而不採用+to:子句。
  • dirflg 路線類型。
    • dirflg=h避免高速公路。
    • dirflg=t避免收費路段。
    • dirflg=r採用公共交通。僅在一些區域可用。還可以提出附加的時間信息。
    • dirflg=w步行方式。仍在測試狀態。
    • dirflg=b騎行方式。僅在某些區域可用,仍在測試狀態。
  • via=用,號分隔的經由地址。
  • doflg=距離單位。缺省的是國家的法定標準。
    • doflg=ks ??這個真不知道。
    • doflg=ptk輸出距離單位顯示為公里。
    • doflg=ptm輸出距離單位顯示為英里。
  • ttype= 時間類型。在dirflg=r的狀況下採用公共交通工具的時候date和time參數的解析類型。  
    • ttype=now現在就出發,這個會忽略date和time參數。
    • ttype=dep 出發時間。
    • ttype=arr 到達時間。
  • date= 出發/到達日期,格式mm/dd/[yy]yy。由ttype決定是哪個日期。
  • time= 出發/到達時間,格式hh:mm am|pm。由ttype決定是哪個時間。
  • sort= 公共交通線路的排序 
    • sort=def缺省的排序方式。最快的行程優先。
    • sort=num最少的換乘優先。
    • sort=walk最少的步行優先。
  • start=與搜索模式很像,選擇第n個結果。

Street View/街景

  • cbll= Latitude,longitude for Street View.街景的經緯度信息。
  • cbp= Street View window that accepts 5 parameters街景窗口可以接受5個參數:
    1. 街景/地圖安排,11=上半部街景,下半部地圖,12=大部分是街景顯示,角部為可以調整角度的地圖
    2. 移軸角度,範圍是-90到90度。
    3. 縮放範圍,0~2
    4. 斜度(採用度數表示),-90~90,缺省值是5
  • panoid=這裡的ID是附近的全景對象的ID。全景對象採用可以點擊的小箭頭,你可以移動到下一個對象。

Output Control/輸出控制

  • hl=主機語言。僅支持一部分語言,如hl=fr表示法語
  • om=這個參數指定下方縮略圖是否顯示。如果指定一個1以外的值,縮略圖會關閉。 (經過測試1,2會顯示)。如果參數會被省略或者指定了值1,則顯示。
  • ie=指定輸入的字符編碼,比如ie=UTF8。
  • oe=指定輸出的字符編碼,比如oe=UTF8。
  • output=指定輸出格式,空白(缺省值)是標準的網頁格式。  
    • output=html在整合到Google地圖前使用舊風格的Google本地頁面格式,顯示小地圖和大的邊欄風格。
    • output=js輸出Google地圖使用的JavaScript對象和函數調用,包括駕駛線路的多邊形編碼和HTML格式的場景信息。
    • output=kml輸出包含當前地圖信息的KML文件。
    • output=mobile針對移動設備的格式輸出。在地圖中央位置顯示一個簡單的紅色圖釘。所有的移動基於鏈接而不是鼠標的移動。
    • output=nl輸出Google Earth和Google Maps可以獲取NetworkLink信息的KML文件內容。
    • output=embed輸出可以嵌入到第三方網站的HTML內容。這個參數僅與加密的s=參數一塊工作,據推測可能是阻止顯示不可預知的內容。
    • output=dragdir返回JSON對象。此對象包括反向的地理位置編碼和針對給定saddr(線路開始點)和daddr(線路結束點)線路的多邊形編碼。
    • output=georss 針對當前地圖(可能僅適用於MyMaps)的GeoRSS輸出。
  • f=控制查詢表單的顯示風格。  
    • f=d顯示成路徑規劃表單(有兩個輸入框,始點、終點)
    • f=l此參數似乎沒有作用了。
    • f=q缺省的顯示方式,單一輸入框。
  • pw=激活打印模式,初始化打印。與原文不同,pw=1/2兩個值均可以。測試環境是Ubuntu 11.04+Google Chrome。
  • v= 如果指定了output=kml,則此參數指定kml的版本。缺省是2.0,如果想指定是2.2,則v=2.2。

提示信息窗口

信息顯示窗口就是漫畫書中的對話氣球框。


我的地圖

  • msa=參數目前應該沒有意義了。

雜項

  • vp= 這個參數會使Google地圖切換到版權服務模式。它以JavaScript格式返回所有者的版權信息而不是返回可以畫出地圖的html內容。 vp參數指出視圖位置(即地圖的中心位置)。版權服務僅在提供了spn=z=參數的情況下才可以工作。它們分別代表區域和縮放比例。一還有一些可選的參數,比如t=,它用來指出地圖的類型,key=用來指出站點用來執行查詢時所用到的API key。例如:http://maps.google.com/maps?spn=0.030372,0.068665&z=6&t=h& vp=53.859462,-3.038235
  • ftr=0 這個參數是用來關掉所有Google地圖實驗室特性的。當你遇到這些特性出現問題或者無法載入地圖,這個特性可能提供有用的途徑。使用這個參數之後,你需重新激活那些實驗室特性。比如訪問:http://maps.google.com/maps?ftr=0。這個鏈接會提示你關掉了哪些特性,並且會提示是否保存這種改變。
  • source= 未知。一個值是s_d,另一個是s_q。
  • noexp= 未知。其中一個值是0。
  • noal= 未知。其中一個可取值是0。
  • oi=nojs 在它合併到Google地圖之前使用舊風格的Google本地頁面格式,使用小地圖和大的邊條,就像前面指定output=html選項那樣。這個選項需要停止JavaScript的工作。

0 回應: