Thông báo: Kiểu bản đồ cơ sở mới sắp ra mắt trên Nền tảng Google Maps. Bản cập nhật này về kiểu bản đồ bao gồm bảng màu mặc định mới, ghim hiện đại và các điểm cải tiến về trải nghiệm và khả năng sử dụng bản đồ. Tất cả kiểu bản đồ sẽ được tự động cập nhật vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn sử dụng sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

Controls

Giao diện FullscreenControlOptions

Giao diện google.maps.FullscreenControlOptions

Các tuỳ chọn để hiển thị thành phần điều khiển toàn màn hình.

Thuộc tính
`position optional`	Loại: `ControlPosition optional` Mặc định: `ControlPosition.INLINE_END_BLOCK_START` Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ.

Giao diện MapTypeControlOptions

Giao diện google.maps.MapTypeControlOptions

Các tuỳ chọn để kết xuất thành phần điều khiển loại bản đồ.

Thuộc tính
`mapTypeIds optional`	Loại: `Array<MapTypeId\|string> optional` Mã nhận dạng của các loại bản đồ sẽ hiển thị trong thành phần điều khiển.
`position optional`	Loại: `ControlPosition optional` Mặc định: `ControlPosition.BLOCK_START_INLINE_START` Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ.
`style optional`	Loại: `MapTypeControlStyle optional` Mã kiểu. Dùng để chọn kiểu điều khiển loại bản đồ sẽ hiển thị.

Hằng số MapTypeControlStyle

Hằng số google.maps.MapTypeControlStyle

Giá trị nhận dạng cho các MapTypesControls phổ biến.

Truy cập bằng cách gọi const {MapTypeControlStyle} = await google.maps.importLibrary("maps"). Xem phần Thư viện trong API Maps JavaScript.

Hằng số
`DEFAULT`	Sử dụng chế độ điều khiển loại bản đồ mặc định. Khi hiển thị, thành phần điều khiển `DEFAULT` sẽ thay đổi tuỳ theo kích thước cửa sổ và các yếu tố khác. Thành phần điều khiển `DEFAULT` có thể thay đổi trong các phiên bản API sau này.
`DROPDOWN_MENU`	Trình đơn thả xuống cho màn hình có kích thước thực tế.
`HORIZONTAL_BAR`	Thanh nút chọn ngang tiêu chuẩn.

Giao diện MotionTrackingControlOptions

Giao diện google.maps.MotionTrackingControlOptions

Các tuỳ chọn để kết xuất thành phần điều khiển theo dõi chuyển động.

Thuộc tính
`position optional`	Loại: `ControlPosition optional` Mặc định: `ControlPosition.INLINE_END_BLOCK_END` Mã vị trí. Thông tin này dùng để chỉ định vị trí của thành phần điều khiển này trên ảnh toàn cảnh.

Giao diện PanControlOptions

Giao diện google.maps.PanControlOptions

Các tuỳ chọn để kết xuất thành phần điều khiển kéo.

Thuộc tính
`position optional`	Loại: `ControlPosition optional` Mặc định: `ControlPosition.INLINE_END_BLOCK_END` Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ.

Giao diện RotateControlOptions

Giao diện google.maps.RotateControlOptions

Các tuỳ chọn để kết xuất thành phần điều khiển xoay.

Thuộc tính
`position optional`	Loại: `ControlPosition optional` Mặc định: `ControlPosition.INLINE_END_BLOCK_END` Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ.

Giao diện ScaleControlOptions

Giao diện google.maps.ScaleControlOptions

Các tuỳ chọn để kết xuất chế độ điều khiển tỷ lệ.

Thuộc tính
`style optional`	Loại: `ScaleControlStyle optional` Mã kiểu. Dùng để chọn kiểu điều khiển tỷ lệ sẽ hiển thị.

Hằng số ScaleControlStyle

Hằng số google.maps.ScaleControlStyle

Giá trị nhận dạng cho mã điều khiển tỷ lệ.

Hằng số
`DEFAULT`	Chế độ điều khiển tỷ lệ tiêu chuẩn.

Giao diện StreetViewControlOptions

Giao diện google.maps.StreetViewControlOptions

Các tuỳ chọn để kết xuất thành phần điều khiển người hình mắc áo trong Chế độ xem đường phố trên bản đồ.

