Places UI Kit: Một thư viện có thể sử dụng ngay, cung cấp không gian tuỳ chỉnh và kiểm soát cho nhà phát triển. Hãy dùng thử và chia sẻ ý kiến của bạn về trải nghiệm dùng Bộ giao diện người dùng.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

3D Maps

Lớp Map3DElement

google.maps.maps3d.Map3DElement class
extends HTMLElement
implements Map3DElementOptions
library "maps3d"

Map3DElement là một giao diện HTML cho chế độ xem Bản đồ 3D. Xin lưu ý rằng bạn phải đặt mode để Bản đồ 3D bắt đầu hiển thị.

                  
<gmp-map-3d
  autofits-camera-animation="value-name"
  camera-position="lat,lng,altitude"
  center="lat,lng,altitude"
  default-ui-hidden
  description="string"
  fov="number"
  gesture-handling="value-name"
  heading="number"
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  max-altitude="number"
  max-heading="number"
  max-tilt="number"
  min-altitude="number"
  min-heading="number"
  min-tilt="number"
  mode="value-name"
  range="number"
  roll="number"
  tilt="number">
</gmp-map-3d>

const {Map3DElement} = await google.maps.importLibrary("maps3d");

Hàm dựng
`Map3DElement`	`Map3DElement([options])` Tham số: `options`: `Map3DElementOptions optional`

