3D Maps

Lớp Map3DElement

Lớp google.maps.maps3d.Map3DElement

Map3DElement là một giao diện HTML cho chế độ xem Bản đồ 3D.

Phần tử tuỳ chỉnh:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>

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

Lớp này sẽ triển khai Map3DElementOptions.

Truy cập bằng cách gọi const {Map3DElement} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
Map3DElement
Map3DElement([options])
Thông số: 
bounds
Khi đặt, hãy giới hạn vị trí của máy ảnh trong giới hạn vĩ độ/vĩ độ đã chỉ định. Xin lưu ý rằng các đối tượng nằm ngoài giới hạn vẫn được kết xuất. Giới hạn có thể hạn chế cả vĩ độ và kinh độ, hoặc chỉ hạn chế vĩ độ hoặc kinh độ. Đối với các giới hạn chỉ theo vĩ độ, hãy sử dụng kinh độ tây và kinh độ đông tương ứng là -180 và 180. Đối với các giới hạn chỉ có kinh độ, hãy sử dụng vĩ độ bắc và nam tương ứng là 90 và -90.
center
Tâm bản đồ được cung cấp dưới dạng Vĩ độ cao, trong đó độ cao tính bằng mét trên mặt đất. Xin lưu ý rằng đây không nhất thiết là vị trí của máy ảnh, vì trường range ảnh hưởng đến khoảng cách của máy ảnh từ tâm bản đồ. Nếu không được đặt, giá trị mặc định sẽ là {lat: 0, lng: 0, altitude: 63170000}. 63170000 mét là độ cao tối đa được phép (bán kính Trái Đất nhân với 10).
Thuộc tính HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
Loại:  boolean optional
Mặc định: false
Khi true, nhãn bản đồ mặc định sẽ không được hiển thị.
Thuộc tính HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Loại:  boolean optional
Mặc định: false
Khi true, tất cả các nút giao diện người dùng mặc định sẽ bị tắt. Không tắt các nút điều khiển bằng bàn phím và cử chỉ.
Thuộc tính HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Loại:  number optional
Góc phương vị của bản đồ, tính bằng độ, trong đó hướng bắc là 0. Khi không có độ nghiêng, mọi độ nghiêng sẽ được hiểu là hướng.
Thuộc tính HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
Loại:  number optional
Độ cao tối đa so với mặt đất sẽ hiển thị trên bản đồ. Giá trị hợp lệ nằm trong khoảng từ 0 đến 63170000 mét (bán kính Trái Đất nhân với 10).
Thuộc tính HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Loại:  number optional
Góc hướng (quay) tối đa của bản đồ. Giá trị hợp lệ nằm trong khoảng từ 0 đến 360 độ. minHeading và maxHeading biểu thị khoảng thời gian <= 360 độ trong đó các cử chỉ hướng sẽ được cho phép. minHeading = 180 và maxHeading = 90 sẽ cho phép tiêu đề trong [0, 90] và tiêu đề trong [180, 360]. minHeading = 90 và maxHeading = 180 sẽ cho phép tiêu đề trong [90, 180].
Thuộc tính HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Loại:  number optional
Góc tới tối đa của bản đồ. Giá trị hợp lệ nằm trong khoảng từ 0 đến 90 độ.
Thuộc tính HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
Loại:  number optional
Độ cao tối thiểu so với mặt đất sẽ hiển thị trên bản đồ. Giá trị hợp lệ nằm trong khoảng từ 0 đến 63170000 mét (bán kính Trái Đất nhân với 10).
Thuộc tính HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Loại:  number optional
Góc tiêu đề (xoay) tối thiểu của bản đồ. Giá trị hợp lệ nằm trong khoảng từ 0 đến 360 độ. minHeading và maxHeading biểu thị khoảng thời gian <= 360 độ trong đó các cử chỉ hướng sẽ được cho phép. minHeading = 180 và maxHeading = 90 sẽ cho phép tiêu đề trong [0, 90] và tiêu đề trong [180, 360]. minHeading = 90 và maxHeading = 180 sẽ cho phép tiêu đề trong [90, 180].
Thuộc tính HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Loại:  number optional
Góc tới tối thiểu của bản đồ. Giá trị hợp lệ nằm trong khoảng từ 0 đến 90 độ.
Thuộc tính HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
range
Loại:  number optional
Khoảng cách từ máy ảnh đến tâm của bản đồ, tính bằng mét.
Thuộc tính HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
Loại:  number optional
Cuộn của camera xung quanh vectơ xem theo độ. Để giải quyết sự mơ hồ, khi không có độ nghiêng, mọi độ nghiêng sẽ được diễn giải là hướng.
Thuộc tính HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Loại:  number optional
Độ nghiêng của vectơ chế độ xem của máy ảnh theo độ. Vectơ chế độ xem nhìn trực tiếp xuống trái đất sẽ có độ nghiêng 0 độ. Một vectơ thành phần hiển thị chỉ ra khỏi trái đất sẽ có độ nghiêng là 180 độ.
Thuộc tính HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các tuỳ chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener
flyCameraAround
flyCameraAround(options)
Thông số: 
Giá trị trả về:  Không có
Phương thức này xoay máy ảnh xung quanh một vị trí nhất định trong một khoảng thời gian nhất định, tạo ra một số vòng nhất định trong khoảng thời gian đó.

