Lớp Map3DElement
Lớp google.maps.maps3d.Map3DElement
Map3DElement là giao diện HTML dành 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 sẽ 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 API JavaScript Maps.
Hàm dựng | |
---|---|
Map3DElement |
Map3DElement([options]) Các thông số:
|
Thuộc tính | |
---|---|
bounds |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Khi đặt, hãy giới hạn vị trí của máy ảnh trong giới hạn vĩ độ/lng được chỉ định. 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ỉ có thể hạn chế vĩ độ hoặc kinh độ. Đối với những ranh giới chỉ có vĩ độ, hãy sử dụng kinh độ tây và kinh độ đông là -180 và 180 tương ứng. Đối với những 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 Độ cao LatLng, nơi độ cao tính bằng mét so với mặt đất. Lưu ý rằng đây không nhất thiết là vị trí đặt camera, vì trường
range ảnh hưởng đến khoảng cách của camera từ trung tâm bản đồ. Nếu bạn không đặt chính sách này, chế độ cài đặt mặc định sẽ là {lat: 0, lng: 0, altitude: 63170000} . 63170000 mét là độ cao tối đa cho 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 , các nhãn bản đồ mặc định sẽ không được hiển thị.Thuộc tính HTML:
|
heading |
Loại:
number optional Hướng la bàn của bản đồ, tính bằng độ, nơi đến hạn ở phía bắc bằng 0. Khi không có độ nghiêng, bất kỳ cuộn nào cũng sẽ được hiểu là tiêu đề.
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 đồ. Một 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 tối đa của tiêu đề (xoay) trên bản đồ. Giá trị hợp lệ nằm trong khoảng từ
0 đến 360 độ. minHeading và maxHeading biểu thị khoảng <= 360 độ mà các cử chỉ tiêu đề sẽ được 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 đề bằng [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 đồ. Một 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 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 <= 360 độ mà các cử chỉ tiêu đề sẽ được 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 đề bằng [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 trung tâm của bản đồ, tính bằng mét.
Thuộc tính HTML:
|
roll |
Loại:
number optional Cuộn máy ảnh xung quanh vectơ xem theo độ. Để giải quyết sự không rõ ràng, khi không có độ nghiêng, bất kỳ cuộn nào cũng sẽ được hiểu là tiêu đề.
Thuộc tính HTML:
|
tilt |
Loại:
number optional Độ nghiêng vectơ xem của máy ảnh theo độ. Vectơ khung hiển thị nhìn trực tiếp xuống trái đất sẽ có độ nghiêng 0 độ. Vectơ chế độ xem chỉ ra xa trái đất sẽ có độ nghiêng
180 độ.Thuộc tính HTML:
|
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Các 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 đã chỉ định được phân phối đến mục tiêu. Hãy xem addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Xoá một 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ể đặ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
.
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 API JavaScript Maps.
Thuộc tính | |
---|---|
isSteady |
Loại:
boolean Cho biết liệu 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) hay chưa. |
Lớp ClickEvent
Lớp google.maps.maps3d.ClickEvent
Sự kiện này được tạo bằng cách 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 {ClickEvent} = await google.maps.importLibrary("maps3d")
. Xem Thư viện trong API JavaScript Maps.
Thuộc tính | |
---|---|
position |
Loại:
LatLngAltitude optional Vĩ độ/kinh độ/độ cao dưới con trỏ khi sự kiện xảy ra. Xin lưu ý rằng ở mức thô hơn, dữ liệu sẽ được trả về ít 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. |
Lớp CenterChangeEvent
Lớp google.maps.maps3d.CenterChangeEvent
Sự kiện này được tạo từ sự thay đổi của trung tâm giám sát vào ngày Map3DElement
.
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 Thư viện trong API JavaScript Maps.
Lớp HeadingChangeEvent
Lớp google.maps.maps3d.HeadingChangeEvent
Sự kiện này được tạo từ việc giám sát sự thay đổi tiêu đề vào Map3DElement
.
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 Thư viện trong API JavaScript Maps.
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 giám sát vào Map3DElement
.
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 Thư viện trong API JavaScript Maps.
Lớp RollChangeEvent
Lớp google.maps.maps3d.RollChangeEvent
Sự kiện này được tạo từ việc giám sát thay đổi cuộn vào Map3DElement
.
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 Thư viện trong API JavaScript Maps.
Lớp TiltChangeEvent
Lớp google.maps.maps3d.TiltChangeEvent
Sự kiện này được tạo từ việc giám sát sự thay đổi độ nghiêng trên Map3DElement
.
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 Thư viện trong API JavaScript Maps.
Lớp Polyline3DElement
Lớp google.maps.maps3d.Polyline3DElement
Hình nhiều đường 3D là lớp phủ tuyến tính của các đoạn 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-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 sẽ 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 API JavaScript Maps.
Hàm dựng | |
---|---|
Polyline3DElement |
Polyline3DElement([options]) Các 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 Chuỗi toạ độ theo thứ tự của Hình nhiều đường. Độ cao bị bỏ qua ở 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ác phần của hình nhiều đường có thể bị che khuất có được vẽ hay không. Hình nhiều đường có thể bị che khuất bởi hình học của bản đồ (ví dụ: toà nhà).
Thuộc tính HTML:
|
extruded |
Loại:
boolean optional Mặc định:
false Chỉ định xem có nối hình nhiều đường với mặt đất hay không. Để đẩy hình nhiều đường,
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 hình nhiều đường được hiểu 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 sẽ hiển thị 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ả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu được đặt tên mở rộng.
Thuộc tính HTML:
|
outerOpacity |
Loại:
number optional Độ mờ bên ngoài 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à một 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ả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu được đặt tên mở rộng.
Thuộc tính HTML:
|
strokeOpacity |
Loại:
number optional Độ mờ của nét vẽ từ
0.0 đến 1.0 .Thuộc tính HTML:
|
strokeWidth |
Loại:
number optional Độ rộng của nét vẽ tính bằng pixel.
Thuộc tính HTML:
|
zIndex |
Loại:
number optional zIndex so với các poly khác.
Thuộc tính HTML:
|
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Các 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 đã chỉ định được phân phối đến mục tiêu. Hãy xem addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Xoá một 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ể đặ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 (như một hình nhiều đường 3D) xác định một chuỗi các toạ độ được kết nối theo một chuỗi có thứ tự. Ngoài ra, đa giác tạo thành một vòng lặp khép kín và xác định một vùng được tô màu nền.
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 sẽ 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 API JavaScript Maps.
Hàm dựng | |
---|---|
Polygon3DElement |
Polygon3DElement([options]) Các 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. Đa giác có thể bị hình học bản đồ che khuất (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. Để đùn 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ả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu được đặt tên mở rộng.
Thuộc tính HTML:
|
fillOpacity |
Loại:
number optional Độ mờ màu nền từ 0,0 đến 1,0.
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 thể hiện 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 sẽ hiển thị dưới dạng các đườ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 Chuỗi toạ độ có thứ tự chỉ định một vòng lặp khép kín. Không giống hình nhiều đường, đa giác có thể bao gồm một hoặc nhiều đường dẫn, tạo ra nhiều vết cắt bên trong đa giác. |
outerCoordinates |
Loại:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional Chuỗi toạ độ có thứ tự chỉ định một vòng lặp khép kín. Độ cao bị bỏ qua ở 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ả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu được đặt tên mở rộng.
Thuộc tính HTML:
|
strokeOpacity |
Loại:
number optional Độ mờ của nét vẽ từ
0.0 đến 1.0 .Thuộc tính HTML:
|
strokeWidth |
Loại:
number optional Độ rộng của nét vẽ tính bằng pixel.
Thuộc tính HTML:
|
zIndex |
Loại:
number optional zIndex so với các poly khác.
Thuộc tính HTML:
|
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Các 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 đã chỉ định được phân phối đến mục tiêu. Hãy xem addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Xoá một 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ể đặt trên một 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 Thư viện trong API JavaScript Maps.
Hằng số | |
---|---|
ABSOLUTE |
Cho phép thể hiện các vật thể tương ứng với mực nước biển trung bình trung bình. Điều đó cũng có nghĩa là nếu mức độ chi tiết về bản đồ địa hình thay đổi bên dưới vật thể, thì vị trí tuyệt đối của địa hình đó sẽ vẫn giữ nguyên. |
CLAMP_TO_GROUND |
Cho phép chụp các vật thể đượ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à gì. Nếu vật thể được đặt trên một vùng nước chính, thì vật thể sẽ được đặt ở mực nước biển. |
RELATIVE_TO_GROUND |
Cho phép thể hiện các vật thể tương ứng với mặt đất. Nếu mức độ địa hình của chi tiết thay đổi, vị trí của vật thể 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 trên mực nước biển. |
RELATIVE_TO_MESH |
Cho phép thể hiện các đối tượng tương ứng với độ cao 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 toà nhà (nếu có) hoặc mặt đất (nếu không có toà nhà nào). |