Data

資料 類別

google.maps.Data class

用於顯示地理空間資料的圖層。可顯示點、線串和多邊形。

每個 Map 預設都有 Data 物件,因此大部分時間都不需要建構物件。例如:

 var myMap = new google.maps.Map(...);
myMap.data.addGeoJson(...);
myMap.data.setStyle(...);
Data 物件是 Features 的集合。

這個類別會擴充 MVCObject

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data
Data([options])
參數: 
建立空白集合,並使用指定的 DataOptions
add
add([feature])
參數: 
傳回值:  Data.Feature
將地圖項目新增至集合,並傳回新增的地圖項目。

如果特徵有 ID,系統會取代集合中 ID 相同的現有特徵。如果未提供任何特徵,系統會建立幾何為空值且沒有屬性的新特徵。如果提供 FeatureOptions,系統會使用指定屬性建立新特徵。

請注意,ID 1234'1234' 是等效的。新增 ID 為 1234 的特徵會取代 ID 為 '1234' 的特徵,反之亦然。

addGeoJson
addGeoJson(geoJson[, options])
參數: 
傳回值:  Array<Data.Feature>
將 GeoJSON 特徵新增至集合。為這個方法提供已剖析的 JSON。系統會傳回匯入的特徵。如果無法匯入 GeoJSON,就會擲回例外狀況。
contains
contains(feature)
參數: 
傳回值:  boolean
檢查指定特徵是否位於集合中。
forEach
forEach(callback)
參數: 
傳回值:
重複叫用指定函式,每次叫用時都會將集合中的特徵傳遞至函式。系統會以未定義的順序逐一處理特徵。
getControlPosition
getControlPosition()
參數:
傳回值:  ControlPosition
傳回地圖上繪圖控制項的位置。
getControls
getControls()
參數:
傳回值:  Array<string>
傳回使用者可選取的繪圖模式,並依顯示順序排列。這不包括預設新增的null繪圖模式。可能的繪圖模式為 "Point""LineString""Polygon"
getDrawingMode
getDrawingMode()
參數:
傳回值:  string|null
傳回指定資料層的目前繪圖模式。null 繪圖模式表示使用者可以正常與地圖互動,點選地圖不會繪製任何內容。可能的繪圖模式為 null"Point""LineString""Polygon"
getFeatureById
getFeatureById(id)
參數: 
  • idnumber|string
傳回值:  Data.Feature|undefined
傳回具有指定 ID 的特徵 (如果該特徵存在於集合中)。否則會傳回 undefined

請注意,ID 1234'1234' 是等效的。兩者都可用於查詢相同功能。

getMap
getMap()
參數:
傳回值:  Map
傳回顯示特徵的地圖。
getStyle
getStyle()
參數:
取得集合中所有地圖項目的樣式。
loadGeoJson
loadGeoJson(url[, options, callback])
參數: 
傳回值:
從網址載入 GeoJSON,並將地圖項目新增至集合。

注意:系統會使用 XHR 擷取 GeoJSON,因此可能無法跨網域運作。如有問題,建議您使用所選的 AJAX 程式庫擷取 GeoJSON,然後呼叫 addGeoJson()

overrideStyle
overrideStyle(feature, style)
參數: 
傳回值:
變更特徵的樣式。這些變更會套用至 setStyle() 指定的樣式。設為 null 的樣式屬性會還原為透過 setStyle() 指定的值。
remove
remove(feature)
參數: 
傳回值:
從集合中移除特徵。
revertStyle
revertStyle([feature])
參數: 
傳回值:
移除先前 overrideStyle() 呼叫的效果。指定地圖項目的樣式會還原為 setStyle() 指定的樣式。

如未提供任何地圖項目,所有地圖項目的樣式都會還原。

setControlPosition
setControlPosition(controlPosition)
參數: 
傳回值:
在地圖上設定繪圖控制項的位置。
setControls
setControls(controls)
參數: 
  • controlsArray<string>
傳回值:
設定使用者可選取的繪圖模式,並決定顯示順序。這不應包含預設新增的 null 繪圖模式。如果 null,繪圖控制項會停用且不會顯示。可能的繪圖模式為 "Point""LineString""Polygon"
setDrawingMode
setDrawingMode(drawingMode)
參數: 
  • drawingModestring optional
