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 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 phần Thư viện trong API Maps JavaScript.
Hàm dựng | |
---|---|
Map3DElement |
Map3DElement([options]) Thông số:
|
Thuộc tính | |
---|---|
bounds |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Khi được đặt, giới hạn vị trí của máy ảnh trong giới hạn lat/lng đã 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ả kinh độ và vĩ độ, hoặc chỉ hạn chế vĩ độ hoặc kinh độ. Đối với các giới hạn chỉ có 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 |
Loại:
LatLngAltitude|LatLngAltitudeLiteral optional Trung 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ặ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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
minHeading |
Loại:
number optional Góc hướng (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:
|
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:
|
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:
|
roll |
Loại:
number optional Độ nghiêng của máy ảnh xung quanh vectơ chế độ xem tính bằng độ. Để 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:
|
tilt |
Loại:
number optional Độ nghiêng của vectơ chế độ xem của máy ảnh tính bằng độ. Một vectơ chế độ xem nhìn thẳng xuống trái đất sẽ có độ nghiêng bằ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:
|
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Thông số:
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. Xem removeEventListener |
Sự kiện | |
---|---|
gmp-centerchange |
function(centerChangeEvent) Đối số:
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ố:
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ố:
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ố:
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ố:
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.
Thuộc tính | |
---|---|
bounds optional |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Vui lòng xem Map3DElement.bounds . |
center optional |
Loại:
LatLngAltitude|LatLngAltitudeLiteral optional Vui lòng xem Map3DElement.center . |
defaultLabelsDisabled optional |
Loại:
boolean optional Vui lòng xem Map3DElement.defaultLabelsDisabled . |
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 . |
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.
Thuộc tính | |
---|---|
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 ClickEvent
Lớp google.maps.maps3d.ClickEvent
Sự kiện này được tạo từ việc nhấp vào Map3DElement.
Lớp này mở rộng Event
.
Truy cập bằng cách gọi const {ClickEvent} = await google.maps.importLibrary("maps3d")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
position |
Loại:
LatLngAltitude optional Vĩ độ/kinh độ/độ cao nằm bên dưới 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, độ 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í máy ảnh cao hơn. Sự kiện này sẽ được truyền lên qua cây DOM. |
Lớp CenterChangeEvent
Lớp google.maps.maps3d.CenterChangeEvent
Sự kiện này được tạo từ thay đổi về trung tâm giám sát vào 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 {CenterChangeEvent} = await google.maps.importLibrary("maps3d")
. Xem phần Thư viện trong API Maps JavaScript.
Lớp HeadingChangeEvent
Lớp google.maps.maps3d.HeadingChangeEvent
Sự kiện này được tạo từ việc theo dõi thay đổi tiêu đề trên 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 {HeadingChangeEvent} = await google.maps.importLibrary("maps3d")
. Xem phần Thư viện trong API Maps JavaScript.
Lớp RangeChangeEvent
Lớp google.maps.maps3d.RangeChangeEvent
Sự kiện này được tạo từ việc thay đổi phạm vi theo dõi trên 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 {RangeChangeEvent} = await google.maps.importLibrary("maps3d")
. Xem phần Thư viện trong API Maps JavaScript.
Lớp RollChangeEvent
Lớp google.maps.maps3d.RollChangeEvent
Sự kiện này được tạo từ việc theo dõi thay đổi của phiên bản trên 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 {RollChangeEvent} = await google.maps.importLibrary("maps3d")
. Xem phần Thư viện trong API Maps JavaScript.
Lớp TiltChangeEvent
Lớp google.maps.maps3d.TiltChangeEvent
Sự kiện này được tạo từ việc theo dõi sự thay đổi độ nghiêng trên 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 {TiltChangeEvent} = await google.maps.importLibrary("maps3d")
. Xem phần Thư viện trong API Maps JavaScript.
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-opacity="number" outer-width="number" stroke-color="string" stroke-opacity="number" 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.
Hàm dựng | |
---|---|
Polyline3DElement |
Polyline3DElement([options]) Thông số:
|
Thuộc tí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:
|
coordinates |
Loại:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional 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:
|
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:
|
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 đa tuyế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:
|
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:
|
outerOpacity |
Loại:
number optional Độ mờ bên ngoài nằm trong khoảng từ
0.0 đến 1.0 .Thuộc tính HTML:
|
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:
|
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:
|
strokeOpacity |
Loại:
number optional Độ mờ nét vẽ nằm trong khoảng từ
0.0 đến 1.0 .Thuộc tính HTML:
|
strokeWidth |
Loại:
number optional Độ rộng nét vẽ tính bằng pixel.
Thuộc tính HTML:
|
zIndex |
Loại:
number optional zIndex so với các đa giác khác.
Thuộc tính HTML:
|
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Thông số:
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. 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.
Thuộc tính | |
---|---|
altitudeMode optional |
Loại:
AltitudeMode optional Mặc định:
AltitudeMode.ABSOLUTE Vui lòng xem Polyline3DElement.altitudeMode . |
coordinates optional |
Loại:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional Vui lòng xem Polyline3DElement.coordinates . |
drawsOccludedSegments optional |
Loại:
boolean optional Mặc định:
false Vui lòng xem Polyline3DElement.drawsOccludedSegments . |
extruded optional |
Loại:
boolean optional Mặc định:
false Vui lòng xem Polyline3DElement.extruded . |
geodesic optional |
Loại:
boolean optional Mặc định:
false Vui lòng xem Polyline3DElement.geodesic . |
outerColor optional |
Loại:
string optional Vui lòng xem Polyline3DElement.outerColor . |
outerOpacity optional |
Loại:
number optional Vui lòng xem Polyline3DElement.outerOpacity . |
outerWidth optional |
Loại:
number optional Vui lòng xem Polyline3DElement.outerWidth . |
strokeColor optional |
Loại:
string optional Vui lòng xem Polyline3DElement.strokeColor . |
strokeOpacity optional |
Loại:
number optional Vui lòng xem Polyline3DElement.strokeOpacity . |
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" fill-opacity="number" geodesic stroke-color="string" stroke-opacity="number" 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 phần Thư viện trong API Maps JavaScript.
Hàm dựng | |
---|---|
Polygon3DElement |
Polygon3DElement([options]) Thông số:
|
Thuộc tí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:
|
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:
|
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:
|
fillColor |
Loại:
string optional Màu nền. Tất cả màu CSS3 đều được hỗ trợ.
Thuộc tính HTML:
|
fillOpacity |
Loại:
number optional Độ mờ của màu tô nằm trong khoảng từ 0 đến 1.
Thuộc tính HTML:
|
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à geodesic 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:
|
innerCoordinates |
Loại:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional 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 |
Loại:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional 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:
|
strokeOpacity |
Loại:
number optional Độ mờ nét vẽ nằm trong khoảng từ
0.0 đến 1.0 .Thuộc tính HTML:
|
strokeWidth |
Loại:
number optional Độ rộng nét vẽ tính bằng pixel.
Thuộc tính HTML:
|
zIndex |
Loại:
number optional zIndex so với các đa giác khác.
Thuộc tính HTML:
|
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Thông số:
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. 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ể được đặt trên Polygon3DElement.
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.
Hằng số | |
---|---|
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ẽ không thay đổi. |
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 thể hiện các đối tượng so với 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 diễn giải dưới dạng 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à). |