Theo mặc định, máy ảnh sẽ quay theo chiều kim đồng hồ. Nếu bạn cung cấp số âm cho vòng quay, máy ảnh sẽ quay theo chiều ngược kim đồng hồ.

Phương thức này không đồng bộ vì ảnh động chỉ có thể bắt đầu sau khi bản đồ tải một lượng tối thiểu. Phương thức này trả về sau khi ảnh động bắt đầu.

Nếu số vòng bằng 0 thì sẽ không có vòng quay nào xảy ra và ảnh động sẽ hoàn tất ngay sau khi bắt đầu.
flyCameraTo
flyCameraTo(options)
Thông số: 
Giá trị trả về:  Không có
Phương thức này di chuyển máy ảnh theo hình parabol từ vị trí hiện tại đến một vị trí kết thúc nhất định trong một khoảng thời gian nhất định.

Phương thức này không đồng bộ vì ảnh động chỉ có thể bắt đầu sau khi bản đồ tải một lượng tối thiểu. Phương thức này trả về sau khi ảnh động bắt đầu.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Thông số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó với addEventListener khỏi mục tiêu. Xem removeEventListener
stopCameraAnimation
stopCameraAnimation()
Thông số:  Không có
Giá trị trả về:  Không có
Phương thức này sẽ dừng mọi hoạt ảnh nhanh có thể đang chạy. Máy ảnh luôn ở bất cứ nơi nào có ảnh động ở giữa; máy ảnh không dịch chuyển đến điểm cuối.

Phương thức này không đồng bộ vì ảnh động chỉ có thể bắt đầu hoặc dừng sau khi bản đồ đã tải một lượng tối thiểu. Phương thức này sẽ trả về sau khi ảnh động dừng.
gmp-animationend
function(animationEndEvent)
Đối số: 
  • animationEndEvent:  Event
Sự kiện này được kích hoạt khi hoạt ảnh nhanh kết thúc. Sự kiện này sẽ được truyền lên qua cây DOM.
gmp-centerchange
function(centerChangeEvent)
Đối số: 
  • centerChangeEvent:  Event
Sự kiện này được kích hoạt khi thuộc tính trung tâm của Map3DElement thay đổi.
gmp-click
function(clickEvent)
Đối số: 
Sự kiện này được kích hoạt khi người dùng nhấp vào phần tử Map3DElement.
gmp-headingchange
function(headingChangeEvent)
Đối số: 
  • headingChangeEvent:  Event
Sự kiện này được kích hoạt khi thuộc tính tiêu đề của Map3DElement thay đổi.
gmp-rangechange
function(rangeChangeEvent)
Đối số: 
  • rangeChangeEvent:  Event
Sự kiện này được kích hoạt khi thuộc tính phạm vi của Map3DElement thay đổi.
gmp-rollchange
function(rollChangeEvent)
Đối số: 
  • rollChangeEvent:  Event
