Data

Lớp Dữ liệu

Lớp google.maps.Data

Một lớp để hiển thị dữ liệu không gian địa lý. Bạn có thể hiển thị các điểm, chuỗi đường và đa giác.

Theo mặc định, mọi Map đều có một đối tượng Data, nên hầu hết thời gian bạn không cần tạo đối tượng này. Ví dụ: 

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);
Đối tượng Data là một tập hợp Features.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {Data} = await google.maps.importLibrary("maps").
Xem Thư viện trong Maps JavaScript API.
Data
Data([options])
Tham số: 
Tạo một bộ sưu tập trống bằng DataOptions đã cho.
add
add([feature])
Tham số: 
Giá trị trả về:  Data.Feature
Thêm một đối tượng vào bộ sưu tập và trả về đối tượng đã thêm.

Nếu đối tượng có một mã nhận dạng, thì mã nhận dạng đó sẽ thay thế mọi đối tượng hiện có trong tập hợp có cùng mã nhận dạng. Nếu không có đối tượng nào được chỉ định, một đối tượng mới sẽ được tạo mà không có hình học và thuộc tính. Nếu bạn cung cấp FeatureOptions, một đối tượng mới sẽ được tạo bằng các thuộc tính đã chỉ định.

Xin lưu ý rằng mã nhận dạng 1234 và '1234' là tương đương. Việc thêm một đối tượng có mã nhận dạng 1234 sẽ thay thế một đối tượng có mã nhận dạng '1234' và ngược lại.
addGeoJson
addGeoJson(geoJson[, options])
Tham số: 
Giá trị trả về:  Array<Data.Feature>
Thêm các đối tượng GeoJSON vào bộ sưu tập. Cung cấp cho phương thức này một JSON đã phân tích cú pháp. Các đối tượng được nhập sẽ được trả về. Đưa ra một ngoại lệ nếu không thể nhập GeoJSON.
contains
contains(feature)
Tham số: 
Giá trị trả về:  boolean
Kiểm tra xem tính năng đã cho có trong tập hợp hay không.
forEach
forEach(callback)
Tham số: 
Giá trị trả về:  Không có
Liên tục gọi hàm đã cho, truyền một đối tượng trong tập hợp đến hàm ở mỗi lần gọi. Thứ tự lặp lại thông qua các đối tượng không xác định.
getControlPosition
getControlPosition()
Tham số:  Không có
Giá trị trả về:  ControlPosition
Trả về vị trí của các nút điều khiển vẽ trên bản đồ.
getControls
getControls()
Tham số:  Không có
Giá trị trả về:  Array<string>
Trả về những chế độ vẽ mà người dùng có thể chọn, theo thứ tự hiển thị. Chế độ này không bao gồm chế độ vẽ null (được thêm theo mặc định). Các chế độ vẽ có thể là "Point", "LineString" hoặc "Polygon".
getDrawingMode
getDrawingMode()
Tham số:  Không có
Giá trị trả về:  string|null
Trả về chế độ vẽ hiện tại của Lớp dữ liệu đã cho. Chế độ vẽ null có nghĩa là người dùng có thể tương tác với bản đồ như bình thường và các lượt nhấp sẽ không vẽ bất cứ thứ gì. Các chế độ vẽ có thể có là null, "Point", "LineString" hoặc "Polygon".
getFeatureById
getFeatureById(id)
Tham số: 
  • id:  number|string
Giá trị trả về:  Data.Feature|undefined
Trả về đối tượng có mã nhận dạng đã cho, nếu đối tượng đó có trong tập hợp. Nếu không, hàm này sẽ trả về undefined.

Xin lưu ý rằng mã nhận dạng 1234 và '1234' là tương đương. Bạn có thể dùng một trong hai cách để tìm kiếm cùng một tính năng.
getMap
getMap()
Tham số:  Không có
Giá trị trả về:  Map
Trả về bản đồ mà các đối tượng được hiển thị.
getStyle
getStyle()
Tham số:  Không có
Giá trị trả về:  Data.StylingFunction|Data.StyleOptions
Lấy kiểu cho tất cả các đối tượng trong tập hợp.
loadGeoJson
loadGeoJson(url[, options, callback])
Tham số: 
Giá trị trả về:  Không có
Tải GeoJSON từ một URL và thêm các đối tượng vào tập hợp.

