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 triển khai Map3DElementOptions.

Truy cập bằng cách gọi const {Map3DElement} = await google.maps.importLibrary("maps3d").
Xem Thư viện trong Maps JavaScript API.
Map3DElement
Map3DElement([options])
Tham số: 
bounds
Khi được đặt, tham số này sẽ hạn chế vị trí của camera trong phạm vi vĩ độ/kinh độ đã chỉ định. Xin lưu ý rằng các đối tượng bên ngoài ranh giới vẫn được kết xuất. Ranh giới có thể hạn chế cả kinh độ và vĩ độ, hoặc chỉ hạn chế vĩ độ hoặc kinh độ. Đối với ranh giới chỉ có vĩ độ, hãy sử dụng kinh độ phía tây và phía đông của -180 và 180, tương ứng. Đối với ranh giới chỉ có kinh độ, hãy sử dụng vĩ độ bắc và vĩ độ nam lần lượt là 90 và -90.
center
Tâm của bản đồ được cho dưới dạng LatLngAltitude, trong đó độ cao tính bằng mét so với mực nước biển. Xin lưu ý rằng đây không nhất thiết là vị trí của camera, vì trường range ảnh hưởng đến khoảng cách của camera so với tâm bản đồ. Nếu không được thiết lập, giá trị mặc định sẽ là {lat: 0, lng: 0, altitude: 63170000}. 63.170.000 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 mặc định trên bản đồ 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 mặc định trên giao diện người dùng đều bị vô hiệu hoá. Không tắt các chế độ điều khiển bằng cử chỉ và bàn phím.
Thuộc tính HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Loại:  number optional
Hướng la bàn của bản đồ, tính bằng độ, trong đó hướng bắc là 0. Khi không có độ nghiêng, mọi độ xoay 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ẽ xuất hiện 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 phương vị (xoay) 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ị một khoảng thời gian <= 360 độ mà cử chỉ xoay đầu sẽ được cho phép. minHeading = 180 và maxHeading = 90 sẽ cho phép hướng đi ở [0, 90] và hướng đi ở [180, 360]. minHeading = 90 và maxHeading = 180 sẽ cho phép hướng đầ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ẽ xuất hiện 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 tối thiểu của hướng (xoay) của bản đồ. Giá trị hợp lệ nằm trong khoảng từ 0 đến 360 độ. minHeading và maxHeading biểu thị một khoảng thời gian <= 360 độ mà cử chỉ xoay đầu sẽ được cho phép. minHeading = 180 và maxHeading = 90 sẽ cho phép hướng đi ở [0, 90] và hướng đi ở [180, 360]. minHeading = 90 và maxHeading = 180 sẽ cho phép hướng đầ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ừ camera đế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
Góc xoay của camera xung quanh vectơ chế độ xem (tính bằng độ). Để giải quyết sự mơ hồ, khi không có độ nghiêng, mọi độ xoay sẽ được hiểu 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ơ góc nhìn của camera tính bằng độ. Một vectơ hướng nhìn thẳng xuống trái đất sẽ có độ nghiêng là 0 độ. Một vectơ chế độ xem hướng ra xa 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])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị 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 một đố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 gửi đến đích. Xem addEventListener.
flyCameraAround
flyCameraAround(options)
Tham số: 
Giá trị trả về:  Không có
Phương thức này xoay camera quanh một vị trí nhất định trong một khoảng thời gian nhất định, tạo ra số vòng quay nhất định trong khoảng thời gian đó.

Theo mặc định, camera sẽ xoay theo chiều kim đồng hồ. Nếu bạn nhập một số âm cho số vòng, camera sẽ xoay theo hướng ngược chiều 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 sẽ trả về sau khi hiệu ứng chuyển động bắt đầu.

Nếu số vòng quay là 0, thì sẽ không có vòng quay nào diễn ra và ảnh động sẽ hoàn tất ngay sau khi bắt đầu.
flyCameraTo
flyCameraTo(options)
Tham số: 
Giá trị trả về:  Không có
Phương thức này di chuyển camera theo đường parabol từ vị trí hiện tại đến một vị trí cuối đã cho 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 sẽ trả về sau khi hiệu ứng chuyển động bắt đầu.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.
stopCameraAnimation
stopCameraAnimation()
Tham số:  Không có
Giá trị trả về:  Không có
Phương thức này sẽ dừng mọi ảnh động bay có thể đang chạy. Camera vẫn ở nguyên vị trí trong quá trình tạo ảnh động; camera không dịch chuyển tức thời đến điểm cuối.

Phương thức này là 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 ảnh động bay kết thúc. Sự kiện này tạo chuỗi bọt (bong bóng) thông qua cây DOM.
gmp-centerchange
function(centerChangeEvent)
Đối số: 
  • centerChangeEvent:  Event
Sự kiện này sẽ kích hoạt khi thuộc tính 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 sẽ kích hoạt khi thuộc tính heading của Map3DElement thay đổi.
gmp-rangechange
function(rangeChangeEvent)
Đối số: 
  • rangeChangeEvent:  Event
