Viewport

經緯度可視區域,以兩個對角相反的 lowhigh 點表示。可視區域視為封閉區域,也就是說,可視區域包含邊界。緯度範圍必須介於 -90 到 90 度之間 (含首尾),經度範圍必須介於 -180 到 180 度之間 (含首尾)。這類情況包括:

  • 如果 low = high,可視區域就是該單一點。

  • 如果 low.longitude > high.longitude,經度範圍會反轉 (可視區域會跨越 180 度經度線)。

  • 如果 low.longitude = -180 度且 high.longitude = 180 度,可視區域會包含所有經度。

  • 如果 low.longitude = 180 度且 high.longitude = -180 度,經度範圍會空白。

  • 如果 low.latitude > high.latitude,緯度範圍會空白。

lowhigh 都必須填入,且代表的方塊不得為空 (如上述定義所指定)。如果檢視區塊為空白,就會發生錯誤。

舉例來說,這個可視區域完全涵蓋紐約市:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 表示法
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
欄位
low

object (LatLng)

必填。可視區域的最低點。

high

object (LatLng)

必填。可視區域的最高點。

LatLng

代表經緯度組合的物件。這個物件會同時指出經度和緯度的度數。除非另有指定,否則這個物件必須符合 WGS84 標準。此外,值必須在正規化範圍內。

JSON 表示法
{
  "latitude": number,
  "longitude": number
}
欄位
latitude

number

緯度度數,必須介於 [-90.0, +90.0] 的範圍之間。

longitude

number

經度度數,必須介於 [-180.0, +180.0] 的範圍之間。