LƯU Ý: GeoJSON được tìm nạp bằng XHR và có thể không hoạt động trên nhiều miền. Nếu gặp vấn đề, bạn nên tìm nạp GeoJSON bằng thư viện AJAX mà bạn chọn, rồi gọi addGeoJson().
overrideStyle
overrideStyle(feature, style)
Tham số: 
Giá trị trả về:  Không có
Thay đổi kiểu của một đối tượng. Những thay đổi này được áp dụng cho kiểu do setStyle() chỉ định. Các thuộc tính kiểu được đặt thành null sẽ trở về giá trị được chỉ định thông qua setStyle().
remove
remove(feature)
Tham số: 
Giá trị trả về:  Không có
Xoá một đối tượng khỏi bộ sưu tập.
revertStyle
revertStyle([feature])
Tham số: 
Giá trị trả về:  Không có
Xoá hiệu ứng của các lệnh gọi overrideStyle() trước đó. Kiểu của đối tượng cho trước sẽ trở về kiểu do setStyle() chỉ định.

Nếu không có đối tượng nào được chỉ định, thì tất cả đối tượng đều được khôi phục kiểu.
setControlPosition
setControlPosition(controlPosition)
Tham số: 
Giá trị trả về:  Không có
Đặt vị trí của các chế độ kiểm soát bản vẽ trên bản đồ.
setControls
setControls(controls)
Tham số: 
  • controls:  Array<string>
Giá trị trả về:  Không có
Đặt những chế độ vẽ mà người dùng có thể chọn, theo thứ tự hiển thị. Không được bao gồm chế độ vẽ null (được thêm theo mặc định). Nếu là null, các chế độ kiểm soát vẽ sẽ bị tắt và không hiển thị. Các chế độ vẽ có thể là "Point", "LineString" hoặc "Polygon".
setDrawingMode
setDrawingMode(drawingMode)
Tham số: 
  • drawingMode:  string optional
Giá trị trả về:  Không có
Đặt chế độ vẽ hiện tại của lớp Dữ liệu đã cho. Chế độ vẽ null có nghĩa là người dùng có thể tương tác với bản đồ như bình thường và các lượt nhấp sẽ không vẽ bất cứ thứ gì. Các chế độ vẽ có thể có là null, "Point", "LineString" hoặc "Polygon".
setMap
setMap(map)
Tham số: 
Giá trị trả về:  Không có
Kết xuất các đối tượng trên bản đồ đã chỉ định. Nếu bạn đặt bản đồ thành null, các đối tượng sẽ bị xoá khỏi bản đồ.
setStyle
setStyle(style)
Tham số: 
Giá trị trả về:  Không có
Đặt kiểu cho tất cả các đối tượng trong bộ sưu tập. Các kiểu được chỉ định trên cơ sở từng đối tượng thông qua overrideStyle() sẽ tiếp tục được áp dụng.

Truyền một đối tượng có các lựa chọn về kiểu mong muốn hoặc một hàm tính toán kiểu cho từng đối tượng. Hàm này sẽ được gọi mỗi khi các thuộc tính của một đối tượng được cập nhật.
toGeoJson
toGeoJson(callback)
Tham số: 
  • callback:  function(Object): void