Sự kiện này sẽ 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 sẽ kích hoạt khi thuộc tính roll 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 sẽ kích hoạt khi thuộc tính độ nghiêng của Map3DElement thay đổi.

Giao diện Map3DElementOptions

google.maps.maps3d.Map3DElementOptionsgiao diện

Đố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.

FlyAroundAnimationOptions giao diện

google.maps.maps3d.FlyAroundAnimationOptionsgiao diện

Các lựa chọn tuỳ chỉnh cho hiệu ứng FlyCameraAround.
camera
Loại:  CameraOptions
Điểm trung tâm mà camera sẽ hướng đến trong quá trình chuyển động quỹ đạo. Xin lưu ý rằng hướng của bản đồ sẽ thay đổi khi camera xoay 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 xoay quanh tâm trong khoảng thời gian đã cho. Điều này kiểm soát tốc độ xoay tổng thể. Nếu truyền một số âm vào rounds, camera sẽ xoay ngược chiều kim đồng hồ thay vì theo chiều kim đồng hồ mặc định.

Giao diện FlyToAnimationOptions

google.maps.maps3d.FlyToAnimationOptionsgiao diện

Các lựa chọn tuỳ chỉnh cho ảnh động FlyCameraTo.
endCamera
Loại:  CameraOptions
Vị trí mà camera sẽ hướng đến khi kết thúc ả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 bằng 0 sẽ dịch chuyển camera thẳng đến vị trí cuối.

Giao diện CameraOptions

google.maps.maps3d.CameraOptionsgiao diện

Đối tượng CameraOptions dùng để xác định các thuộc tính có thể được đặt trên một đối tượng camera. Đối tượng camera có thể là bất cứ đối tượng nào có vị trí camera, 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 giám sát trạng thái ổn định của Map3DElement. Sự kiện này tạo chuỗi bọt (bong bóng) thông 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 Thư viện trong Maps JavaScript API.
isSteady
Loại:  boolean
Cho biết Map3DElement có ổn định hay không (tức là tất cả quá trình kết xuất cho cảnh hiện tại đã hoàn tất).

Lớp LocationClickEvent

Lớp google.maps.maps3d.LocationClickEvent

Sự kiện này được tạo khi người dùng nhấp vào một 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 Thư viện trong Maps JavaScript API.
position
Loại:  LatLngAltitude optional
Vĩ độ/kinh độ/độ cao bên dưới con trỏ khi sự kiện xảy ra. Xin lưu ý rằng ở các cấp độ thô hơn, dữ liệu được trả về sẽ kém chính xác hơn. Ngoài ra, độ cao của đáy biển có thể được trả về cho giá trị độ cao khi nhấp vào mặt nước từ vị trí camera cao hơn. Sự kiện này tạo chuỗi bọt (bong bóng) thông qua cây DOM.

Lớp PlaceClickEvent

Lớp google.maps.maps3d.PlaceClickEvent

Sự kiện này được tạo khi người dùng nhấp vào một 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 Thư viện trong Maps JavaScript API.
placeId
Loại:  string
Mã địa điểm của đối tượng trên bản đồ.
Kế thừa: position
fetchPlace
fetchPlace()
Tham số:  Không có
Giá trị trả về:  Promise<Place>
Tìm nạp một Place cho mã địa điểm này. Trong đối tượng Place thu được, thuộc tính mã nhận dạng sẽ được điền sẵn. Sau đó, bạn có thể yêu cầu thêm các trường khác thông qua Place.fetchFields() theo quy trình bật và tính phí thông thường của Places API. Lời hứa 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

Hiển thị mộ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 triển khai Marker3DElementOptions.

Truy cập bằng cách gọi const {Marker3DElement} = await google.maps.importLibrary("maps3d").
Xem Thư viện trong Maps JavaScript API.
Marker3DElement
Marker3DElement([options])
Tham số: 
Tạo một Marker3DElement với các lựa chọn đã chỉ định.
altitudeMode
Loại:  AltitudeMode optional
Mặc định: AltitudeMode.CLAMP_TO_GROUND
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
Mặc định: CollisionBehavior.REQUIRED
Một phép liệt kê chỉ định cách Marker3DElement hoạt động khi va chạm với một Marker3DElement khác hoặc với 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 điểm đánh dấu 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 có kết nối điểm đánh dấu với mặt đất hay không. Để đùn một đ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 điểm đánh dấu này hiển thị.
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 sẽ bị bỏ qua ở một số chế độ và do đó là không bắt buộc.
sizePreserved
Loại:  boolean optional
Mặc định: false
Chỉ định liệu đ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ừ camera. Theo mặc định, điểm đánh dấu được điều chỉnh tỷ lệ dựa trên khoảng cách từ camera/độ 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 phân bổ, 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.
HTMLImageElement và SVGElement phải được bao bọc trong phần tử <template> trước khi chỉ định cho khe cắm mặc định của Marker3DElement.