傳回值:
設定指定資料層的目前繪圖模式。null 繪圖模式表示使用者可以正常與地圖互動,點選地圖不會繪製任何內容。可能的繪圖模式為 null"Point""LineString""Polygon"
setMap
setMap(map)
參數: 
傳回值:
在指定地圖上算繪特徵。如果地圖設為 null,地圖就會移除這些功能。
setStyle
setStyle(style)
傳回值:
為集合中的所有地圖項目設定樣式。透過 overrideStyle() 為每個地圖項目指定的樣式會繼續套用。

傳遞含有所需樣式選項的物件,或是用於計算各個地圖項目樣式的函式。每當地圖項目的屬性更新時,系統就會呼叫這個函式。

toGeoJson
toGeoJson(callback)
參數: 
  • callbackfunction(Object): void
傳回值:
將集合中的特徵匯出至 GeoJSON 物件。
已繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
addfeature
function(event)
引數: 
將特徵新增至集合時,系統會觸發這個事件。
click
function(event)
引數: 
點選幾何圖形時,系統會觸發這個事件。
contextmenu
function(event)
引數: 
當幾何圖形觸發 DOM contextmenu 事件時,系統會觸發這個事件。
dblclick
function(event)
引數: 
對幾何圖形按兩下時,系統會觸發這個事件。
mousedown
function(event)
引數: 
在幾何圖形上按下滑鼠時,系統會觸發這個事件。
mouseout
function(event)
引數: 
滑鼠離開幾何圖形區域時,會觸發這個事件。
mouseover
function(event)
引數: 
當滑鼠進入幾何圖形區域時,就會觸發這個事件。
mouseup
function(event)
引數: 
在幾何圖形上發生 mouseup 時,系統會觸發這個事件。
removefeature
function(event)
引數: 
從集合中移除特徵時,會觸發這個事件。
removeproperty
function(event)
引數: 
移除特徵的屬性時,系統會觸發這個事件。
setgeometry
function(event)
引數: 
設定特徵的幾何圖形時,系統會觸發這項事件。
setproperty
function(event)
引數: 
設定特徵的屬性時,系統會觸發這個事件。
rightclick
function(event)
引數: 
在幾何圖形上按一下滑鼠右鍵時,系統會觸發這個事件。

Data.DataOptions 介面

google.maps.Data.DataOptions 介面

DataOptions 物件,用於定義開發人員可在 Data 物件上設定的屬性。

map
類型:  Map
地圖,用於顯示集合中的特徵。
controlPosition optional
類型:  ControlPosition optional
地圖上繪圖控制項的位置。
controls optional
類型:  Array<string> optional
預設值: null
說明使用者可選取的繪圖模式,並列出顯示順序。這不應包含預設新增的 null 繪圖模式。如果 null,繪圖控制項會停用且不會顯示。可能的繪圖模式為 "Point""LineString""Polygon"
drawingMode optional
類型:  string optional
預設值: null
指定資料層的目前繪圖模式。null 繪圖模式表示使用者可以正常與地圖互動,點選地圖不會繪製任何內容。可能的繪圖模式為 null"Point""LineString""Polygon"
featureFactory optional
類型:  function(Data.Geometry): Data.Feature optional
啟用繪圖功能後,使用者繪製幾何圖形 (點、線串或多邊形) 時,系統會使用該幾何圖形呼叫這個函式,並應傳回要新增至資料層的 Feature。如果未提供 featureFactory,系統會改為從該 Geometry 建立沒有 ID 和屬性的 Feature。預設值為 null
style optional
集合中所有地圖項目的樣式。詳情請參閱上方的 setStyle() 方法。

Data.GeoJsonOptions interface

google.maps.Data.GeoJsonOptions 介面

匯入 GeoJSON 的選用參數。

idPropertyName optional
類型:  string optional
要當做特徵 ID 的特徵屬性名稱。如未指定,系統會使用 GeoJSON 特徵 ID。

Data.StyleOptions 介面

google.maps.Data.StyleOptions 介面

這些選項會指定地圖上顯示地圖項目的方式。