Giá trị trả về:  Không có
Xuất các đối tượng trong tập hợp sang đối tượng GeoJSON.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
addfeature
function(event)
Đối số: 
Sự kiện này được kích hoạt khi một đối tượng được thêm vào tập hợp.
click
function(event)
Đối số: 
Sự kiện này được kích hoạt khi có một lượt nhấp vào hình học.
contextmenu
function(event)
Đối số: 
Sự kiện này được kích hoạt khi sự kiện DOM contextmenu được kích hoạt trên hình học.
dblclick
function(event)
Đối số: 
Sự kiện này được kích hoạt khi người dùng nhấp đúp vào hình học.
mousedown
function(event)
Đối số: 
Sự kiện này được kích hoạt khi người dùng nhấp chuột vào hình học.
mouseout
function(event)
Đối số: 
Sự kiện này được kích hoạt khi chuột rời khỏi khu vực của hình học.
mouseover
function(event)
Đối số: 
Sự kiện này được kích hoạt khi chuột di chuyển vào vùng hình học.
mouseup
function(event)
Đối số: 
Sự kiện này được kích hoạt cho một sự kiện mouseup trên hình học.
removefeature
function(event)
Đối số: 
Sự kiện này sẽ kích hoạt khi một đối tượng bị xoá khỏi bộ sưu tập.
removeproperty
function(event)
Đối số: 
Sự kiện này được kích hoạt khi thuộc tính của một đối tượng bị xoá.
setgeometry
function(event)
Đối số: 
Sự kiện này được kích hoạt khi bạn đặt hình học của một đối tượng.
setproperty
function(event)
Đối số: 
Sự kiện này được kích hoạt khi thuộc tính của một đối tượng được đặt.
rightclick
function(event)
Đối số: 
Sự kiện này được kích hoạt khi người dùng nhấp chuột phải vào hình học.

Giao diện Data.DataOptions

google.maps.Data.DataOptionsgiao diện

Đối tượng DataOptions dùng để xác định các thuộc tính mà nhà phát triển có thể đặt trên đối tượng Data.
map
Loại:  Map
Bản đồ để hiển thị các đối tượng trong bộ sưu tập.
controlPosition optional
Loại:  ControlPosition optional
Mặc định: ControlPosition.TOP_LEFT
Vị trí của các chế độ kiểm soát bản vẽ trên bản đồ.
controls optional
Loại:  Array<string> optional
Mặc định: null
Mô tả những chế độ vẽ mà người dùng có thể chọn, theo thứ tự xuất hiện. Không được bao gồm chế độ vẽ null (được thêm theo mặc định). Nếu là null, các chế độ kiểm soát vẽ sẽ bị tắt và không hiển thị. Các chế độ vẽ có thể là "Point", "LineString" hoặc "Polygon".
drawingMode optional
Loại:  string optional
Mặc định: null
Chế độ vẽ hiện tại của Lớp dữ liệu đã cho. Chế độ vẽ null có nghĩa là người dùng có thể tương tác với bản đồ như bình thường và các lượt nhấp sẽ không vẽ bất cứ thứ gì. Các chế độ vẽ có thể có là null, "Point", "LineString" hoặc "Polygon".
featureFactory optional
Loại:  function(Data.Geometry): Data.Feature optional
Khi tính năng vẽ được bật và người dùng vẽ một Geometry (Point, Line String hoặc Polygon), hàm này sẽ được gọi bằng Geometry đó và phải trả về một Feature sẽ được thêm vào lớp Dữ liệu. Nếu bạn không cung cấp featureFactory, thì một Đối tượng không có mã nhận dạng và không có thuộc tính sẽ được tạo từ Hình học đó. Giá trị mặc định là null.
style optional
Kiểu cho tất cả các đối tượng trong tập hợp. Để biết thêm thông tin chi tiết, hãy xem phương thức setStyle() ở trên.

Giao diện Data.GeoJsonOptions

google.maps.Data.GeoJsonOptionsgiao diện

Các tham số không bắt buộc để nhập GeoJSON.
idPropertyName optional
Loại:  string optional
Tên của thuộc tính Đối tượng cần dùng làm mã nhận dạng đối tượng. Nếu bạn không chỉ định, thì mã nhận dạng Đối tượng GeoJSON sẽ được dùng.

Giao diện Data.StyleOptions

google.maps.Data.StyleOptionsgiao diện