Hình ảnh và SVG hiện được tạo điểm ảnh trước khi hiển thị trong cảnh 3D, vì vậy, HTML tuỳ chỉnh được nhúng vào SVG hoặc các lớp CSS được thêm vào hình ảnh sẽ không được áp dụng và có thể không xuất hiện khi các điểm đánh dấu hiển thị trên màn hình.
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị 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 một đố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 gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện Marker3DElementOptions

google.maps.maps3d.Marker3DElementOptionsgiao diện

Đối tượng Marker3DElementOptions dùng để xác định các thuộc tính có thể được đặt trên một 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 Marker3DInteractiveElement

Lớp google.maps.maps3d.Marker3DInteractiveElement

Hiển thị mộ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 một 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 Thư viện trong Maps JavaScript API.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Tham số: 
Tạo một Marker3DInteractiveElement với các lựa chọn đã 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 phân bổ, 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])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị 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 một đố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 gửi đến đích. Xem addEventListener
removeEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. 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

google.maps.maps3d.Marker3DInteractiveElementOptionsgiao diện

Đối tượng Marker3DInteractiveElementOptions dùng để xác định các thuộc tính có thể được đặt trên một 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ột mô hình 3D cho phép kết xuất các 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 Thư viện trong Maps JavaScript API.
Model3DElement
Model3DElement([options])
Tham số: 
Tạo một Model3DElement với các lựa chọn đã chỉ định.
altitudeMode
Loại:  AltitudeMode optional
Mặc định: AltitudeMode.CLAMP_TO_GROUND
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ả việc xoay hệ toạ độ của mô hình 3D để đặt 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: xoay, nghiêng rồi đến hướng.
position
Đặt vị trí của Model3DElement. Độ cao sẽ bị bỏ qua ở một số chế độ 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 các 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 đang 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 của mình, hãy nhớ thiết lập tiêu đề HTTP CORS chính xác. Đ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])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị 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 một đố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 gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện Model3DElementOptions

google.maps.maps3d.Model3DElementOptionsgiao diện

Đố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 nhiều đường 3D là một lớp phủ tuyến tính gồm các đoạn đường thẳ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 Thư viện trong Maps JavaScript API.
Polyline3DElement
Polyline3DElement([options])
Tham số: 
Tạo một Polyline3DElement với các lựa chọn đã 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
Chuỗi toạ độ được sắp xếp của Polyline. Độ cao sẽ bị bỏ qua ở một số chế độ và do đó là không bắt buộc.
drawsOccludedSegments
Loại:  boolean optional
Mặc định: false
Chỉ định xem các phần của đường nhiều đoạn có thể bị che khuất có được vẽ hay không. Đường nhiều đoạn có thể bị hình học bản đồ che khuất (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 nhiều đoạn với mặt đất hay không. Để đùn một đường nhiều đoạ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 đường nhiều đoạ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 đường nhiều đoạn đượ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 của 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])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị 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 một đố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 gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện Polyline3DElementOptions

google.maps.maps3d.Polyline3DElementOptionsgiao diện

Đối tượng Polyline3DElementOptions dùng để xác định các thuộc tính có thể đặ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ư đường nhiều đoạn 3D) xác định một chuỗi các toạ độ được kết nối theo một trình tự có thứ tự. Ngoài ra, đa giác tạo thành một vòng khé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])
Tham số: 
Tạo một Polygon3DElement với các lựa chọn đã 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ác phần của đa giác có thể bị che khuất có được vẽ hay không. Đ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 có kết nối đa giác với mặt đất hay không. Để đùn 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 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 đ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
Chuỗi toạ độ có thứ tự chỉ định một vòng khép kín. Không giống như đường nhiều đoạn, một đ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
Chuỗi toạ độ có thứ tự chỉ định một vòng khép kín. Độ cao sẽ bị bỏ qua ở một số chế độ 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 của 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])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị 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 một đố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 gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện Polygon3DElementOptions

google.maps.maps3d.Polygon3DElementOptionsgiao diện

Đối tượng Polygon3DElementOptions dùng để xác định các thuộc tính có thể được đặ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 Thư viện trong Maps JavaScript API.
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 mức độ 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. Chúng sẽ vẫn ở trên mặt đất theo địa hình, bất kể độ cao được cung cấp là bao nhiêu. Nếu đối tượng nằm 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 thể hiện các đối tượng so với bề 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ẽ vẫn 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 so với mực nước biển.
RELATIVE_TO_MESH Cho phép biểu thị các đối tượng so với bề mặt cao nhất của mặt đất + toà nhà + mặt nước. Khi ở trên mặt nước, đây sẽ là mặt nước; khi ở trên địa hình, đây sẽ là bề mặt của toà nhà (nếu có) hoặc bề mặt đất (nếu không có toà nhà).