Sự kiện này được kích hoạt khi thuộc tính cuộn của Map3DElement thay đổi.
gmp-steadychange
function(steadyChangeEvent)
Đối số: 
Sự kiện này được kích hoạt khi trạng thái ổn định của Map3DElement thay đổi.
gmp-tiltchange
function(tiltChangeEvent)
Đối số: 
  • tiltChangeEvent:  Event
Sự kiện này được kích hoạt khi thuộc tính nghiêng của Map3DElement thay đổi.

Giao diện Map3DElementOptions

Giao diện google.maps.maps3d.Map3DElementOptions

Đối tượng Map3DElementOptions dùng để xác định các thuộc tính có thể được đặt trên Map3DElement.
bounds optional
Vui lòng xem Map3DElement.bounds.
center optional
Vui lòng xem Map3DElement.center.
defaultLabelsDisabled optional
Loại:  boolean optional
Vui lòng xem Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
Loại:  boolean optional
Vui lòng xem Map3DElement.defaultUIDisabled.
heading optional
Loại:  number optional
Vui lòng xem Map3DElement.heading.
maxAltitude optional
Loại:  number optional
Vui lòng xem Map3DElement.maxAltitude.
maxHeading optional
Loại:  number optional
Vui lòng xem Map3DElement.maxHeading.
maxTilt optional
Loại:  number optional
Vui lòng xem Map3DElement.maxTilt.
minAltitude optional
Loại:  number optional
Vui lòng xem Map3DElement.minAltitude.
minHeading optional
Loại:  number optional
Vui lòng xem Map3DElement.minHeading.
minTilt optional
Loại:  number optional
Vui lòng xem Map3DElement.minTilt.
range optional
Loại:  number optional
Vui lòng xem Map3DElement.range.
roll optional
Loại:  number optional
Vui lòng xem Map3DElement.roll.
tilt optional
Loại:  number optional
Vui lòng xem Map3DElement.tilt.

Giao diện FlyAroundAnimationOptions

Giao diện google.maps.maps3d.FlyAroundAnimationOptions

Các tuỳ chọn tuỳ chỉnh cho Ảnh động FlyCameraOnce.
camera
Loại:  CameraOptions
Điểm trung tâm mà máy ảnh sẽ nhìn vào trong ảnh động quỹ đạo. Xin lưu ý rằng tiêu đề bản đồ sẽ thay đổi khi máy ảnh quay quanh điểm trung tâm này.
durationMillis optional
Loại:  number optional
Thời lượng của ảnh động tính bằng mili giây. Đây là tổng thời lượng của ảnh động, chứ không phải thời lượng của một lần xoay.
rounds optional
Loại:  number optional
Số vòng quay quanh tâm trong khoảng thời gian nhất định. Giá trị này kiểm soát tốc độ xoay tổng thể. Việc truyền một số âm vào các vòng sẽ khiến máy ảnh xoay theo hướng ngược chiều kim đồng hồ thay vì hướng mặc định theo chiều kim đồng hồ.

Giao diện FlyToAnimationOptions

Giao diện google.maps.maps3d.FlyToAnimationOptions

Các tuỳ chọn tuỳ chỉnh cho ảnh động FlyCameraTo.
endCamera
Loại:  CameraOptions
Vị trí mà máy ảnh sẽ hướng đến ở cuối ảnh động.
durationMillis optional
Loại:  number optional
Thời lượng của ảnh động tính bằng mili giây. Thời lượng 0 sẽ dịch chuyển máy ảnh thẳng đến vị trí kết thúc.

Giao diện CameraOptions

Giao diện google.maps.maps3d.CameraOptions

Đối tượng CameraOptions dùng để xác định các thuộc tính có thể được đặt trên đối tượng máy ảnh. Đối tượng máy ảnh có thể là bất kỳ đối tượng nào có vị trí máy ảnh, ví dụ: trạng thái bản đồ hiện tại hoặc trạng thái ảnh động được yêu cầu trong tương lai.
center optional
Vui lòng xem Map3DElement.center.
heading optional
Loại:  number optional
Vui lòng xem Map3DElement.heading.
range optional
Loại:  number optional
Vui lòng xem Map3DElement.range.
roll optional
Loại:  number optional
Vui lòng xem Map3DElement.roll.
tilt optional
Loại:  number optional
Vui lòng xem Map3DElement.tilt.