animation optional
類型:  Animation optional
在地圖中加入標記時要播放的動畫。僅適用於點幾何圖形。
clickable optional
類型:  boolean optional
預設值: true
如果為 true,標記就會接收滑鼠和觸控事件。
cursor optional
類型:  string optional
懸停時要顯示的滑鼠游標。僅適用於點幾何圖形。
draggable optional
類型:  boolean optional
預設值: false
如果是 true,物件就能在地圖上拖曳,底層的特徵幾何圖形也會隨之更新。
editable optional
類型:  boolean optional
預設值: false
如為 true,即可拖曳控制點編輯物件,基礎功能也會更新幾何圖形。僅適用於 LineString 和 Polygon 幾何圖形。
fillColor optional
類型:  string optional
填色。系統支援所有 CSS3 色彩 (延伸的具名色彩除外)。僅適用於多邊形幾何圖形。
fillOpacity optional
類型:  number optional
填滿不透明度,範圍介於 0.0 和 1.0 之間。僅適用於多邊形幾何圖形。
icon optional
類型:  string|Icon|Symbol optional
前景圖示。如果提供字串,系統會將其視為 Icon,並將字串視為 url。僅適用於點幾何圖形。
icons optional
類型:  Array<IconSequence> optional
沿著折線顯示的圖示。僅適用於線條幾何圖形。
label optional
類型:  string|MarkerLabel optional
在標記中新增標籤。標籤可以是字串或 MarkerLabel 物件。僅適用於點幾何圖形。
opacity optional
類型:  number optional
標記的不透明度,介於 0.0 和 1.0 之間。僅適用於點幾何圖形。
shape optional
類型:  MarkerShape optional
定義用於偵測命中的圖片點擊區。僅適用於點幾何圖形。
strokeColor optional
類型:  string optional
筆觸色彩。系統支援所有 CSS3 色彩 (延伸的具名色彩除外)。僅適用於線和多邊形幾何圖形。
strokeOpacity optional
類型:  number optional
筆觸不透明度,範圍介於 0.0 和 1.0 之間。僅適用於線和多邊形幾何圖形。
strokeWeight optional
類型:  number optional
筆劃寬度 (以像素為單位)。僅適用於線和多邊形幾何圖形。
title optional
類型:  string optional
滑鼠游標懸停效果文字。僅適用於點幾何圖形。
visible optional
類型:  boolean optional
預設值: true
功能是否可見。
zIndex optional
類型:  number optional
所有地圖項目皆按照 zIndex 順序顯示在地圖上,值較高的地圖項目會比值較低的地圖項目優先顯示。標記一律會顯示在線串和多邊形的前方。

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

計算特徵外觀的函式。

Data.setStyle() 方法可接受樣式函式。如果功能應根據屬性以不同方式顯示,請使用這項功能。如要進一步瞭解樣式功能,請參閱開發人員指南

function(Data.Feature): Data.StyleOptions

Data.Feature class

google.maps.Data.Feature class

特徵具有幾何圖形、ID 和一組屬性。

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.Feature
Data.Feature([options])
參數: 
使用指定選項建構 Feature。
forEachProperty
forEachProperty(callback)
參數: 
  • callbackfunction(*, string): void
傳回值:
重複叫用指定函式,每次叫用時傳遞屬性值和名稱。屬性的疊代順序未定義。
getGeometry
getGeometry()
參數:
傳回值:  Data.Geometry
傳回特徵的幾何圖形。
getId
getId()
參數:
傳回值:  number|string|undefined
傳回特徵 ID。
getProperty
getProperty(name)
參數: 
  • namestring
傳回值:  *
傳回所要求屬性的值,如果屬性不存在,則傳回 undefined
removeProperty
removeProperty(name)
參數: 
  • namestring
傳回值:
移除具有指定名稱的屬性。
setGeometry
setGeometry(newGeometry)
參數: 
傳回值:
設定地圖項目的幾何圖形。
setProperty
setProperty(name, newValue)
參數: 
  • namestring
  • newValue*
傳回值:
設定指定屬性的值。如果 newValueundefined,這相當於呼叫 removeProperty
toGeoJson
toGeoJson(callback)
參數: 
  • callbackfunction(Object): void
傳回值:
將地圖項目匯出為 GeoJSON 物件。
removeproperty
function(event)
引數: 
移除特徵的屬性時,系統會觸發這項事件。
setgeometry
function(event)
引數: 
設定特徵的幾何圖形時,系統會觸發這項事件。
setproperty
function(event)
引數: 
設定功能的屬性時,系統會觸發這個事件。

Data.FeatureOptions 介面

google.maps.Data.FeatureOptions 介面

建立 Data.Feature 物件的選用參數。