Thuộc tính
`autofitsCameraAnimation` attr: autofits-camera-animation	Lưu ý: Chỉ có trong kênh v=alpha. Loại dữ liệu đầu vào: `AutofitsCameraAnimation optional` Loại dữ liệu đầu ra: `AutofitsCameraAnimation optional` Mặc định: `none` Ảnh động dùng để tự động điều chỉnh camera. Thuộc tính HTML: `autofits-camera-animation="value-name"`
`bounds`	Loại dữ liệu đầu vào: `LatLngBounds\|LatLngBoundsLiteral optional` Loại dữ liệu đầu ra: `LatLngBounds optional` Khi được đặt, thuộc tính này sẽ giới hạn vị trí của camera trong ranh giới vĩ độ/kinh độ đã chỉ định. Xin lưu ý rằng các đối tượng nằm 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 các ranh giới chỉ có vĩ độ, hãy sử dụng kinh độ tây và kinh độ đông lần lượt là `-180` và `180`. Đối với các ranh giới chỉ có kinh độ, hãy sử dụng vĩ độ bắc và vĩ độ nam tương ứng là `90` và `-90`.
`cameraPosition` attr: camera-position	Loại dữ liệu đầu vào: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` Loại dữ liệu đầu ra: `LatLngAltitude optional` Vị trí của camera được cung cấp dưới dạng LatLngAltitude. Sẽ được lấy nếu bị bỏ qua. Nếu bạn bỏ qua `center` nhưng chỉ định `cameraPosition`, thì `center` sẽ lấy từ `cameraPosition.`. Nếu cả hai đều được cập nhật trong cùng một vòng lặp chạy, thì `cameraPosition` sẽ được ưu tiên. Các trường `cameraPosition` và `center` có thể được lấy theo tỷ lệ một-một từ nhau trong bối cảnh của hướng, phạm vi, độ nghiêng và độ nghiêng được chia sẻ nhất định. Thuộc tính HTML: `camera-position="lat,lng,altitude"`
`center` attr: center	Loại dữ liệu đầu vào: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` Loại dữ liệu đầu ra: `LatLngAltitude optional` Tâm của bản đồ được cung cấp dưới dạng LatLngAltitude, trong đó cao độ tính bằng mét so với mực nước biển trung bình. 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 từ tâm bản đồ. Nếu không được đặt, 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: `center="lat,lng,altitude"`
`defaultUIHidden` attr: default-ui-hidden	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Mặc định: `false` Khi `true`, tất cả các nút giao diện người dùng mặc định đều bị ẩn. Thuộc tính HTML: `default-ui-hidden`
`description` attr: description	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string optional` Nếu được cung cấp, nội dung mô tả về khả năng hỗ trợ tiếp cận (ví dụ: để sử dụng với trình đọc màn hình) sẽ được thêm vào bản đồ cùng với giá trị được cung cấp. Thuộc tính HTML: `description="string"`
`fov` attr: fov	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Chỉ định trường nhìn dọc theo độ. Giá trị hợp lệ nằm trong khoảng từ 5,0 đến 80,0. Giá trị càng cao thì vùng hiển thị càng lớn nhưng có thể gây ra hiện tượng méo phối cảnh. Mặc định: 35.0. Thuộc tính HTML: `fov="number"`
`gestureHandling` attr: gesture-handling	Loại dữ liệu đầu vào: `GestureHandling optional` Loại dữ liệu đầu ra: `GestureHandling` Mặc định: `GestureHandling.GREEDY` Kiểm soát việc xử lý cử chỉ hợp tác. Khi bạn đặt thành `COOPERATIVE`, người dùng phải sử dụng phím bổ trợ hoặc cử chỉ bằng hai ngón tay để di chuyển bản đồ. Khi bạn đặt thành `GREEDY`, trang lưu trữ không thể cuộn từ các sự kiện của người dùng trên phần tử bản đồ. Khi được đặt thành `AUTO`, việc xử lý cử chỉ sẽ được xác định bằng khả năng cuộn của trang lưu trữ. Thuộc tính HTML: `gesture-handling="value-name"`
`heading` attr: heading	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Hướng la bàn của bản đồ, tính bằng độ, trong đó hướng chính bắc là 0. Khi không có độ nghiêng, mọi độ lăn sẽ được hiểu là hướng. Thuộc tính HTML: `heading="number"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Thêm mã phân bổ mức sử dụng vào trình khởi tạo, giúp Google hiểu được thư viện và mẫu nào hữu ích cho nhà phát triển, chẳng hạn như mức sử dụng thư viện phân cụm điểm đánh dấu. Để chọn không gửi mã nhận dạng nguồn gốc sử dụng, bạn có thể xoá thuộc tính này. Chỉ gửi các giá trị riêng biệt. Các thay đổi đối với giá trị này sau khi tạo thực thể có thể bị bỏ qua. Thuộc tính HTML: `internal-usage-attribution-ids="id1 id2"`
`language`	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string optional` Ngôn ngữ mà bạn muốn hiển thị trên bản đồ cơ sở. Sẽ mặc định là ngôn ngữ mà nhà phát triển yêu cầu khi tải Maps JS API.
`mapId` attr: map-id	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string optional` Chỉ định mã bản đồ sẽ được dùng để tìm nạp kiểu bản đồ dựa trên đám mây cho bản đồ. Thuộc tính HTML: `map-id="string"`
`maxAltitude` attr: max-altitude	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `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: `max-altitude="number"`
`maxHeading` attr: max-heading	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Góc hướng (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 <= `360` độ mà trong đó cử chỉ đầu 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 hướng đi trong `[90, 180]`. Thuộc tính HTML: `max-heading="number"`
`maxTilt` attr: max-tilt	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `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: `max-tilt="number"`
`minAltitude` attr: min-altitude	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Độ cao tối thiểu so với mặt đất sẽ được 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: `min-altitude="number"`
`minHeading` attr: min-heading	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `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 <= `360` độ mà trong đó cử chỉ đầu 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 hướng đi trong `[90, 180]`. Thuộc tính HTML: `min-heading="number"`
`minTilt` attr: min-tilt	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `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: `min-tilt="number"`
`mode` attr: mode	Loại dữ liệu đầu vào: `MapMode optional` Loại dữ liệu đầu ra: `MapMode optional` Chỉ định chế độ hiển thị bản đồ. Nếu bạn không đặt, bản đồ sẽ không được kết xuất. Thuộc tính HTML: `mode="value-name"`
`range` attr: range	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Khoảng cách từ camera đến tâm bản đồ, tính bằng mét. Thuộc tính HTML: `range="number"`
`region`	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string optional` Khu vực để thử kết xuất các địa điểm yêu thích của bản đồ cơ sở. Theo mặc định, hệ thống sẽ sử dụng vùng mà nhà phát triển yêu cầu khi tải Maps JS API.
`roll` attr: roll	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Góc xoay của camera xung quanh vectơ xem, tính bằng độ. Để giải quyết các trường hợp không rõ ràng, khi không có độ nghiêng, mọi độ lăn sẽ được hiểu là hướng. Thuộc tính HTML: `roll="number"`
`tilt` attr: tilt	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Độ nghiêng của vectơ chế độ xem camera, tính bằng độ. Vectơ chế độ xem nhìn thẳng xuống trái đất sẽ có độ nghiêng bằng 0 độ. Vectơ chế độ xem hướng ra xa trái đất sẽ có độ nghiêng là `180` độ. Thuộc tính HTML: `tilt="number"`
`defaultUIDisabled` attr: default-ui-disabled	Không dùng nữa: Vui lòng sử dụng `Map3DElement.defaultUIHidden`. Thuộc tính này sẽ bị xoá trong bản phát hành sau này. Loạ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 đều bị tắt. Không tắt các chế độ điều khiển bằng bàn phím và cử chỉ. Thuộc tính HTML: `default-ui-disabled`

Phương thức
`flyCameraAround`	`flyCameraAround(options)` Tham số: `options`: `FlyAroundAnimationOptions` 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. Ảnh động có thể lặp lại theo số lần `FlyAroundAnimationOptions.repeatCount` đã cho. Camera sẽ di chuyển theo chiều kim đồng hồ. Vị trí được chỉ định để xoay quanh là `CameraOptions.center`. Đây là vị trí sẽ xuất hiện ở giữa khung nhìn trong ảnh động quỹ đạo, trong khi camera di chuyển xung quanh vị trí đó. 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 ảnh động bắt đầu. Nếu số lần `FlyAroundAnimationOptions.repeatCount` là 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)` Tham số: `options`: `FlyToAnimationOptions` Giá trị trả về: Không có Phương thức này di chuyển camera 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. Bạn có thể chỉ định vị trí kết thúc thông qua `CameraOptions.cameraPosition` (kiểm soát vị trí chính xác của camera) hoặc thông qua `CameraOptions.center` (kiểm soát tâm khung nhìn hiển thị của bản đồ). 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 ảnh động bắt đầu.
`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. Máy ảnh sẽ giữ nguyên vị trí ở giữa ảnh động; 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.
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-animationend`	`function(animationEndEvent)` Đối số: `animationEndEvent`: `Event optional` Sự kiện này được kích hoạt khi ảnh động bay kết thúc. Sự kiện này nổi lên thông qua cây DOM.
`gmp-camerapositionchange`	`function(cameraPositionChangeEvent)` Đối số: `cameraPositionChangeEvent`: `Event optional` Sự kiện này được kích hoạt khi thuộc tính cameraPosition của Map3DElement thay đổi.
`gmp-centerchange`	`function(centerChangeEvent)` Đối số: `centerChangeEvent`: `Event optional` 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ố: `clickEvent`: `LocationClickEvent\|PlaceClickEvent optional` Sự kiện này được kích hoạt khi người dùng nhấp vào phần tử `Map3DElement`.
`gmp-error`	`function(mapInitializationErrorEvent)` Đối số: `mapInitializationErrorEvent`: `Event optional` Sự kiện này được kích hoạt khi không thể khởi chạy bản đồ.
`gmp-fovchange`	`function(fovChangeEvent)` Đối số: `fovChangeEvent`: `Event optional` Sự kiện này được kích hoạt khi thuộc tính fov của Map3DElement thay đổi.
`gmp-headingchange`	`function(headingChangeEvent)` Đối số: `headingChangeEvent`: `Event optional` Sự kiện này được kích hoạt khi thuộc tính hướng của Map3DElement thay đổi.
`gmp-map-id-error`	`function(mapIdErrorEvent)` Đối số: `mapIdErrorEvent`: `Event optional` Sự kiện này được kích hoạt khi thuộc tính mapId của Map3DElement không hợp lệ.
`gmp-rangechange`	`function(rangeChangeEvent)` Đối số: `rangeChangeEvent`: `Event optional` 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 optional` Sự kiện này được kích hoạt khi thuộc tính roll của Map3DElement thay đổi.
`gmp-steadychange`	`function(steadyChangeEvent)` Đối số: `steadyChangeEvent`: `SteadyChangeEvent optional` 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 optional` 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