Các lựa chọn này chỉ định cách một Đối tượng xuất hiện khi hiển thị trên bản đồ.
animation optional
Loại:  Animation optional
Ảnh động sẽ phát khi điểm đánh dấu được thêm vào bản đồ. Chỉ áp dụng cho các hình học điểm.
clickable optional
Loại:  boolean optional
Mặc định: true
Nếu true, điểm đánh dấu sẽ nhận được các sự kiện về chuột và thao tác chạm.
cursor optional
Loại:  string optional
Con trỏ chuột sẽ xuất hiện khi di chuột. Chỉ áp dụng cho các hình học điểm.
draggable optional
Loại:  boolean optional
Mặc định: false
Nếu true, đối tượng có thể được kéo trên bản đồ và đối tượng cơ bản sẽ được cập nhật hình học.
editable optional
Loại:  boolean optional
Mặc định: false
Nếu true, bạn có thể chỉnh sửa đối tượng bằng cách kéo các điểm kiểm soát và đối tượng cơ sở sẽ được cập nhật hình học. Chỉ áp dụng cho các hình học LineString và Polygon.
fillColor optional
Loại:  string optional
Màu nền. Tất cả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu có tên mở rộng. Chỉ áp dụng cho các hình học đa giác.
fillOpacity optional
Loại:  number optional
Độ mờ của màu tô nằm trong khoảng từ 0,0 đến 1,0. Chỉ áp dụng cho các hình học đa giác.
icon optional
Loại:  string|Icon|Symbol optional
Biểu tượng cho nền trước. Nếu một chuỗi được cung cấp, thì chuỗi đó sẽ được coi như thể là một Icon có chuỗi là url. Chỉ áp dụng cho các hình học điểm.
icons optional
Loại:  Array<IconSequence> optional
Các biểu tượng sẽ được kết xuất dọc theo một đường nhiều đoạn. Chỉ áp dụng cho hình học đường.
label optional
Loại:  string|MarkerLabel optional
Thêm nhãn vào điểm đánh dấu. Nhãn có thể là một chuỗi hoặc một đối tượng MarkerLabel. Chỉ áp dụng cho các hình học điểm.
opacity optional
Loại:  number optional
Độ mờ của điểm đánh dấu nằm trong khoảng từ 0,0 đến 1,0. Chỉ áp dụng cho các hình học điểm.
shape optional
Loại:  MarkerShape optional
Xác định bản đồ hình ảnh dùng để phát hiện lượt nhấn. Chỉ áp dụng cho các hình học điểm.
strokeColor optional
Loại:  string optional
Màu nét vẽ. Tất cả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu có tên mở rộng. Chỉ áp dụng cho hình học đường và đa giác.
strokeOpacity optional
Loại:  number optional
Độ mờ của nét vẽ trong khoảng từ 0,0 đến 1,0. Chỉ áp dụng cho hình học đường và đa giác.
strokeWeight optional
Loại:  number optional
Độ rộng của nét vẽ tính bằng pixel. Chỉ áp dụng cho hình học đường và đa giác.
title optional
Loại:  string optional
Văn bản khi di chuột. Chỉ áp dụng cho các hình học điểm.
visible optional
Loại:  boolean optional
Mặc định: true
Tính năng này có hiển thị hay không.
zIndex optional
Loại:  number optional
Tất cả các đối tượng đều xuất hiện trên bản đồ theo thứ tự zIndex, trong đó các giá trị cao hơn sẽ xuất hiện trước các đối tượng có giá trị thấp hơn. Các điểm đánh dấu luôn xuất hiện trước các chuỗi đường và đa giác.

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

Một hàm tính toán giao diện của một thành phần.

Phương thức Data.setStyle() có thể chấp nhận một hàm tạo kiểu. Sử dụng khi các đối tượng cần xuất hiện khác nhau tuỳ thuộc vào thuộc tính của chúng. Bạn có thể tìm thêm thông tin về các tính năng tạo kiểu trong hướng dẫn dành cho nhà phát triển.

function(Data.Feature): Data.StyleOptions

Lớp Data.Feature

Lớp google.maps.Data.Feature

Đối tượng có hình học, mã nhận dạng và một tập hợp các thuộc tính.

Truy cập bằng cách gọi const {Data} = await google.maps.importLibrary("maps").
Xem Thư viện trong Maps JavaScript API.
Data.Feature
Data.Feature([options])
Tham số: 
Tạo một Đối tượng bằng các lựa chọn đã cho.
forEachProperty
forEachProperty(callback)
Tham số: 
  • callback:  function(*, string): void
Giá trị trả về:  Không có
Liên tục gọi hàm đã cho, truyền giá trị và tên thuộc tính trên mỗi lệnh gọi. Thứ tự lặp lại thông qua các thuộc tính chưa được xác định.
getGeometry
getGeometry()
Tham số:  Không có
Giá trị trả về:  Data.Geometry
Trả về hình học của đối tượng.