geometry optional
類型:  Data.Geometry|LatLng|LatLngLiteral optional
地圖項目幾何圖形。如果建構地圖項目時未指定任何值,地圖項目的幾何圖形會是 null。如果提供 LatLng 物件或 LatLngLiteral,系統會將其轉換為 Data.Point 幾何圖形。
id optional
類型:  number|string optional
特徵 ID 為選用屬性。如果提供這項資訊,即可使用 getFeatureById() 方法在 Data 物件中查詢該功能。請注意,功能 ID 無法變更。
properties optional
類型:  Object optional
功能屬性。這是屬性名稱與值的任意對應。

Data.Geometry 介面

google.maps.Data.Geometry 介面

各種幾何物件的父類別。

forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
重複叫用指定函式,每次叫用時,都會將幾何圖形中的點傳遞至函式。
getType
getType()
參數:
傳回值:  string
傳回幾何物件的型別。可能的值為 "Point""MultiPoint""LineString""MultiLineString""LinearRing""Polygon""MultiPolygon""GeometryCollection"

Data.Point class

google.maps.Data.Point class

Point 幾何圖形包含單一 LatLng

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.Point
Data.Point(latLng)
參數: 
根據指定的 LatLngLatLngLiteral 建構 Data.Point
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
get
get()
參數:
傳回值:  LatLng
傳回所含的 LatLng
getType
getType()
參數:
傳回值:  string
傳回字串 "Point"

Data.MultiPoint class

google.maps.Data.MultiPoint class

MultiPoint 幾何圖形包含多個 LatLng

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.MultiPoint
Data.MultiPoint(elements)
參數: 
根據指定的 LatLngLatLngLiteral 建構 Data.MultiPoint
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
getArray
getArray()
參數:
傳回值:  Array<LatLng>
傳回所含 LatLng 的陣列。每次呼叫 getArray() 時,系統都會傳回新陣列。
getAt
getAt(n)
參數: 
  • nnumber
傳回值:  LatLng
傳回所含的第 nLatLng
getLength
getLength()
參數:
傳回值:  number
傳回所含 LatLng 的數量。
getType
getType()
參數:
傳回值:  string
傳回字串 "MultiPoint"

Data.LineString class

google.maps.Data.LineString class

LineString 幾何圖形包含多個 LatLng

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.LineString
Data.LineString(elements)
參數: 
根據指定的 LatLngLatLngLiteral 建構 Data.LineString
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
getArray
getArray()
參數:
傳回值:  Array<LatLng>
傳回所含 LatLngs 的陣列。每次呼叫 getArray() 時,系統都會傳回新陣列。
getAt
getAt(n)
參數: 
  • nnumber
傳回值:  LatLng
傳回所含的第 nLatLng
getLength
getLength()
參數:
傳回值:  number
傳回所含 LatLng 的數量。
getType
getType()
參數:
傳回值:  string
傳回字串 "LineString"

Data.MultiLineString class

google.maps.Data.MultiLineString class

MultiLineString 幾何圖形包含多個 LineString

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.MultiLineString
Data.MultiLineString(elements)
參數: 
根據指定的位置或位置陣列建構 Data.MultiLineStringData.LineString
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
getArray
getArray()
參數:
傳回值:  Array<Data.LineString>
傳回所含 Data.LineString 的陣列。每次呼叫 getArray() 時,系統都會傳回新陣列。
getAt
getAt(n)
參數: 
  • nnumber
傳回值:  Data.LineString
傳回所含的第 nData.LineString
getLength
getLength()
參數:
傳回值:  number
傳回所含 Data.LineString 的數量。
getType
getType()
參數:
傳回值:  string
傳回字串 "MultiLineString"

Data.LinearRing class

google.maps.Data.LinearRing class

LinearRing 幾何圖形包含多個 LatLng,代表封閉的 LineString。第一個 LatLng 不必等於最後一個 LatLng。LinearRing 會隱含關閉。

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.LinearRing
Data.LinearRing(elements)
參數: 
根據指定的 LatLngLatLngLiteral 建構 Data.LinearRing
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
getArray
getArray()
參數:
傳回值:  Array<LatLng>
傳回所含 LatLng 的陣列。每次呼叫 getArray() 時,系統都會傳回新陣列。
getAt
getAt(n)
參數: 
  • nnumber
傳回值:  LatLng
傳回所含的第 nLatLng
getLength
getLength()
參數:
傳回值:  number
傳回所含 LatLng 的數量。
getType
getType()
參數:
傳回值:  string
傳回字串 "LinearRing"

Data.Polygon class

google.maps.Data.Polygon class