Lớp SteadyChangeEvent

Lớp google.maps.maps3d.SteadyChangeEvent

Sự kiện này được tạo từ việc theo dõi trạng thái ổn định của Map3DElement. Sự kiện này sẽ được truyền lên qua cây DOM.

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

Truy cập bằng cách gọi const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
isSteady
Loại:  boolean
Cho biết Map3DElement có ổn định hay không (tức là mọi quá trình kết xuất cho cảnh hiện tại đã hoàn tất) hay không.

Lớp LocationClickEvent

Lớp google.maps.maps3d.LocationClickEvent

Sự kiện này được tạo từ thao tác nhấp vào Map3DElement.

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

Truy cập bằng cách gọi const {LocationClickEvent} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
position
Loại:  LatLngAltitude optional
Vĩ độ/kinh độ/độ cao thấp hơn con trỏ khi sự kiện xảy ra. Xin lưu ý rằng ở các cấp độ chi tiết hơn, dữ liệu sẽ kém chính xác hơn. Ngoài ra, hệ thống có thể trả về độ cao của đáy biển cho giá trị độ cao khi nhấp vào mặt nước từ các vị trí máy ảnh cao hơn. Sự kiện này sẽ được truyền lên qua cây DOM.

Lớp PlaceClickEvent

Lớp google.maps.maps3d.PlaceClickEvent

Sự kiện này được tạo từ thao tác nhấp vào Map3DElement.

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

Truy cập bằng cách gọi const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
placeId
Loại:  string
Mã địa điểm của đối tượng bản đồ.
Được kế thừa: position
fetchPlace
fetchPlace()
Thông số:  Không có
Giá trị trả về:  Promise<Place>
Tìm nạp Place cho mã địa điểm này. Trong đối tượng Place thu được, thuộc tính id sẽ được điền sẵn. Sau đó, bạn có thể yêu cầu các trường bổ sung qua Place.fetchFields() tuân theo việc bật và thanh toán API Địa điểm thông thường. Lời hứa sẽ bị từ chối nếu xảy ra lỗi khi tìm nạp Place.

Lớp Marker3DElement

Lớp google.maps.maps3d.Marker3DElement

Cho biết vị trí trên bản đồ 3D. Xin lưu ý rằng bạn phải đặt position để Marker3DElement hiển thị.

Phần tử tuỳ chỉnh:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>

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

Lớp này sẽ triển khai Marker3DElementOptions.

Truy cập bằng cách gọi const {Marker3DElement} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
Marker3DElement
Marker3DElement([options])
Thông số: 
Tạo một Marker3DElement với các tuỳ chọn được chỉ định.
altitudeMode
Loại:  AltitudeMode optional
Chỉ định cách diễn giải thành phần độ cao của vị trí.
Thuộc tính HTML:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
Loại:  CollisionBehavior optional
Bảng liệt kê chỉ định cách Marker3DElement nên hoạt động khi va chạm với một Marker3DElement khác hoặc với các nhãn bản đồ cơ sở.
Thuộc tính HTML:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
Loại:  boolean optional
Mặc định: false
Chỉ định xem có nên vẽ điểm đánh dấu này hay không khi bị che khuất. Điểm đánh dấu có thể bị che khuất bởi hình học bản đồ (ví dụ: các toà nhà).
Thuộc tính HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Loại:  boolean optional
Mặc định: false
Chỉ định xem có kết nối điểm đánh dấu với mặt đất hay không. Để đẩy điểm đánh dấu, altitudeMode phải là RELATIVE_TO_GROUND hoặc ABSOLUTE.
Thuộc tính HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Loại:  string optional
Văn bản sẽ được hiển thị bằng điểm đánh dấu này.
Thuộc tính HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
Vị trí của đầu bút đánh dấu. Độ cao bị bỏ qua trong một số chế độ nhất định và do đó là không bắt buộc.
sizePreserved
Loại:  boolean optional
Mặc định: false
Chỉ định xem điểm đánh dấu này có giữ nguyên kích thước hay không, bất kể khoảng cách từ máy ảnh. Theo mặc định, điểm đánh dấu được điều chỉnh theo tỷ lệ dựa trên khoảng cách từ máy ảnh/độ nghiêng.
Thuộc tính HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Loại:  number optional
zIndex so với các điểm đánh dấu khác.
Thuộc tính HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Mọi phần tử tuỳ chỉnh được thêm trực tiếp vào Marker3DElement sẽ được đưa vào khe, tuy nhiên chỉ các phần tử thuộc loại HTMLImageElement, SVGElement và PinElement mới được dùng để vẽ điểm đánh dấu, các phần tử khác sẽ bị bỏ qua. Bạn phải gói
HTMLImageElement và SVGElement trong phần tử <template> trước khi chỉ định cho khe mặc định của Marker3DElement.