google.maps.maps3d.Map3DElementOptions giao diện

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

Thuộc tính
`autofitsCameraAnimation` không bắt buộc	Lưu ý: Chỉ có trong kênh v=alpha. Loại: `AutofitsCameraAnimation optional` Vui lòng xem `Map3DElement.autofitsCameraAnimation`.
`bounds` không bắt buộc	Loại: `LatLngBounds\|LatLngBoundsLiteral optional` Vui lòng xem `Map3DElement.bounds`.
`cameraPosition` không bắt buộc	Loại: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` Vui lòng xem `Map3DElement.cameraPosition`.
`center` không bắt buộc	Loại: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` Vui lòng xem `Map3DElement.center`.
`defaultUIDisabled` không bắt buộc	Không dùng nữa: Vui lòng sử dụng `Map3DElement.defaultUIHidden`. Thuộc tính này sẽ bị xoá trong bản phát hành sau này. Loại: `boolean optional` Vui lòng xem `Map3DElement.defaultUIDisabled`.
`defaultUIHidden` không bắt buộc	Loại: `boolean optional` Vui lòng xem `Map3DElement.defaultUIHidden`.
`description` không bắt buộc	Loại: `string optional` Vui lòng xem `Map3DElement.description`.
`fov` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.fov`.
`gestureHandling` không bắt buộc	Loại: `GestureHandling optional` Vui lòng xem `Map3DElement.gestureHandling`.
`heading` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.heading`.
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Vui lòng xem `Map3DElement.internalUsageAttributionIds`.
`language` không bắt buộc	Loại: `string optional` Vui lòng xem `Map3DElement.language`.
`mapId` không bắt buộc	Loại: `string optional` Vui lòng xem `Map3DElement.mapId`.
`maxAltitude` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.maxAltitude`.
`maxHeading` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.maxHeading`.
`maxTilt` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.maxTilt`.
`minAltitude` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.minAltitude`.
`minHeading` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.minHeading`.
`minTilt` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.minTilt`.
`mode` không bắt buộc	Loại: `MapMode optional` Vui lòng xem `Map3DElement.mode`.
`range` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.range`.
`region` không bắt buộc	Loại: `string optional` Vui lòng xem `Map3DElement.region`.
`roll` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.roll`.
`tilt` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.tilt`.

Hằng số MapMode

google.maps.maps3d.MapMode hằng số
thư viện "maps3d"

Chỉ định chế độ hiển thị bản đồ.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại MapModeString.

const {MapMode} = await google.maps.importLibrary("maps3d");

Hằng số
`HYBRID`	Chế độ bản đồ này hiển thị một lớp trong suốt gồm các đường phố chính trên hình ảnh vệ tinh hoặc hình ảnh chân thực.
`ROADMAP`	Lưu ý: Chỉ có trong kênh v=alpha. Chế độ bản đồ này hiển thị bản đồ đường phố thông thường.
`SATELLITE`	Chế độ bản đồ này hiển thị hình ảnh vệ tinh hoặc hình ảnh chân thực (nếu có).

Hằng số GestureHandling

google.maps.maps3d.GestureHandling hằng số
thư viện "maps3d"

Chỉ định cách xử lý các sự kiện cử chỉ trên phần tử bản đồ.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại GestureHandlingString.

const {GestureHandling} = await google.maps.importLibrary("maps3d");

Hằng số
`AUTO`	Điều này cho phép bản đồ chọn sử dụng tính năng xử lý cử chỉ hợp tác hay tham lam. Đây là hành vi mặc định nếu không được chỉ định. Thao tác này sẽ khiến bản đồ chuyển sang chế độ hợp tác nếu bản đồ chiếm ưu thế so với thành phần mẹ cuộn (thường là trang lưu trữ) đến mức người dùng không thể cuộn ra khỏi bản đồ để xem nội dung khác.
`COOPERATIVE`	Thao tác này sẽ buộc sử dụng chế độ hợp tác, trong đó cần có các phím bổ trợ hoặc cử chỉ bằng hai ngón tay để cuộn bản đồ.
`GREEDY`	Thao tác này sẽ buộc bật chế độ tham lam, trong đó trang lưu trữ không thể cuộn từ các sự kiện của người dùng trên phần tử bản đồ.

Hằng số AutofitsCameraAnimation

google.maps.maps3d.AutofitsCameraAnimation hằng số
thư viện "maps3d"

Chỉ định cách camera hoạt động khi di chuyển đến một vị trí mới để tự căn giữa theo các phần tử con đã chọn.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại AutofitsCameraAnimationString.

const {AutofitsCameraAnimation} = await google.maps.importLibrary("maps3d");

Hằng số
`FLY_TO`	Bay đến vị trí mới.
`NONE`	Chuyển đến vị trí mới mà không có ảnh động.

Giao diện FlyAroundAnimationOptions

google.maps.maps3d.FlyAroundAnimationOptions giao diện

Các tuỳ chọn tuỳ chỉnh cho Hoạt ảnh FlyCameraAround.

Thuộc tính
`camera`	Loại: `CameraOptions` Điểm trung tâm mà camera sẽ nhìn vào trong ảnh động quỹ đạo. Lưu ý rằng hướng bản đồ sẽ thay đổi khi camera quay quanh điểm trung tâm này.
`durationMillis` không bắt buộc	Loại: `number optional` Thời lượng của một chu kỳ ảnh động tính bằng mili giây.
`repeatCount` không bắt buộc	Loại: `number optional` Chỉ định số lần ảnh động sẽ lặp lại. Nếu số này bằng 0, ảnh động sẽ hoàn tất ngay sau khi bắt đầu. Nếu Number.Infinity được truyền, ảnh động sẽ lặp lại mãi mãi.
`rounds` không bắt buộc	Không dùng nữa: Vui lòng sử dụng `FlyAroundAnimationOptions.repeatCount`. Loại: `number optional` Số vòng xoay quanh tâm trong khoảng thời gian nhất định. Chế độ này kiểm soát tốc độ xoay tổng thể. Nếu bạn truyền một số âm vào tham số rounds, camera sẽ xoay theo hướng ngược chiều kim đồng hồ thay vì hướng mặc định là theo chiều kim đồng hồ.

Giao diện FlyToAnimationOptions

google.maps.maps3d.FlyToAnimationOptions giao diện

Các lựa chọn tuỳ chỉnh cho Ảnh động FlyCameraTo.

Thuộc tính
`endCamera`	Loại: `CameraOptions` Vị trí mà camera sẽ hướng đến khi kết thúc ảnh động.
`durationMillis` không bắt buộc	Loạ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í kết thúc.

Giao diện CameraOptions

google.maps.maps3d.CameraOptions giao diện

Đối tượng CameraOptions dùng để xác định các thuộc tính có thể đặt trên đối tượng camera. Đối tượng camera có thể là bất kỳ đố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.

Thuộc tính
`altitudeMode` không bắt buộc	Loại: `AltitudeMode optional` Mặc định: `AltitudeMode.ABSOLUTE` Một enum chỉ định cách diễn giải giá trị độ cao của đối tượng `CameraOptions` đã cho. Thao tác này sử dụng lại enum `AltitudeMode` hiện có.
`cameraPosition` không bắt buộc	Loại: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` Vui lòng xem `Map3DElement.cameraPosition`.
`center` không bắt buộc	Loại: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` Vui lòng xem `Map3DElement.center`.
`fov` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.fov`.
`heading` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.heading`.
`range` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.range`.
`roll` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.roll`.
`tilt` không bắt buộc	Loại: `number optional` Vui lòng xem `Map3DElement.tilt`.

Lớp SteadyChangeEvent

google.maps.maps3d.SteadyChangeEvent class
extends Event
library "maps3d"

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 nổi lên thông qua cây DOM.

const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d");

Thuộc tính
`isSteady`	Loại: `boolean` Cho biết Map3DElement có ổn định (tức là tất cả hoạt động kết xuất cho cảnh hiện tại đã hoàn tất) hay không.

Lớp LocationClickEvent

google.maps.maps3d.LocationClickEvent class
extends Event
library "maps3d"

Sự kiện này được tạo bằng cách nhấp vào Map3DElement.

const {LocationClickEvent} = await google.maps.importLibrary("maps3d");

Thuộc tính
`position`	Loại: `LatLngAltitude optional` Vĩ độ/kinh độ/cao độ nằm dưới con trỏ khi sự kiện xảy ra. Xin lưu ý rằng ở các cấp độ khái quát 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ừ các vị trí camera cao hơn. Sự kiện này nổi lên thông qua cây DOM.

Thuộc tính

position

Loại: LatLngAltitude optional

Vĩ độ/kinh độ/cao độ nằm dưới con trỏ khi sự kiện xảy ra. Xin lưu ý rằng ở các cấp độ khái quát 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ừ các vị trí camera cao hơn. Sự kiện này nổi lên thông qua cây DOM.

Lớp PlaceClickEvent

google.maps.maps3d.PlaceClickEvent class
extends LocationClickEvent
library "maps3d"

Sự kiện này được tạo bằng cách nhấp vào biểu tượng địa điểm trên Map3DElement. Để ngăn cửa sổ bật lên mặc định xuất hiện, hãy gọi phương thức preventDefault() cho sự kiện này để ngăn Map3DElement xử lý sự kiện đó.

const {PlaceClickEvent} = await google.maps.importLibrary("maps3d");

Thuộc tính
`placeId`	Loại: `string` Mã địa điểm của đối tượng trên bản đồ.
Được kế thừa: `position`

Phương thức
`fetchPlace`	`fetchPlace()` Tham 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 thông qua `Place.fetchFields()`, tuân theo quy trình kích hoạt và thanh toán thông thường của Places API. Lời hứa sẽ bị từ chối nếu có lỗi khi tìm nạp `Place`.

Phương thức

fetchPlace

fetchPlace()

Tham 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 thông qua Place.fetchFields(), tuân theo quy trình kích hoạt và thanh toán thông thường của Places API. Lời hứa sẽ bị từ chối nếu có lỗi khi tìm nạp Place.

3D Maps Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Lớp Map3DElement

Hàm dựng

Thuộc tính

Phương thức

Sự kiện

Giao diện Map3DElementOptions

Thuộc tính

Hằng số MapMode

Hằng số

Hằng số GestureHandling

Hằng số

Hằng số AutofitsCameraAnimation

Hằng số

Giao diện FlyAroundAnimationOptions

Thuộc tính

Giao diện FlyToAnimationOptions

Thuộc tính

Giao diện CameraOptions

Thuộc tính

Lớp SteadyChangeEvent

Thuộc tính

Lớp LocationClickEvent

Thuộc tính

Lớp PlaceClickEvent

Thuộc tính

Phương thức

3D Maps