多邊形幾何圖形包含多個 Data.LinearRing。第一個線性環必須是多邊形外邊界,後續的線性環則必須是內邊界,也就是孔洞。請參閱有洞的多邊形範例

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.Polygon
Data.Polygon(elements)
參數: 
根據指定的位置或位置陣列建構 Data.PolygonData.LinearRing
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
getArray
getArray()
參數:
傳回值:  Array<Data.LinearRing>
傳回所含 Data.LinearRing 的陣列。每次呼叫 getArray() 時,系統都會傳回新陣列。
getAt
getAt(n)
參數: 
  • nnumber
傳回值:  Data.LinearRing
傳回所含的第 nData.LinearRing
getLength
getLength()
參數:
傳回值:  number
傳回所含 Data.LinearRing 的數量。
getType
getType()
參數:
傳回值:  string
傳回字串 "Polygon"

Data.MultiPolygon class

google.maps.Data.MultiPolygon class

MultiPolygon 幾何圖形包含多個 Data.Polygon

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.MultiPolygon
Data.MultiPolygon(elements)
根據指定的位置或位置陣列建構 Data.MultiPolygonData.Polygon
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
getArray
getArray()
參數:
傳回值:  Array<Data.Polygon>
傳回所含 Data.Polygon 的陣列。每次呼叫 getArray() 時,系統都會傳回新陣列。
getAt
getAt(n)
參數: 
  • nnumber
傳回值:  Data.Polygon
傳回所含的第 nData.Polygon
getLength
getLength()
參數:
傳回值:  number
傳回所含 Data.Polygon 的數量。
getType
getType()
參數:
傳回值:  string
傳回字串 "MultiPolygon"

Data.GeometryCollection class

google.maps.Data.GeometryCollection class

GeometryCollection 包含多個幾何物件。系統會自動將任何 LatLngLatLngLiteral 物件轉換為 Data.Point 幾何物件。

這個類別會實作 Data.Geometry

撥打 const {Data} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Data.GeometryCollection
Data.GeometryCollection(elements)
參數: 
從指定的幾何物件或 LatLng 建構 Data.GeometryCollection
forEachLatLng
forEachLatLng(callback)
參數: 
  • callbackfunction(LatLng): void
傳回值:
getArray
getArray()
參數:
傳回值:  Array<Data.Geometry>
傳回所含幾何物件的陣列。每次呼叫 getArray() 時,系統都會傳回新陣列。
getAt
getAt(n)
參數: 
  • nnumber
傳回值:  Data.Geometry
傳回第 n 個所含幾何物件。
getLength
getLength()
參數:
傳回值:  number
傳回所含幾何物件的數量。
getType
getType()
參數:
傳回值:  string
傳回字串 "GeometryCollection"

Data.MouseEvent 介面

google.maps.Data.MouseEvent 介面

這個物件會傳遞至 Data 物件上的滑鼠事件處理常式。

這個介面會擴充 MapMouseEvent

feature
類型:  Data.Feature
產生滑鼠事件的功能。
已繼承: domEventlatLng
繼承: stop

Data.AddFeatureEvent 介面

google.maps.Data.AddFeatureEvent 介面

addfeature 事件的屬性。

feature
類型:  Data.Feature
已新增至 FeatureCollection 的功能。

Data.RemoveFeatureEvent 介面

google.maps.Data.RemoveFeatureEvent 介面

removefeature 事件的屬性。

feature
類型:  Data.Feature
FeatureCollection 移除的功能。

Data.SetGeometryEvent 介面

google.maps.Data.SetGeometryEvent 介面

setgeometry 事件的屬性。

feature
類型:  Data.Feature
已設定幾何圖形的地圖項目。
newGeometry optional
類型:  Data.Geometry optional
新的特徵幾何圖形。
oldGeometry optional
類型:  Data.Geometry optional
先前的地圖項目幾何圖形。

Data.SetPropertyEvent 介面

google.maps.Data.SetPropertyEvent 介面

setproperty 事件的屬性。

feature
類型:  Data.Feature
已設定屬性的特徵。
name
類型:  string
屬性名稱。
newValue
類型:  *
新值。
oldValue
類型:  *
先前的值。如果已新增屬性,則為 undefined

Data.RemovePropertyEvent 介面

google.maps.Data.RemovePropertyEvent 介面

removeproperty 事件的屬性。

feature
類型:  Data.Feature
已移除屬性的特徵。
name
類型:  string
屬性名稱。
oldValue
類型:  *
先前的值。