Hình ảnh và SVG hiện được tạo điểm ảnh trước khi kết xuất trong cảnh 3D, vì vậy, HTML tuỳ chỉnh được nhúng vào các lớp SVG hoặc CSS được thêm vào hình ảnh sẽ không được áp dụng và có thể không được phản ánh khi điểm đánh dấu hiển thị trên màn hình.
BetaaddEventListener
addEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các tuỳ chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Thông số: 
Giá trị trả về:  void
Xoá trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Hãy xem removeEventListener

Giao diện Marker3DElementOptions

Giao diện google.maps.maps3d.Marker3DElementOptions

Đối tượng Marker3DElementOptions dùng để xác định các thuộc tính có thể được đặt trên Marker3DElement.
altitudeMode optional
Loại:  AltitudeMode optional
Vui lòng xem Marker3DElement.altitudeMode.
collisionBehavior optional
Loại:  CollisionBehavior optional
Vui lòng xem Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
Loại:  boolean optional
Vui lòng xem Marker3DElement.drawsWhenOccluded.
extruded optional
Loại:  boolean optional
Vui lòng xem Marker3DElement.extruded.
label optional
Loại:  string optional
Vui lòng xem Marker3DElement.label.
position optional
Vui lòng xem Marker3DElement.position.
sizePreserved optional
Loại:  boolean optional
Vui lòng xem Marker3DElement.sizePreserved.
zIndex optional
Loại:  number optional
Vui lòng xem Marker3DElement.zIndex.

Lớp Marker3DCollaboratiElement

Lớp google.maps.maps3d.Marker3DInteractiveElement

Cho biết vị trí trên bản đồ 3D. Xin lưu ý rằng bạn phải đặt position để Marker3DInteractiveElement hiển thị. Không giống như Marker3DElement, Marker3DInteractiveElement nhận được sự kiện gmp-click.

Phần tử tuỳ chỉnh:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

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

Lớp này triển khai Marker3DInteractiveElementOptions.

Truy cập bằng cách gọi const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Thông số: 
Tạo một Marker3DInteractiveElement có các tuỳ chọn được chỉ định.
Kế thừa: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Mọi phần tử tuỳ chỉnh được thêm trực tiếp vào Marker3DInteractiveElement sẽ được đưa vào khe, tuy nhiên chỉ các phần tử thuộc loại PinElement mới được dùng để vẽ điểm đánh dấu, các phần tử khác sẽ bị bỏ qua.
addEventListener
addEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các tuỳ chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener
removeEventListener
removeEventListener(type, listener[, options])
Thông số: 
Giá trị trả về:  void
Xoá trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Hãy xem removeEventListener
gmp-click
function(clickEvent)
Đối số: 
Sự kiện này được kích hoạt khi người dùng nhấp vào phần tử Marker3DInteractiveElement.

Giao diện Marker3DInteractiveElementOptions

Giao diện google.maps.maps3d.Marker3DInteractiveElementOptions

Đối tượng Marker3DInteractiveElementOptions dùng để xác định các thuộc tính có thể được đặt trên Marker3DInteractiveElement.

Giao diện này mở rộng Marker3DElementOptions.

Kế thừa: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Lớp Model3DElement

Lớp google.maps.maps3d.Model3DElement