Thuộc tính
`position optional`	Loại: `ControlPosition optional` Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ. Vị trí mặc định được nhúng trong các nút điều khiển điều hướng (thu phóng và xoay). Nếu vị trí này trống hoặc giống với vị trí được chỉ định trong `zoomControlOptions` hoặc `panControlOptions`, thì chế độ điều khiển Chế độ xem đường phố sẽ hiển thị trong các chế độ điều khiển chỉ đường. Nếu không, thông tin này sẽ hiển thị riêng.
`sources optional`	Loại: `Iterable<StreetViewSource> optional` Mặc định: [`StreetViewSource.DEFAULT`] Chỉ định nguồn của ảnh toàn cảnh để tìm kiếm. Ví dụ: bạn có thể đặt giới hạn chỉ tìm kiếm ảnh toàn cảnh chính thức của Google. Việc đặt nhiều nguồn sẽ được đánh giá là giao điểm của các nguồn đó. Lưu ý: nguồn `StreetViewSource.OUTDOOR` hiện không được hỗ trợ.

Thuộc tính

position optional

Loại: ControlPosition optional

Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ. Vị trí mặc định được nhúng trong các nút điều khiển điều hướng (thu phóng và xoay). Nếu vị trí này trống hoặc giống với vị trí được chỉ định trong zoomControlOptions hoặc panControlOptions, thì chế độ điều khiển Chế độ xem đường phố sẽ hiển thị trong các chế độ điều khiển chỉ đường. Nếu không, thông tin này sẽ hiển thị riêng.

sources optional

Loại: Iterable<StreetViewSource> optional

Mặc định: [StreetViewSource.DEFAULT]

Chỉ định nguồn của ảnh toàn cảnh để tìm kiếm. Ví dụ: bạn có thể đặt giới hạn chỉ tìm kiếm ảnh toàn cảnh chính thức của Google. Việc đặt nhiều nguồn sẽ được đánh giá là giao điểm của các nguồn đó. Lưu ý: nguồn StreetViewSource.OUTDOOR hiện không được hỗ trợ.

Giao diện ZoomControlOptions

Giao diện google.maps.ZoomControlOptions

Các tuỳ chọn để kết xuất chế độ điều khiển thu phóng.

Thuộc tính
`position optional`	Loại: `ControlPosition optional` Mặc định: `ControlPosition.INLINE_END_BLOCK_END` Mã vị trí. Dùng để chỉ định vị trí của thành phần điều khiển trên bản đồ.

Hằng số ControlPosition

Hằng số google.maps.ControlPosition

Giá trị nhận dạng dùng để chỉ định vị trí của các chế độ điều khiển trên bản đồ. Các thành phần điều khiển được định vị tương ứng với các thành phần điều khiển khác ở cùng một vị trí bố cục. Các thành phần điều khiển được thêm trước sẽ được đặt gần cạnh bản đồ hơn. Bạn nên sử dụng "giá trị logic" (xem https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values) để có thể tự động hỗ trợ cả ngữ cảnh bố cục từ trái sang phải (LTR) và từ phải sang trái (RTL).

Giá trị logic theo hướng từ trái sang phải:

+----------------+ 
| BSIS BSIC BSIE | 
| ISBS      IEBS | 
|                | 
| ISBC      IEBC | 
|                | 
| ISBE      IEBE | 
| BEIS BEIC BEIE | 
+----------------+

Giá trị logic theo RTL:

+----------------+ 
| BSIE BSIC BSIS | 
| IEBS      ISBS | 
|                | 
| IEBC      ISBC | 
|                | 
| IEBE      ISBE | 
| BEIE BEIC BEIS | 
+----------------+

Giá trị cũ:

+----------------+ 
| TL    TC    TR | 
| LT          RT | 
|                | 
| LC          RC | 
|                | 
| LB          RB | 
| BL    BC    BR | 
+----------------+

Các phần tử trong hàng trên cùng hoặc dưới cùng sẽ chuyển về giữa hàng. Các phần tử trong cột bên trái hoặc bên phải sẽ chảy về giữa cột.

Truy cập bằng cách gọi const {ControlPosition} = await google.maps.importLibrary("core"). Xem phần Thư viện trong API Maps JavaScript.

