搭配 Map Tiles API 使用工作階段符記

工作階段權杖是一組資料 (UUID)，用於在 REST 呼叫中識別工作階段，也就是一系列相關訊息交換。您必須在所有 2D 圖塊和街景圖像要求中加入工作階段權杖。您將其新增為所有要求的 session 參數值 網址。

在 Map Tiles API 中，工作階段符記代表一組定義的 顯示選項。換句話說，您不必同時 。您可以在多個用戶端使用相同的工作階段符記。 工作階段符記的有效期限為兩週後 但這可能會改變您隨時可以查看 查看回應訊息中的 expiry 欄位，藉此取得工作階段符記。

工作階段符記要求

如要要求工作階段權杖，請將 HTTPS POST 要求傳送至 createSession 端點，如以下範例所示。請務必在傳送要求時加上 Content-Type: application/json 標頭。

curl -X POST -d '{
  "mapType": "streetview",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

必填欄位

mapType

基本地圖的類型。這個值可以是下列其中一項：

roadmap
標準 Google 地圖繪製地圖圖塊。
satellite
衛星圖像。
terrain
地形圖像。選取 terrain 做為地圖類型時，您必須一併納入 layerRoadmap 圖層類型 (請參閱「選用欄位」一節)。
streetview
街景服務全景。若需更多資訊，請參閲 街景服務圖塊：
language

一個 IETF 語言代碼 指定在圖塊上顯示資訊時使用的語言。適用對象 例如 en-US 會指定美國的英文語言。

region

A 罩杯 通用語言代碼資料存放區 代表實際地點的區域 ID (兩個大寫字母) 使用者。例如 US。

選填欄位

imageFormat
指定要傳回的檔案格式。有效值為 jpeg 或 png。 JPEG 檔案不支援透明度，因此不建議 疊加圖塊。如未指定 imageFormat，則 而系統會自動選擇圖塊。
scale

放大地圖元素 (例如道路標籤) 的大小，同時保留預設圖塊的圖塊大小和涵蓋範圍。增加體重計時 減少地圖上的標籤數量，減少干擾。以下為有效的 scale 值：

  • scaleFactor1x：預設值。
  • scaleFactor2x：將標籤大小加倍，並移除次要的特徵標籤。
  • scaleFactor4x：四元組標籤大小，並移除次要特徵標籤。

下例示範縮放地圖元素的效果。

縮放比例係數 1 倍 縮放比例係數 (2 倍)
地圖顯示比例因數 1 倍 地圖顯示比例因數為 2 倍的地圖
highDpi
指定是否要傳回高解析度圖塊。如果縮放比例係數為 已增加，highDpi 是用來放大資訊方塊的大小。一般情況下 增加縮放比例係數會將產生的圖塊放大為 相同尺寸，進而降低品質使用 highDpi 時，產生的大小也會 並依舊維持品質DPI 代表每英寸的圓點，高 DPI 則表示 圖塊的每英寸像素數會比平常使用更多的點。如果是 true，則 x 和 y 尺寸中的像素數量會乘以比例 亦即 2 倍或 4 倍。圖塊的涵蓋範圍則維持不變。 這個參數僅適用於 2 倍或 4 倍的 scale 值。這不會影響 1 倍比例圖塊。
縮放比例係數 1 倍 縮放比例係數 2 倍高 DPI
以一般解析度顯示地圖 以高 DPI 解析度顯示的地圖
layerTypes

指定加入地圖的圖層類型的值陣列。有效 包括：

layerRoadmap
如果將 terrain 指定為地圖類型，則為必要欄位。也可選擇是否使用 疊加在 satellite 地圖類型上。對藍圖圖塊沒有任何影響。
layerStreetview
使用藍色外框，顯示已啟用街景服務的街道和地點 。
layerTraffic
顯示目前路況。
styles

陣列 JSON 樣式物件，用於指定地圖項目 (例如道路、公園和市區) 的外觀和詳細程度。樣式可用於自訂標準 Google 基本地圖。styles 參數只有在下列情況中有效： 地圖類型為 roadmap。如需完整樣式語法，請參閱 樣式參考資料。

overlay

指定是否應 layerTypes 的布林值 算繪為獨立的疊加層，或與基本圖像合併使用。時間 true，不會顯示基本地圖。如果您尚未定義任何 layerTypes 則系統會忽略此值

舉例來說，如果您要求含有 layerRoadmap 圖層的 satellite 地圖類型，並將 overlay 設為 false，則圖塊會等同於 Maps JavaScript API 中使用的 hybrid 地圖類型 (左圖)。同樣的地圖和圖層類型，將 overlay 設為 true 後，會產生含有地圖疊加層的透明圖塊，並以適當樣式疊加衛星圖像 (右圖)。

overlay：false overlay：是
疊加層設為 false 疊加層設為 true

以下 JSON 為含有必要和選用欄位的典型要求主體範例。

{
  "mapType": "satellite",
  "language": "en-US",
  "region": "us",
  "layerTypes": [ "layerRoadmap", "layerStreetview" ],
  "overlay":  true,
  "scale": "scaleFactor1x",
  "styles": [
    {
      "stylers": [
        { "hue": "#00ffe6" },
        { "saturation": -20 }
      ]
    },{
      "featureType": "road",
      "elementType": "geometry",
      "stylers": [
        { "lightness": 100 },
        { "visibility": "simplified" }
      ]
    }
  ]
}

此範例提供適合與衛星合併的疊加層 圖像。這個範例同時包含道路圖和街景服務疊加層。 產生的地圖會使用英文名稱及資料進行算繪， 英文版本

apiOptions：指定要套用其他選項的值陣列。 支援的選項包括：

  • MCYJ5E517XR2JC - 選擇加入 新地圖 style 相符。在選用期間，您的要求將取得目前 除非你指定此值，否則樣式會受到限制。

工作階段符記回應

以下 JSON 是回應主體的範例。

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

下列清單包含回應主體中的欄位定義。

session
工作階段符記值，必須加到所有 Map Tiles API 中 。
expiry
字串，其中包含權杖到期時間 (以 Epoch 起算的秒數)。工作階段符記在建立後的兩週內有效 但這項政策可能會在未通知的情況下變更。
tileWidth
圖塊寬度 (以像素為單位)。
tileHeight
圖塊的高度，以像素為單位。
imageFormat
圖片格式，可以是 png 或 jpeg。