Mô hình 3D cho phép kết xuất mô hình gLTF. Xin lưu ý rằng bạn phải đặt position và src để Model3DElement hiển thị.

Các thuộc tính cốt lõi của gLTF PBR phải được hỗ trợ. Hiện không hỗ trợ tiện ích hoặc thuộc tính tiện ích nào.

Phần tử tuỳ chỉnh:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

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

Lớp này triển khai Model3DElementOptions.

Truy cập bằng cách gọi const {Model3DElement} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
Model3DElement
Model3DElement([options])
Thông số: 
Tạo một Model3DElement với các tuỳ chọn được chỉ định.
altitudeMode
Loại:  AltitudeMode optional
Chỉ định cách diễn giải độ cao trong vị trí.
Thuộc tính HTML:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
Mô tả sự quay của hệ toạ độ trong mô hình 3D để định vị mô hình trên Bản đồ 3D.

Các phép xoay được áp dụng cho mô hình theo thứ tự sau: lăn, nghiêng rồi đến hướng.
position
Đặt vị trí của Model3DElement. Độ cao bị bỏ qua trong một số chế độ nhất định và do đó là không bắt buộc.
scale
Loại:  number|Vector3D|Vector3DLiteral optional
Mặc định: 1
Điều chỉnh tỷ lệ mô hình dọc theo trục x, y và z trong không gian toạ độ của mô hình.
src
Loại:  string|URL optional
Chỉ định URL của mô hình 3D. Hiện tại, chúng tôi chỉ hỗ trợ các mô hình ở định dạng .glb.

Mọi URL HTTP tương đối sẽ được phân giải thành URL tuyệt đối tương ứng.

Xin lưu ý rằng nếu bạn lưu trữ các tệp mô hình .glb trên một trang web hoặc máy chủ khác với ứng dụng chính, hãy nhớ thiết lập đúng tiêu đề HTTP CORS. Điều này cho phép ứng dụng của bạn truy cập an toàn vào các tệp mô hình từ miền khác.
Thuộc tính HTML:
  • <gmp-model-3d src="src"></gmp-model-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các tuỳ chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Thông số: 
Giá trị trả về:  void
Xoá trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener

Giao diện Model3DElementOptions

Giao diện google.maps.maps3d.Model3DElementOptions

Đối tượng Model3DElementOptions dùng để xác định các thuộc tính có thể được đặt trên Model3DElement.
altitudeMode optional
Loại:  AltitudeMode optional
Vui lòng xem Model3DElement.altitudeMode.
orientation optional
Vui lòng xem Model3DElement.orientation.
position optional
Vui lòng xem Model3DElement.position.
scale optional
Loại:  number|Vector3D|Vector3DLiteral optional
Vui lòng xem Model3DElement.scale.
src optional
Loại:  string|URL optional
Vui lòng xem Model3DElement.src.

Lớp Polyline3DElement

Lớp google.maps.maps3d.Polyline3DElement

Đường đa giác 3D là một lớp phủ tuyến tính của các đoạn đường được kết nối trên bản đồ 3D.

Phần tử tuỳ chỉnh:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

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

Lớp này triển khai Polyline3DElementOptions.