Hằng số
`BLOCK_END_INLINE_CENTER`	Tương đương với BOTTOM_CENTER trong cả LTR và RTL.
`BLOCK_END_INLINE_END`	Tương đương với BOTTOM_RIGHT theo hướng LTR hoặc BOTTOM_LEFT theo hướng RTL.
`BLOCK_END_INLINE_START`	Tương đương với BOTTOM_LEFT trong LTR hoặc BOTTOM_RIGHT trong RTL.
`BLOCK_START_INLINE_CENTER`	Tương đương với TOP_CENTER trong cả LTR và RTL.
`BLOCK_START_INLINE_END`	Tương đương với TOP_RIGHT trong LTR hoặc TOP_LEFT trong RTL.
`BLOCK_START_INLINE_START`	Tương đương với TOP_LEFT trong LTR hoặc TOP_RIGHT trong RTL.
`BOTTOM_CENTER`	Các phần tử được đặt ở giữa hàng dưới cùng. Thay vào đó, hãy cân nhắc sử dụng BLOCK_END_INLINE_CENTER.
`BOTTOM_LEFT`	Các phần tử được đặt ở dưới cùng bên trái và chảy về giữa. Các phần tử được đặt ở bên phải biểu trưng Google. Thay vào đó, hãy cân nhắc sử dụng BLOCK_END_INLINE_START.
`BOTTOM_RIGHT`	Các phần tử được đặt ở dưới cùng bên phải và di chuyển về giữa. Các phần tử được đặt ở bên trái của thông tin bản quyền. Thay vào đó, hãy cân nhắc sử dụng BLOCK_END_INLINE_END.
`INLINE_END_BLOCK_CENTER`	Tương đương với RIGHT_CENTER trong LTR hoặc LEFT_CENTER trong RTL.
`INLINE_END_BLOCK_END`	Tương đương với RIGHT_BOTTOM trong LTR hoặc LEFT_BOTTOM trong RTL.
`INLINE_END_BLOCK_START`	Tương đương với RIGHT_TOP theo hướng LTR hoặc LEFT_TOP theo hướng RTL.
`INLINE_START_BLOCK_CENTER`	Tương đương với LEFT_CENTER trong LTR hoặc RIGHT_CENTER trong RTL.
`INLINE_START_BLOCK_END`	Tương đương với LEFT_BOTTOM trong LTR hoặc RIGHT_BOTTOM trong RTL.
`INLINE_START_BLOCK_START`	Tương đương với LEFT_TOP trong LTR hoặc RIGHT_TOP trong RTL.
`LEFT_BOTTOM`	Các phần tử được đặt ở bên trái, phía trên các phần tử ở dưới cùng bên trái và di chuyển lên trên. Thay vào đó, hãy cân nhắc sử dụng INLINE_START_BLOCK_END.
`LEFT_CENTER`	Các phần tử được đặt ở chính giữa bên trái. Thay vào đó, hãy cân nhắc sử dụng INLINE_START_BLOCK_CENTER.
`LEFT_TOP`	Các phần tử được đặt ở bên trái, bên dưới các phần tử trên cùng bên trái và chảy xuống dưới. Thay vào đó, hãy cân nhắc sử dụng INLINE_START_BLOCK_START.
`RIGHT_BOTTOM`	Các phần tử được đặt ở bên phải, phía trên các phần tử ở dưới cùng bên phải và di chuyển lên trên. Thay vào đó, hãy cân nhắc sử dụng INLINE_END_BLOCK_END.
`RIGHT_CENTER`	Các phần tử được đặt ở giữa bên phải. Thay vào đó, hãy cân nhắc sử dụng INLINE_END_BLOCK_CENTER.
`RIGHT_TOP`	Các phần tử được đặt ở bên phải, bên dưới các phần tử trên cùng bên phải và chảy xuống dưới. Thay vào đó, hãy cân nhắc sử dụng INLINE_END_BLOCK_START.
`TOP_CENTER`	Các phần tử được đặt ở giữa hàng trên cùng. Thay vào đó, hãy cân nhắc sử dụng BLOCK_START_INLINE_CENTER.
`TOP_LEFT`	Các phần tử được đặt ở trên cùng bên trái và chảy về giữa. Thay vào đó, hãy cân nhắc sử dụng BLOCK_START_INLINE_START.
`TOP_RIGHT`	Các phần tử được đặt ở trên cùng bên phải và chảy về giữa. Thay vào đó, hãy cân nhắc sử dụng BLOCK_START_INLINE_END.