Truy cập bằng cách gọi const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
Polyline3DElement
Polyline3DElement([options])
Thông số: 
Tạo một Polyline3DElement với các tuỳ chọn được chỉ định.
altitudeMode
Loại:  AltitudeMode optional
Mặc định: AltitudeMode.ABSOLUTE
Chỉ định cách diễn giải các thành phần độ cao trong toạ độ.
Thuộc tính HTML:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
Trình tự toạ độ được sắp xếp của Polyline. Độ cao bị bỏ qua trong một số chế độ nhất định và do đó là không bắt buộc.
drawsOccludedSegments
Loại:  boolean optional
Mặc định: false
Chỉ định xem có vẽ các phần của đường đa tuyến có thể bị che khuất hay không. Đường đa tuyến có thể bị che khuất bởi hình học bản đồ (ví dụ: toà nhà).
Thuộc tính HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Loại:  boolean optional
Mặc định: false
Chỉ định xem có kết nối đường đa tuyến với mặt đất hay không. Để đẩy một đường đa tuyến, altitudeMode phải là RELATIVE_TO_GROUND hoặc ABSOLUTE.
Thuộc tính HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Loại:  boolean optional
Mặc định: false
Khi true, các cạnh của đa tuyến được diễn giải là đường trắc địa và sẽ tuân theo độ cong của Trái Đất. Khi false, các cạnh của hình nhiều đường được kết xuất dưới dạng đường thẳng trong không gian màn hình.
Thuộc tính HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Loại:  string optional
Màu bên ngoài. Tất cả màu CSS3 đều được hỗ trợ.
Thuộc tính HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
Loại:  number optional
Chiều rộng bên ngoài nằm trong khoảng từ 0.0 đến 1.0. Đây là tỷ lệ phần trăm của strokeWidth.
Thuộc tính HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
Loại:  string optional
Màu nét vẽ. Tất cả màu CSS3 đều được hỗ trợ.
Thuộc tính HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
Loại:  number optional
Độ rộng nét vẽ tính bằng pixel.
Thuộc tính HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Loại:  number optional
zIndex so với các đa giác khác.
Thuộc tính HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thứchandleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các tuỳ chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Thông số: 
Giá trị trả về:  void
Xoá trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener

Giao diện Polyline3DElementOptions

Giao diện google.maps.maps3d.Polyline3DElementOptions

Đối tượng Polyline3DElementOptions dùng để xác định các thuộc tính có thể được đặt trên Polyline3DElement.
altitudeMode optional
Loại:  AltitudeMode optional
Vui lòng xem Polyline3DElement.altitudeMode.
coordinates optional
Vui lòng xem Polyline3DElement.coordinates.
drawsOccludedSegments optional
Loại:  boolean optional
Vui lòng xem Polyline3DElement.drawsOccludedSegments.
extruded optional
Loại:  boolean optional
Vui lòng xem Polyline3DElement.extruded.
geodesic optional
Loại:  boolean optional
Vui lòng xem Polyline3DElement.geodesic.
outerColor optional
Loại:  string optional
Vui lòng xem Polyline3DElement.outerColor.
outerWidth optional
Loại:  number optional
Vui lòng xem Polyline3DElement.outerWidth.
strokeColor optional
Loại:  string optional
Vui lòng xem Polyline3DElement.strokeColor.
strokeWidth optional
Loại:  number optional
Vui lòng xem Polyline3DElement.strokeWidth.
zIndex optional
Loại:  number optional
Vui lòng xem Polyline3DElement.zIndex.

Lớp Polygon3DElement

Lớp google.maps.maps3d.Polygon3DElement

Đa giác 3D (chẳng hạn như đa tuyến 3D) xác định một loạt toạ độ được kết nối theo trình tự có thứ tự. Ngoài ra, đa giác tạo thành một vòng lặp kín và xác định một vùng được tô màu.

Phần tử tuỳ chỉnh:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

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

Lớp này triển khai Polygon3DElementOptions.

Truy cập bằng cách gọi const {Polygon3DElement} = await google.maps.importLibrary("maps3d"). Xem Thư viện trong Maps JavaScript API.
Polygon3DElement
Polygon3DElement([options])
Thông số: 
Tạo một Polygon3DElement với các tuỳ chọn được chỉ định.
altitudeMode
Loại:  AltitudeMode optional
Mặc định: AltitudeMode.ABSOLUTE
Chỉ định cách diễn giải các thành phần độ cao trong toạ độ.
Thuộc tính HTML:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
Loại:  boolean optional
Mặc định: false
Chỉ định xem có vẽ các phần của đa giác có thể bị che khuất hay không. Hình đa giác có thể bị che khuất bởi hình học bản đồ (ví dụ: toà nhà).
Thuộc tính HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Loại:  boolean optional
Mặc định: false
Chỉ định xem có kết nối đa giác với mặt đất hay không. Để đẩy một đa giác, altitudeMode phải là RELATIVE_TO_GROUND hoặc ABSOLUTE.
Thuộc tính HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Loại:  string optional
Màu nền. Tất cả màu CSS3 đều được hỗ trợ.
Thuộc tính HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
Loại:  boolean optional
Mặc định: false
Khi true, các cạnh của đa giác được hiểu là đường trắc địa và sẽ tuân theo đường cong của Trái đất. Khi false, các cạnh của đa giác được kết xuất dưới dạng đường thẳng trong không gian màn hình.
Thuộc tính HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
Trình tự toạ độ có thứ tự chỉ định một vòng lặp kín. Không giống như đa tuyến, đa giác có thể bao gồm một hoặc nhiều đường dẫn, tạo ra nhiều phần cắt bên trong đa giác.
outerCoordinates
Trình tự toạ độ có thứ tự chỉ định một vòng lặp kín. Độ cao bị bỏ qua trong một số chế độ nhất định và do đó là không bắt buộc.
strokeColor
Loại:  string optional
Màu nét vẽ. Tất cả màu CSS3 đều được hỗ trợ.
Thuộc tính HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
Loại:  number optional
Độ rộng nét vẽ tính bằng pixel.
Thuộc tính HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Loại:  number optional
zIndex so với các đa giác khác.
Thuộc tính HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Thông số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường đại diện cho loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được phân phối đến mục tiêu. Xem addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Thông số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó với addEventListener khỏi mục tiêu. Xem removeEventListener

Giao diện Polygon3DElementOptions

Giao diện google.maps.maps3d.Polygon3DElementOptions

Đối tượng Polygon3DElementOptions dùng để xác định các thuộc tính có thể đặt trên Polygon3DElement.
altitudeMode optional
Loại:  AltitudeMode optional
Vui lòng xem Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
Loại:  boolean optional
Vui lòng xem Polygon3DElement.drawsOccludedSegments.
extruded optional
Loại:  boolean optional
Vui lòng xem Polygon3DElement.extruded.
fillColor optional
Loại:  string optional
Vui lòng xem Polygon3DElement.fillColor.
geodesic optional
Loại:  boolean optional
Vui lòng xem Polygon3DElement.geodesic.
innerCoordinates optional
Vui lòng xem Polygon3DElement.innerCoordinates.
outerCoordinates optional
Vui lòng xem Polygon3DElement.outerCoordinates.
strokeColor optional
Loại:  string optional
Vui lòng xem Polygon3DElement.strokeColor.
strokeWidth optional
Loại:  number optional
Vui lòng xem Polygon3DElement.strokeWidth.
zIndex optional
Loại:  number optional
Vui lòng xem Polygon3DElement.zIndex.

Hằng số AltitudeMode

Hằng số google.maps.maps3d.AltitudeMode

Chỉ định cách diễn giải các thành phần độ cao trong toạ độ.

Truy cập bằng cách gọi const {AltitudeMode} = await google.maps.importLibrary("maps3d"). Xem phần Thư viện trong API Maps JavaScript.
ABSOLUTE Cho phép biểu thị các đối tượng so với mực nước biển trung bình. Điều đó cũng có nghĩa là nếu độ chi tiết của địa hình thay đổi bên dưới đối tượng, thì vị trí tuyệt đối của đối tượng đó sẽ vẫn giữ nguyên.
CLAMP_TO_GROUND Cho phép thể hiện các đối tượng được đặt trên mặt đất. Các đường này sẽ vẫn ở cấp mặt đất theo địa hình bất kể độ cao được cung cấp là bao nhiêu. Nếu đối tượng được đặt trên một vùng nước lớn, thì đối tượng đó sẽ được đặt ở mực nước biển.
RELATIVE_TO_GROUND Cho phép biểu thị các vật thể tương ứng với bề mặt mặt đất. Nếu mức độ chi tiết của địa hình thay đổi, vị trí của đối tượng sẽ không đổi so với mặt đất. Khi ở trên mặt nước, độ cao sẽ được hiểu là một giá trị tính bằng mét trên mực nước biển.
RELATIVE_TO_MESH Cho phép thể hiện các đối tượng so với mặt đất + mặt nước + mặt bằng cao nhất của toà nhà. Khi bay trên mặt nước, đây sẽ là mặt nước; khi bay trên địa hình, đây sẽ là mặt của toà nhà (nếu có) hoặc mặt đất (nếu không có toà nhà).