Maps

Lớp MapElement

google.maps.MapElement class
extends HTMLElement
implements MapElementOptions
library "maps"

MapElement là một lớp con HTMLElement để kết xuất bản đồ. Sau khi tải thư viện maps, bạn có thể tạo bản đồ bằng HTML. Ví dụ: 

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
Trong nội bộ, lớp này sử dụng Map, có thể truy cập được bằng thuộc tính MapElement.innerMap.

    
<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>
 
const {MapElement} = await google.maps.importLibrary("maps");
MapElement
MapElement([options])
Tham số:
center
attr: center
Loại: LatLng|LatLngLiteral optional
Vĩ độ/kinh độ trung tâm của bản đồ.
Thuộc tính HTML: center="lat,lng"
headingInteractionDisabled
attr: heading-interaction-disabled
Loại: boolean optional
Mặc định: false
Liệu bản đồ có cho phép người dùng điều khiển hướng camera (xoay) hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
Thuộc tính HTML: heading-interaction-disabled
innerMap
Loại: Map
Tham chiếu đến Map mà MapElement sử dụng nội bộ.
internalUsageAttributionIds
attr: internal-usage-attribution-ids
Loại: Iterable<string> optional
Mặc định: null
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 thông tin ghi nhận tác giả sử dụng, bạn có thể xoá thuộc tính này hoặc thay thế giá trị bằng một chuỗi trống. 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"
mapId
attr: map-id
Loại: string optional
Mã bản đồ của bản đồ. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo thực thể cho bản đồ. Bạn có thể dùng Map.DEMO_MAP_ID để thử các tính năng yêu cầu mã bản đồ nhưng không yêu cầu bật đám mây.
Thuộc tính HTML: map-id="string"
renderingType
attr: rendering-type
Loại: RenderingType optional
Mặc định: RenderingType.VECTOR
Liệu bản đồ có phải là bản đồ đường quét hay bản đồ vectơ hay không. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo thực thể cho bản đồ. Nếu bạn không đặt, thì cấu hình đám mây cho mã bản đồ sẽ xác định loại kết xuất (nếu có). Xin lưu ý rằng bản đồ vectơ có thể không hoạt động trên một số Thiết bị và trình duyệt, và bản đồ sẽ quay lại bản đồ raster nếu cần.
Thuộc tính HTML: rendering-type="value-name"
tiltInteractionDisabled
attr: tilt-interaction-disabled
Loại: boolean optional
Mặc định: false
Liệu bản đồ có cho phép người dùng điều khiển độ nghiêng của camera hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
Thuộc tính HTML: tilt-interaction-disabled
zoom
attr: zoom
Loại: number optional
Mức thu phóng của bản đồ. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ. Giá trị thu phóng càng lớn thì độ phân giải càng cao.
Thuộc tính HTML: zoom="number"
control-block-end-inline-center
Đặt phần tử có khe vào vị trí ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Đặt phần tử có khe vào vị trí ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Đặt phần tử có khe vào vị trí ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Đặt phần tử có khe vào vị trí ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Đặt phần tử có khe vào vị trí ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Đặt phần tử có khe vào vị trí ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Đặt phần tử có khe vào vị trí ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Đặt phần tử có khe vào vị trí ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Đặt phần tử có khe vào vị trí ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Đặt phần tử có khe vào vị trí ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Đặt phần tử có khe vào vị trí ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Đặt phần tử có khe vào vị trí ControlPosition.INLINE_START_BLOCK_START.
default
Bạn có thể tạo các thành phần có thể sử dụng lại xung quanh Thành phần web của Maps JavaScript, chẳng hạn như AdvancedMarkerElement, bằng cách sử dụng các phần tử tuỳ chỉnh. Theo mặc định, mọi phần tử tuỳ chỉnh được thêm trực tiếp vào MapElement sẽ được đưa vào và hiển thị trong MapPanes.overlayMouseTarget. Tuy nhiên, các Thành phần web của Maps JavaScript API có thể được đưa vào lại các vùng nội bộ của MapElement.
Được kế thừa: addEventListener, removeEventListener
gmp-zoomchange
function(event)
Đối số:
Sự kiện này được kích hoạt khi thuộc tính thu phóng bản đồ thay đổi.

Giao diện MapElementOptions

google.maps.MapElementOptions giao diện

Đối tượng MapElementOptions dùng để xác định các thuộc tính có thể đặt trên MapElement.
center
không bắt buộc
Loại: LatLng|LatLngLiteral optional
Vui lòng xem MapElement.center.
headingInteractionDisabled
không bắt buộc
Loại: boolean optional
Vui lòng xem MapElement.headingInteractionDisabled.
internalUsageAttributionIds
không bắt buộc
Loại: Iterable<string> optional
Vui lòng xem MapElement.internalUsageAttributionIds.
mapId
không bắt buộc
Loại: string optional
Vui lòng xem MapElement.mapId.
renderingType
không bắt buộc
Loại: RenderingType optional
Vui lòng xem MapElement.renderingType.
tiltInteractionDisabled
không bắt buộc
Loại: boolean optional
Vui lòng xem MapElement.tiltInteractionDisabled.
zoom
không bắt buộc
Loại: number optional
Vui lòng xem MapElement.zoom.

Lớp ZoomChangeEvent

google.maps.ZoomChangeEvent class
extends Event
library "maps"

Sự kiện này được tạo từ việc theo dõi thay đổi về mức thu phóng.

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

Lớp Map

google.maps.Map class
extends MVCObject
library "maps" 

const {Map} = await google.maps.importLibrary("maps");
Map
Map(mapDiv[, opts])
Tham số:
  • mapDiv: HTMLElement Bản đồ sẽ hiển thị để lấp đầy phần tử này.
  • opts: MapOptions optional lựa chọn
Tạo một bản đồ mới bên trong vùng chứa HTML đã cho, thường là một phần tử DIV.
DEMO_MAP_ID Mã bản đồ có thể dùng cho các mã mẫu yêu cầu mã bản đồ. Mã bản đồ này không dùng cho các ứng dụng chính thức và không dùng được cho các tính năng yêu cầu cấu hình đám mây (chẳng hạn như Định kiểu trên đám mây).
controls
Các chế độ điều khiển khác để đính kèm vào bản đồ. Để thêm một thành phần điều khiển vào bản đồ, hãy thêm <div> của thành phần điều khiển đó vào MVCArray tương ứng với ControlPosition nơi thành phần điều khiển đó sẽ được hiển thị.
data
Loại: Data
Một thực thể của Data, được liên kết với bản đồ. Thêm các đối tượng vào đối tượng Data này để hiển thị chúng một cách thuận tiện trên bản đồ này.
mapTypes
Sổ đăng ký các thực thể MapType theo mã nhận dạng chuỗi.
overlayMapTypes
Loại: MVCArray<MapType optional>
Các loại bản đồ khác để phủ lên. Các loại bản đồ lớp phủ sẽ hiển thị trên bản đồ cơ sở mà chúng được đính kèm, theo thứ tự xuất hiện trong mảng overlayMapTypes (các lớp phủ có giá trị chỉ mục cao hơn sẽ hiển thị trước các lớp phủ có giá trị chỉ mục thấp hơn).
fitBounds
fitBounds(bounds[, padding])
Tham số:
  • bounds: LatLngBounds|LatLngBoundsLiteral Ranh giới cần hiển thị.
  • padding: number|Padding optional Khoảng đệm tính bằng pixel. Các ranh giới sẽ được điều chỉnh cho vừa với phần bản đồ còn lại sau khi loại bỏ khoảng đệm. Giá trị số sẽ mang lại khoảng đệm giống nhau ở cả 4 cạnh. Cung cấp 0 tại đây để đặt fitBounds không thay đổi trên kết quả của getBounds.
Giá trị trả về: Không có
Đặt khung nhìn để chứa các giới hạn đã cho.
Lưu ý: Khi bản đồ được đặt thành display: none, hàm fitBounds sẽ đọc kích thước của bản đồ là 0x0 và do đó không làm gì cả. Để thay đổi khung nhìn trong khi bản đồ bị ẩn, hãy đặt bản đồ thành visibility: hidden, nhờ đó đảm bảo div bản đồ có kích thước thực tế. Đối với bản đồ vectơ, phương thức này đặt độ nghiêng và hướng của bản đồ về giá trị mặc định là 0. Việc gọi phương thức này có thể tạo ra ảnh động mượt mà khi bản đồ di chuyển và thu phóng để vừa với ranh giới. Việc phương thức này có tạo ảnh động hay không phụ thuộc vào một heuristic nội bộ.
getBounds
getBounds()
Tham số: Không có
Giá trị trả về: LatLngBounds|undefined Ranh giới vĩ độ/kinh độ của khung nhìn hiện tại.
Trả về ranh giới vĩ độ/kinh độ của khung nhìn hiện tại. Nếu có nhiều bản sao của thế giới hiển thị, thì phạm vi ranh giới theo kinh độ sẽ nằm trong khoảng từ -180 đến 180 độ. Nếu bản đồ chưa được khởi chạy hoặc tâm và mức thu phóng chưa được đặt, thì kết quả sẽ là undefined. Đối với bản đồ vectơ có độ nghiêng hoặc hướng khác 0, ranh giới vĩ độ/kinh độ được trả về đại diện cho hộp giới hạn nhỏ nhất bao gồm vùng hiển thị của khung nhìn trên bản đồ. Xem MapCanvasProjection.getVisibleRegion để biết cách lấy chính xác vùng hiển thị của khung nhìn bản đồ.
getCenter
getCenter()
Tham số: Không có
Giá trị trả về: LatLng|undefined
Trả về vị trí hiển thị ở giữa bản đồ. Xin lưu ý rằng đối tượng LatLng này không được gói. Vui lòng tham khảo LatLng để biết thêm thông tin. Nếu tâm hoặc ranh giới chưa được đặt, thì kết quả sẽ là undefined.
getClickableIcons
getClickableIcons()
Tham số: Không có
Giá trị trả về: boolean|undefined
Trả về khả năng nhấp của các biểu tượng trên bản đồ. Biểu tượng bản đồ đại diện cho một địa điểm yêu thích, còn được gọi là POI. Nếu giá trị được trả về là true, thì bạn có thể nhấp vào các biểu tượng trên bản đồ.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Tham số:
  • datasetId: string
Giá trị trả về: FeatureLayer
Trả về FeatureLayer cho datasetId được chỉ định. Bạn phải định cấu hình mã tập dữ liệu trong Google Cloud Console. Nếu mã tập dữ liệu không được liên kết với kiểu bản đồ của bản đồ hoặc nếu tính năng Định kiểu dựa trên dữ liệu không hoạt động (không có mã bản đồ, không có ô vectơ, không có lớp đối tượng Định kiểu dựa trên dữ liệu hoặc Tập dữ liệu được định cấu hình trong Kiểu bản đồ), thì hệ thống sẽ ghi lại lỗi và FeatureLayer.isAvailable thu được sẽ là false.
getDiv
getDiv()
Tham số: Không có
Giá trị trả về: HTMLElement mapDiv của bản đồ.
getFeatureLayer
getFeatureLayer(featureType)
Tham số:
Giá trị trả về: FeatureLayer
Trả về FeatureLayer của FeatureType cụ thể. Bạn phải bật FeatureLayer trong Google Cloud Console. Nếu FeatureLayer của FeatureType được chỉ định không tồn tại trên bản đồ này hoặc nếu tính năng Định kiểu dựa trên dữ liệu không hoạt động (không có mã bản đồ, không có ô vectơ và không bật FeatureLayer trong kiểu bản đồ), thì thao tác này sẽ ghi lại lỗi và FeatureLayer.isAvailable thu được sẽ là false.
getHeading
getHeading()
Tham số: Không có
Giá trị trả về: number|undefined
Trả về hướng la bàn của bản đồ. Giá trị hướng được đo bằng độ (theo chiều kim đồng hồ) từ hướng chính Bắc. Nếu bản đồ chưa được khởi chạy thì kết quả sẽ là undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Tham số: Không có
Giá trị trả về: boolean|null
Trả về thông tin cho biết liệu các hoạt động tương tác với tiêu đề có được bật hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Tham số: Không có
Giá trị trả về: Iterable<string>|null
Trả về danh sách mã phân bổ mức sử dụng, 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.
getMapCapabilities
getMapCapabilities()
Tham số: Không có
Giá trị trả về: MapCapabilities
Thông báo cho phương thức gọi về các chức năng hiện có của bản đồ dựa trên mã bản đồ được cung cấp.
getMapTypeId
getMapTypeId()
Tham số: Không có
Giá trị trả về: MapTypeId|string|undefined
getProjection
getProjection()
Tham số: Không có
Giá trị trả về: Projection|undefined
Trả về Projection hiện tại. Nếu bản đồ chưa được khởi chạy thì kết quả sẽ là undefined. Hãy theo dõi sự kiện projection_changed và kiểm tra giá trị của sự kiện này để đảm bảo giá trị không phải là undefined.
getRenderingType
getRenderingType()
Tham số: Không có
Giá trị trả về: RenderingType
Trả về RenderingType hiện tại của bản đồ.
getStreetView
getStreetView()
Tham số: Không có
Giá trị trả về: StreetViewPanorama Toàn cảnh liên kết với bản đồ.
Trả về StreetViewPanorama mặc định liên kết với bản đồ, có thể là ảnh toàn cảnh mặc định được nhúng trong bản đồ hoặc ảnh toàn cảnh được đặt bằng setStreetView(). Những thay đổi đối với streetViewControl của bản đồ sẽ được phản ánh trong màn hình của ảnh toàn cảnh liên kết đó.
getTilt
getTilt()
Tham số: Không có
Giá trị trả về: number|undefined
Trả về góc tới hiện tại của bản đồ, tính bằng độ từ mặt phẳng khung nhìn đến mặt phẳng bản đồ. Đối với bản đồ raster, kết quả sẽ là 0 cho hình ảnh được chụp trực tiếp từ trên cao hoặc 45 cho hình ảnh 45°. Phương thức này không trả về giá trị do setTilt đặt. Hãy xem setTilt để biết thông tin chi tiết.
getTiltInteractionEnabled
getTiltInteractionEnabled()
Tham số: Không có
Giá trị trả về: boolean|null
Trả về việc có bật các tương tác nghiêng hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
getZoom
getZoom()
Tham số: Không có
Giá trị trả về: number|undefined
Trả về mức thu phóng của bản đồ. Nếu bạn chưa đặt mức thu phóng, thì kết quả sẽ là undefined.
moveCamera
moveCamera(cameraOptions)
Tham số:
Giá trị trả về: Không có
Đặt ngay camera của bản đồ thành các tuỳ chọn camera mục tiêu mà không cần ảnh động.
panBy
panBy(x, y)
Tham số:
  • x: number Số pixel để di chuyển bản đồ theo hướng x.
  • y: number Số pixel để di chuyển bản đồ theo hướng y.
Giá trị trả về: Không có
Thay đổi tâm của bản đồ theo khoảng cách đã cho tính bằng pixel. Nếu khoảng cách nhỏ hơn cả chiều rộng và chiều cao của bản đồ, thì quá trình chuyển đổi sẽ diễn ra suôn sẻ. Lưu ý rằng hệ toạ độ bản đồ tăng từ tây sang đông (đối với giá trị x) và từ bắc xuống nam (đối với giá trị y).
panTo
panTo(latLng)
Tham số:
Giá trị trả về: Không có
Thay đổi tâm của bản đồ thành LatLng đã cho. Nếu thay đổi nhỏ hơn cả chiều rộng và chiều cao của bản đồ, thì quá trình chuyển đổi sẽ được tạo ảnh động mượt mà.
panToBounds
panToBounds(latLngBounds[, padding])
Tham số:
  • latLngBounds: LatLngBounds|LatLngBoundsLiteral Ranh giới để kéo bản đồ đến.
  • padding: number|Padding optional Khoảng đệm tính bằng pixel. Giá trị số sẽ mang lại khoảng đệm giống nhau ở cả 4 cạnh. Giá trị mặc định là "0".
Giá trị trả về: Không có
Xoay bản đồ theo mức tối thiểu cần thiết để chứa LatLngBounds đã cho. Không có gì đảm bảo ranh giới sẽ nằm ở đâu trên bản đồ, ngoại trừ việc bản đồ sẽ được kéo để hiển thị càng nhiều ranh giới càng tốt bên trong {currentMapSizeInPx} - {padding}. Đối với cả bản đồ đường quét và bản đồ vectơ, mức thu phóng, độ nghiêng và hướng của bản đồ sẽ không thay đổi.
setCenter
setCenter(latlng)
Tham số:
Giá trị trả về: Không có
setClickableIcons
setClickableIcons(value)
Tham số:
  • value: boolean
Giá trị trả về: Không có
Kiểm soát việc có thể nhấp vào biểu tượng bản đồ hay không. Biểu tượng bản đồ đại diện cho một địa điểm yêu thích, còn được gọi là POI. Để tắt khả năng nhấp vào biểu tượng bản đồ, hãy truyền giá trị false vào phương thức này.
setHeading
setHeading(heading)
Tham số:
  • heading: number
Giá trị trả về: Không có
Đặt hướng la bàn cho bản đồ, được đo bằng độ từ hướng Bắc chính. Đối với bản đồ raster, phương thức này chỉ áp dụng cho hình ảnh từ trên không.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Tham số:
  • headingInteractionEnabled: boolean
Giá trị trả về: Không có
Đặt xem có bật tính năng tương tác với tiêu đề hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
setMapTypeId
setMapTypeId(mapTypeId)
Tham số:
Giá trị trả về: Không có
setOptions
setOptions(options)
Tham số:
Giá trị trả về: Không có
setRenderingType
setRenderingType(renderingType)
Tham số:
Giá trị trả về: Không có
Đặt RenderingType hiện tại của bản đồ.
setStreetView
setStreetView(panorama)
Tham số:
  • panorama: StreetViewPanorama optional Ảnh toàn cảnh để liên kết với bản đồ.
Giá trị trả về: Không có
Liên kết StreetViewPanorama với bản đồ. Ảnh toàn cảnh này ghi đè StreetViewPanorama mặc định, cho phép bản đồ liên kết với một ảnh toàn cảnh bên ngoài bản đồ. Việc đặt ảnh toàn cảnh thành null sẽ liên kết ảnh toàn cảnh được nhúng mặc định trở lại bản đồ.
setTilt
setTilt(tilt)
Tham số:
  • tilt: number
Giá trị trả về: Không có
Đối với bản đồ vectơ, hãy đặt góc tới của bản đồ. Các giá trị được phép sẽ bị hạn chế tuỳ thuộc vào mức thu phóng của bản đồ.

Đối với bản đồ raster, thuộc tính này kiểm soát hành vi chuyển đổi tự động cho góc tới của bản đồ. Các giá trị duy nhất được cho phép là 0 và 45. setTilt(0) khiến bản đồ luôn sử dụng chế độ xem từ trên cao 0° bất kể mức thu phóng và khung nhìn. setTilt(45) khiến góc nghiêng tự động chuyển sang 45 bất cứ khi nào có hình ảnh 45° cho mức thu phóng và khung nhìn hiện tại, đồng thời chuyển về 0 bất cứ khi nào không có hình ảnh 45° (đây là hành vi mặc định). Hình ảnh 45° chỉ có sẵn cho các loại bản đồ satellite và hybrid, ở một số vị trí và ở một số mức thu phóng. Lưu ý: getTilt trả về góc nghiêng hiện tại, chứ không phải giá trị do setTilt đặt. Vì getTilt và setTilt tham chiếu đến những nội dung khác nhau, nên đừng bind() thuộc tính tilt; làm như vậy có thể mang lại hiệu ứng không thể đoán trước.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Tham số:
  • tiltInteractionEnabled: boolean
Giá trị trả về: Không có
Đặt xem có bật các hoạt động tương tác nghiêng hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
setZoom
setZoom(zoom)
Tham số:
  • zoom: number Giá trị thu phóng càng lớn thì độ phân giải càng cao.
Giá trị trả về: Không có
Đặt mức thu phóng của bản đồ.
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi ranh giới khung nhìn thay đổi.
center_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính tâm bản đồ thay đổi.
click
function(event)
Đối số:
Sự kiện này được kích hoạt khi người dùng nhấp vào bản đồ. Hệ thống sẽ trả về một MapMouseEvent có các thuộc tính cho vị trí được nhấp vào, trừ phi người dùng nhấp vào biểu tượng địa điểm. Trong trường hợp đó, hệ thống sẽ trả về một IconMouseEvent có mã địa điểm. IconMouseEvent và MapMouseEvent giống hệt nhau, ngoại trừ việc IconMouseEvent có trường mã địa điểm. Sự kiện luôn có thể được coi là MapMouseEvent khi mã địa điểm không quan trọng. Sự kiện nhấp chuột sẽ không được kích hoạt nếu người dùng nhấp vào điểm đánh dấu hoặc cửa sổ thông tin.
contextmenu
function(event)
Đối số:
Sự kiện này được kích hoạt khi sự kiện contextmenu DOM được kích hoạt trên vùng chứa bản đồ.
dblclick
function(event)
Đối số:
Sự kiện này được kích hoạt khi người dùng nhấp đúp vào bản đồ. Lưu ý rằng sự kiện nhấp chuột đôi khi sẽ kích hoạt một lần và đôi khi là hai lần, ngay trước sự kiện này.
drag
function()
Đối số: Không có
Sự kiện này được kích hoạt liên tục trong khi người dùng kéo bản đồ.
dragend
function()
Đối số: Không có
Sự kiện này được kích hoạt khi người dùng ngừng kéo bản đồ. Lưu ý: dragend KHÔNG được kích hoạt khi người dùng ngừng kéo bản đồ bằng bàn phím. Vui lòng sử dụng sự kiện Map.idle để xác định thời điểm người dùng ngừng kéo HOẶC di chuyển bản đồ.
dragstart
function()
Đối số: Không có
Sự kiện này được kích hoạt khi người dùng bắt đầu kéo bản đồ.
heading_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính hướng bản đồ thay đổi.
idle
function()
Đối số: Không có
Sự kiện này được kích hoạt khi bản đồ chuyển sang trạng thái rảnh sau khi di chuyển hoặc thu phóng.
isfractionalzoomenabled_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính isFractionalZoomEnabled thay đổi.
mapcapabilities_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi các chức năng của bản đồ thay đổi.
maptypeid_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính mapTypeId thay đổi.
mousemove
function(event)
Đối số:
Sự kiện này được kích hoạt bất cứ khi nào chuột của người dùng di chuyển qua vùng chứa bản đồ.
mouseout
function(event)
Đối số:
Sự kiện này được kích hoạt khi chuột của người dùng rời khỏi vùng chứa bản đồ.
mouseover
function(event)
Đối số:
Sự kiện này được kích hoạt khi chuột của người dùng di chuyển vào vùng chứa bản đồ.
projection_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi phép chiếu thay đổi.
renderingtype_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi renderingType thay đổi.
tilesloaded
function()
Đối số: Không có
Sự kiện này được kích hoạt khi các ô hiển thị đã tải xong.
tilt_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính độ nghiêng của bản đồ thay đổi.
zoom_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính thu phóng bản đồ thay đổi.
rightclick
function(event)
Đối số:
Sự kiện này được kích hoạt khi người dùng nhấp chuột phải vào bản đồ.

Giao diện MapOptions

google.maps.MapOptions giao diện

Đối tượng MapOptions dùng để xác định các thuộc tính có thể đặt trên Bản đồ.
backgroundColor
không bắt buộc
Loại: string optional
Màu được dùng cho nền của div Bản đồ. Màu này sẽ xuất hiện khi các ô chưa tải xong khi người dùng kéo bản đồ. Bạn chỉ có thể đặt tuỳ chọn này khi khởi chạy bản đồ.
cameraControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ điều khiển Camera.
cameraControlOptions
không bắt buộc
Loại: CameraControlOptions optional
Các lựa chọn hiển thị cho nút Điều khiển camera.
center
không bắt buộc
Loại: LatLng|LatLngLiteral optional
Tâm ban đầu của bản đồ.
clickableIcons
không bắt buộc
Loại: boolean optional
Mặc định: true
Khi false, bạn không thể nhấp vào biểu tượng bản đồ. Biểu tượng bản đồ đại diện cho một địa điểm yêu thích, còn được gọi là POI.
colorScheme
không bắt buộc
Loại: ColorScheme|string optional
Mặc định: ColorScheme.LIGHT
Bảng phối màu ban đầu của Bản đồ. Bạn chỉ có thể đặt tuỳ chọn này khi khởi chạy bản đồ.
controlSize
không bắt buộc
Loại: number optional
Kích thước (tính bằng pixel) của các thành phần điều khiển xuất hiện trên bản đồ. Bạn phải cung cấp trực tiếp giá trị này khi tạo Bản đồ, việc cập nhật giá trị này sau đó có thể đưa các chế độ điều khiển vào trạng thái undefined. Chỉ chi phối các chế độ điều khiển do chính API Maps tạo ra. Không điều chỉnh tỷ lệ các chế độ điều khiển tuỳ chỉnh do nhà phát triển tạo.
disableDefaultUI
không bắt buộc
Loại: boolean optional
Bật/tắt tất cả các nút giao diện người dùng mặc định. Có thể bị ghi đè riêng lẻ. Không tắt các chế độ điều khiển bằng bàn phím (được điều khiển riêng bằng tuỳ chọn MapOptions.keyboardShortcuts). Không tắt các chế độ điều khiển bằng cử chỉ (được điều khiển riêng bằng tuỳ chọn MapOptions.gestureHandling).
disableDoubleClickZoom
không bắt buộc
Loại: boolean optional
Bật/tắt tính năng thu phóng và căn giữa khi nhấp đúp. Bật theo mặc định.

Lưu ý: Bạn không nên sử dụng thuộc tính này. Để tắt tính năng thu phóng khi nhấp đúp, bạn có thể sử dụng thuộc tính gestureHandling và đặt thuộc tính này thành "none".
draggable
không bắt buộc
Loại: boolean optional
Nếu false, thì người dùng không thể kéo và thu phóng bản đồ bằng chuột và cử chỉ chạm. Tính năng kéo được bật theo mặc định.
draggableCursor
không bắt buộc
Loại: string optional
Tên hoặc URL của con trỏ sẽ hiển thị khi di chuột qua một bản đồ có thể kéo. Thuộc tính này sử dụng thuộc tính css cursor để thay đổi biểu tượng. Giống như thuộc tính css, bạn phải chỉ định ít nhất một con trỏ dự phòng không phải là URL. Ví dụ: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor
không bắt buộc
Loại: string optional
Tên hoặc URL của con trỏ sẽ hiển thị khi bản đồ đang được kéo. Thuộc tính này sử dụng thuộc tính css cursor để thay đổi biểu tượng. Giống như thuộc tính css, bạn phải chỉ định ít nhất một con trỏ dự phòng không phải là URL. Ví dụ: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ điều khiển Toàn màn hình.
fullscreenControlOptions
không bắt buộc
Loại: FullscreenControlOptions optional
Các lựa chọn hiển thị cho chế độ điều khiển Toàn màn hình.
gestureHandling
không bắt buộc
Loại: string optional
Chế độ cài đặt này kiểm soát cách API xử lý các cử chỉ trên bản đồ. Các giá trị được cho phép:
  • "cooperative": Sự kiện cuộn và cử chỉ chạm bằng một ngón tay sẽ cuộn trang, chứ không thu phóng hoặc kéo bản đồ. Cử chỉ chạm bằng hai ngón tay để kéo và thu phóng bản đồ. Sự kiện cuộn khi nhấn phím Ctrl hoặc phím ⌘ sẽ thu phóng bản đồ.
    Ở chế độ này, bản đồ phối hợp với trang.
  • "greedy": Tất cả cử chỉ chạm và sự kiện cuộn đều di chuyển hoặc thu phóng bản đồ.
  • "none": Người dùng không thể kéo hoặc thu phóng bản đồ bằng cử chỉ của người dùng.
  • "auto": (mặc định) Thao tác xử lý cử chỉ là hợp tác hoặc tham lam, tuỳ thuộc vào việc trang có thể cuộn được hay nằm trong iframe.
heading
không bắt buộc
Loại: number optional
Hướng của hình ảnh từ trên không, tính bằng độ theo chiều kim đồng hồ từ hướng Bắc. Hướng được điều chỉnh theo góc gần nhất có hình ảnh.
headingInteractionEnabled
không bắt buộc
Loại: boolean optional
Mặc định: false
Liệu bản đồ có cho phép người dùng điều khiển hướng camera (xoay) hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
internalUsageAttributionIds
không bắt buộc
Loại: Iterable<string> optional
Mặc định: null
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 thông tin ghi nhận tác giả sử dụng, bạn có thể xoá thuộc tính này hoặc thay thế giá trị bằng một chuỗi trống. 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.
isFractionalZoomEnabled
không bắt buộc
Loại: boolean optional
Mặc định: true cho bản đồ vectơ và false cho bản đồ đường quét
Liệu bản đồ có cho phép mức thu phóng phân số hay không. Hãy nghe isfractionalzoomenabled_changed để biết khi nào chế độ mặc định được đặt.
keyboardShortcuts
không bắt buộc
Loại: boolean optional
Nếu false, thì ngăn không cho bàn phím điều khiển bản đồ. Phím tắt được bật theo mặc định.
mapId
không bắt buộc
Loại: string optional
Mã bản đồ của bản đồ. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo thực thể cho bản đồ. Bạn có thể dùng Map.DEMO_MAP_ID để thử các tính năng yêu cầu mã bản đồ nhưng không yêu cầu bật đám mây.
mapTypeControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt ban đầu của chế độ điều khiển Loại bản đồ.
mapTypeControlOptions
không bắt buộc
Loại: MapTypeControlOptions optional
Các tuỳ chọn hiển thị ban đầu cho chế độ điều khiển Loại bản đồ.
mapTypeId
không bắt buộc
Loại: MapTypeId|string optional
mapTypeId ban đầu của Bản đồ. Giá trị mặc định là ROADMAP.
maxZoom
không bắt buộc
Loại: number optional
Mức thu phóng tối đa sẽ hiển thị trên bản đồ. Nếu bạn bỏ qua hoặc đặt thành null, thì mức thu phóng tối đa của loại bản đồ hiện tại sẽ được sử dụng. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ.
minZoom
không bắt buộc
Loại: number optional
Mức thu phóng tối thiểu sẽ hiển thị trên bản đồ. Nếu bạn bỏ qua hoặc đặt thành null, thì mức thu phóng tối thiểu của loại bản đồ hiện tại sẽ được sử dụng. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ.
noClear
không bắt buộc
Loại: boolean optional
Nếu true, đừng xoá nội dung của div Bản đồ.
panControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ điều khiển Di chuyển.

panControlOptions
không bắt buộc
Loại: PanControlOptions optional
Các lựa chọn hiển thị cho nút điều khiển Di chuyển.

renderingType
không bắt buộc
Loại: RenderingType optional
Mặc định: RenderingType.RASTER
Liệu bản đồ có phải là bản đồ đường quét hay bản đồ vectơ hay không. Bạn không thể đặt hoặc thay đổi tham số này sau khi tạo thực thể cho bản đồ. Nếu bạn không đặt, thì cấu hình đám mây cho mã bản đồ sẽ xác định loại kết xuất (nếu có). Xin lưu ý rằng bản đồ vectơ có thể không hoạt động trên một số Thiết bị và trình duyệt, và bản đồ sẽ quay lại bản đồ raster nếu cần.
restriction
không bắt buộc
Loại: MapRestriction optional
Xác định ranh giới hạn chế khu vực bản đồ mà người dùng có thể truy cập. Khi bạn đặt giới hạn, người dùng chỉ có thể kéo và thu phóng trong khi chế độ xem của máy ảnh vẫn nằm trong giới hạn của ranh giới.
rotateControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ điều khiển Xoay.
rotateControlOptions
không bắt buộc
Loại: RotateControlOptions optional
Các lựa chọn hiển thị cho chế độ điều khiển Xoay.
scaleControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt ban đầu của nút điều khiển Tỷ lệ.
scaleControlOptions
không bắt buộc
Loại: ScaleControlOptions optional
Các tuỳ chọn hiển thị ban đầu cho thành phần điều khiển Tỷ lệ.
scrollwheel
không bắt buộc
Loại: boolean optional
Nếu false, thì sẽ tắt tính năng thu phóng trên bản đồ bằng con lăn chuột. Bánh xe cuộn được bật theo mặc định.

Lưu ý: Bạn không nên sử dụng thuộc tính này. Để tắt tính năng thu phóng bằng con lăn chuột, bạn có thể sử dụng thuộc tính gestureHandling và đặt thuộc tính này thành "cooperative" hoặc "none".
streetView
không bắt buộc
Loại: StreetViewPanorama optional
StreetViewPanorama để hiển thị khi người hình mắc áo trong Chế độ xem đường phố được thả trên bản đồ. Nếu không có ảnh toàn cảnh nào được chỉ định, thì StreetViewPanorama mặc định sẽ xuất hiện trong div của bản đồ khi bạn thả hình nhân màu vàng.
streetViewControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt ban đầu của nút điều khiển Người hình mắc áo trong Chế độ xem đường phố. Chế độ điều khiển này là một phần của giao diện người dùng mặc định và phải được đặt thành false khi hiển thị loại bản đồ mà lớp phủ đường của Chế độ xem đường phố không được xuất hiện (ví dụ: loại bản đồ không phải Earth).
streetViewControlOptions
không bắt buộc
Loại: StreetViewControlOptions optional
Các tuỳ chọn hiển thị ban đầu cho nút điều khiển Người hình mắc áo trong Chế độ xem đường phố.
styles
không bắt buộc
Loại: Array<MapTypeStyle> optional
Kiểu để áp dụng cho từng loại bản đồ mặc định. Xin lưu ý rằng đối với chế độ satellite/hybrid và terrain, các kiểu này sẽ chỉ áp dụng cho nhãn và hình học. Tính năng này không hoạt động khi bạn sử dụng mã bản đồ hoặc khi bạn sử dụng bản đồ vectơ (thay vào đó, hãy sử dụng tính năng định kiểu bản đồ dựa trên đám mây).
tilt
không bắt buộc
Loại: number optional
Đối với bản đồ vectơ, hãy đặt góc tới của bản đồ. Các giá trị được phép sẽ bị hạn chế tuỳ thuộc vào mức thu phóng của bản đồ. Đối với bản đồ raster, thuộc tính này kiểm soát hành vi chuyển đổi tự động cho góc tới của bản đồ. Các giá trị duy nhất được cho phép là 0 và 45. Giá trị 0 khiến bản đồ luôn sử dụng chế độ xem từ trên cao 0° bất kể mức thu phóng và khung nhìn. Giá trị 45 khiến góc nghiêng tự động chuyển sang 45 bất cứ khi nào có hình ảnh 45° cho mức thu phóng và khung nhìn hiện tại, đồng thời chuyển về 0 bất cứ khi nào không có hình ảnh 45° (đây là hành vi mặc định). Hình ảnh 45° chỉ có sẵn cho các loại bản đồ satellite và hybrid, ở một số vị trí và ở một số mức thu phóng. Lưu ý: getTilt trả về góc nghiêng hiện tại, chứ không phải giá trị được chỉ định theo tuỳ chọn này. Vì getTilt và tuỳ chọn này đề cập đến những nội dung khác nhau, nên đừng bind() thuộc tính tilt; nếu không, bạn có thể gặp phải những hiệu ứng không lường trước được.
tiltInteractionEnabled
không bắt buộc
Loại: boolean optional
Mặc định: false
Liệu bản đồ có cho phép người dùng điều khiển độ nghiêng của camera hay không. Tuỳ chọn này chỉ có hiệu lực khi bản đồ là bản đồ vectơ. Nếu không được đặt trong mã, thì cấu hình đám mây cho mã bản đồ sẽ được sử dụng (nếu có).
zoom
không bắt buộc
Loại: number optional
Mức thu phóng ban đầu của Bản đồ. Giá trị thu phóng hợp lệ là các số từ 0 đến mức thu phóng tối đa được hỗ trợ. Giá trị thu phóng càng lớn thì độ phân giải càng cao.
zoomControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ điều khiển Thu phóng.
zoomControlOptions
không bắt buộc
Loại: ZoomControlOptions optional
Các tuỳ chọn hiển thị cho thành phần điều khiển Thu phóng.

Giao diện MapTypeStyle

google.maps.MapTypeStyle giao diện

MapTypeStyle là một tập hợp các bộ chọn và bộ tạo kiểu xác định cách tạo kiểu cho bản đồ. Bộ chọn chỉ định các đối tượng và/hoặc thành phần trên bản đồ sẽ chịu ảnh hưởng, còn bộ định kiểu chỉ định cách sửa đổi các đối tượng và thành phần đó. Để biết thông tin chi tiết, hãy xem tài liệu tham khảo về kiểu.
stylers
Loại: Array<Object>
Quy tắc về kiểu để áp dụng cho các đối tượng và thành phần được chọn trên bản đồ. Các quy tắc được áp dụng theo thứ tự mà bạn chỉ định trong mảng này. Để biết nguyên tắc về cách sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.
elementType
không bắt buộc
Loại: string optional
Phần tử mà bạn nên áp dụng trình tạo kiểu. Phần tử là một khía cạnh trực quan của một đối tượng trên bản đồ. Ví dụ: nhãn, biểu tượng, nét vẽ hoặc màu nền được áp dụng cho hình học, v.v. Không bắt buộc. Nếu bạn không chỉ định elementType, thì giá trị này được giả định là 'all'. Để biết thông tin chi tiết về cách sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.
featureType
không bắt buộc
Loại: string optional
Đối tượng địa lý hoặc nhóm đối tượng địa lý mà bạn nên áp dụng một kiểu. Không bắt buộc. Nếu bạn không chỉ định featureType, thì giá trị này được giả định là 'all'. Để biết thông tin chi tiết về cách sử dụng và các giá trị được phép, hãy xem tài liệu tham khảo về kiểu.

Giao diện MapMouseEvent

google.maps.MapMouseEvent giao diện

Đối tượng này được trả về từ nhiều sự kiện chuột trên bản đồ và lớp phủ, đồng thời chứa tất cả các trường hiển thị bên dưới.
domEvent
Sự kiện DOM gốc tương ứng. Nhà phát triển không nên dựa vào các thuộc tính target, currentTarget, relatedTarget và path được xác định và nhất quán. Nhà phát triển cũng không nên dựa vào cấu trúc DOM của quá trình triển khai nội bộ API Maps. Do việc liên kết sự kiện nội bộ, domEvent có thể có ngữ nghĩa khác với MapMouseEvent (ví dụ: MapMouseEvent "nhấp" có thể có domEvent thuộc loại KeyboardEvent).
latLng
không bắt buộc
Loại: LatLng optional
Vĩ độ/kinh độ nằm bên dưới con trỏ khi sự kiện xảy ra.
stop
stop()
Tham số: Không có
Giá trị trả về: void
Ngăn sự kiện này truyền thêm.

Giao diện IconMouseEvent

google.maps.IconMouseEvent interface
extends MapMouseEvent

Đối tượng này được gửi trong một sự kiện khi người dùng nhấp vào một biểu tượng trên bản đồ. Mã địa điểm của địa điểm này được lưu trữ trong thành viên placeId. Để ngăn cửa sổ thông tin mặc định xuất hiện, hãy gọi phương thức stop() trên sự kiện này để ngăn sự kiện này được truyền đi. Tìm hiểu thêm về mã địa điểm trong hướng dẫn dành cho nhà phát triển Places API.
placeId
không bắt buộc
Loại: string optional
Mã địa điểm của địa điểm được nhấp vào. Bạn có thể dùng mã địa điểm này để truy vấn thêm thông tin về đối tượng địa lý đã được nhấp vào.

Tìm hiểu thêm về mã địa điểm trong hướng dẫn dành cho nhà phát triển Places API.
Được kế thừa: domEvent, latLng
Được kế thừa: stop

Hằng số ColorScheme

google.maps.ColorScheme hằng số
thư viện "core"

Giá trị nhận dạng cho bảng phối màu của bản đồ. Chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. Ví dụ: 'FOLLOW_SYSTEM' hoặc google.maps.ColorScheme.FOLLOW_SYSTEM.

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 ColorSchemeString.

const {ColorScheme} = await google.maps.importLibrary("core");
DARK Bảng phối màu tối cho bản đồ.
FOLLOW_SYSTEM Bảng phối màu được chọn dựa trên lựa chọn ưu tiên về hệ thống, được kiểm tra một lần tại thời điểm thực thi phương thức.
LIGHT Bảng phối màu sáng cho bản đồ. Giá trị mặc định cho Maps JS cũ.

Hằng số MapTypeId

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

Giá trị nhận dạng cho các MapType phổ biến. Chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. Ví dụ: 'satellite' hoặc google.maps.MapTypeId.SATELLITE.

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 MapTypeIdString.

const {MapTypeId} = await google.maps.importLibrary("maps");
HYBRID Loại 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.
ROADMAP Loại bản đồ này hiển thị bản đồ đường phố thông thường.
SATELLITE Loại bản đồ này hiển thị hình ảnh vệ tinh.
TERRAIN Loại bản đồ này hiển thị bản đồ có các đặc điểm vật lý như địa hình và thảm thực vật.

Lớp MapTypeRegistry

google.maps.MapTypeRegistry class
extends MVCObject
library "maps"

Sổ đăng ký cho các thực thể MapType, được khoá theo mã nhận dạng MapType.

const {MapTypeRegistry} = await google.maps.importLibrary("maps");
MapTypeRegistry
MapTypeRegistry()
Tham số: Không có
MapTypeRegistry chứa tập hợp các loại bản đồ tuỳ chỉnh mà bản đồ có thể sử dụng. Ví dụ: API sẽ tham khảo sổ đăng ký này khi cung cấp danh sách các loại bản đồ có sẵn trong các chế độ điều khiển.
set
set(id, mapType)
Tham số:
  • id: string Giá trị nhận dạng của MapType cần thêm vào sổ đăng ký.
  • mapType: Đối tượng MapType|* MapType cần thêm vào sổ đăng ký.
Giá trị trả về: Không có
Đặt sổ đăng ký để liên kết giá trị nhận dạng chuỗi đã truyền với MapType đã truyền.
Được kế thừa: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Giao diện MapRestriction

google.maps.MapRestriction giao diện

Một quy định hạn chế có thể áp dụng cho Bản đồ. Khung nhìn của bản đồ sẽ không vượt quá các giới hạn này.
latLngBounds
Khi được đặt, người dùng chỉ có thể kéo và thu phóng bên trong các giới hạn đã cho. Ranh giới có thể hạn chế cả kinh độ và vĩ độ, hoặc chỉ hạn chế vĩ độ. Đối với 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, ví dụ: latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds
không bắt buộc
Loại: boolean optional
Bạn có thể đặt giới hạn nghiêm ngặt hơn bằng cách đặt cờ strictBounds thành true. Điều này làm giảm mức độ thu nhỏ của người dùng, đảm bảo rằng mọi thứ bên ngoài ranh giới bị hạn chế đều bị ẩn. Giá trị mặc định là false, nghĩa là người dùng có thể thu nhỏ cho đến khi toàn bộ khu vực giới hạn nằm trong khung hiển thị, có thể bao gồm cả các khu vực bên ngoài khu vực giới hạn.

Lớp TrafficLayer

google.maps.TrafficLayer class
extends MVCObject
library "maps"

Lớp giao thông.

const {TrafficLayer} = await google.maps.importLibrary("maps");
TrafficLayer
TrafficLayer([opts])
Tham số:
Một lớp hiển thị tình hình giao thông hiện tại trên đường.
getMap
getMap()
Tham số: Không có
Giá trị trả về: Map|null
Trả về bản đồ mà lớp này hiển thị.
setMap
setMap(map)
Tham số:
  • map: Map optional
Giá trị trả về: Không có
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành null, thì lớp này sẽ bị xoá.
setOptions
setOptions(options)
Tham số:
Giá trị trả về: Không có
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Giao diện TrafficLayerOptions

google.maps.TrafficLayerOptions giao diện

Đối tượng TrafficLayerOptions dùng để xác định các thuộc tính có thể đặt trên TrafficLayer.
autoRefresh
không bắt buộc
Loại: boolean optional
Mặc định: true
Liệu lớp giao thông có tự động làm mới bằng thông tin mới nhất hay không.
map
không bắt buộc
Loại: Map optional
Bản đồ để hiển thị lớp giao thông.

Lớp TransitLayer

google.maps.TransitLayer class
extends MVCObject
library "maps"

Lớp phương tiện công cộng.

const {TransitLayer} = await google.maps.importLibrary("maps");
TransitLayer
TransitLayer()
Tham số: Không có
Một lớp hiển thị các tuyến phương tiện công cộng.
getMap
getMap()
Tham số: Không có
Giá trị trả về: Map|null
Trả về bản đồ mà lớp này hiển thị.
setMap
setMap(map)
Tham số:
  • map: Map optional
Giá trị trả về: void
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành null, thì lớp này sẽ bị xoá.
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Lớp BicyclingLayer

google.maps.BicyclingLayer class
extends MVCObject
library "maps"

Một lớp hiển thị các làn đường dành cho xe đạp và đường đi.

const {BicyclingLayer} = await google.maps.importLibrary("maps");
BicyclingLayer
BicyclingLayer()
Tham số: Không có
Một lớp hiển thị làn đường dành cho xe đạp và đường đi, đồng thời giảm hạng các đường lớn.
getMap
getMap()
Tham số: Không có
Giá trị trả về: Map|null
Trả về bản đồ mà lớp này hiển thị.
setMap
setMap(map)
Tham số:
  • map: Map optional
Giá trị trả về: void
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành null, thì lớp này sẽ bị xoá.
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Giao diện CameraOptions

google.maps.CameraOptions giao diện

Dùng để đặt các tuỳ chọn camera của bản đồ.
center
không bắt buộc
Loại: LatLngLiteral|LatLng optional
heading
không bắt buộc
Loại: number optional
tilt
không bắt buộc
Loại: number optional
zoom
không bắt buộc
Loại: number optional

Giao diện VisibleRegion

google.maps.VisibleRegion giao diện

Chứa 4 điểm xác định đa giác 4 cạnh là vùng hiển thị của bản đồ. Trên bản đồ vectơ, đa giác này có thể là hình thang thay vì hình chữ nhật khi bản đồ vectơ có độ nghiêng.
farLeft
Loại: LatLng
farRight
Loại: LatLng
latLngBounds
Loại: LatLngBounds
Hộp giới hạn nhỏ nhất bao gồm vùng hiển thị.
nearLeft
Loại: LatLng
nearRight
Loại: LatLng

Hằng số RenderingType

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

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 RenderingTypeString.

const {RenderingType} = await google.maps.importLibrary("maps");
RASTER Cho biết bản đồ là bản đồ raster.
UNINITIALIZED Cho biết rằng chưa xác định được bản đồ là vectơ hay đường quét vì bản đồ chưa khởi chạy xong.
VECTOR Cho biết bản đồ là bản đồ vectơ.

Giao diện MapCapabilities

google.maps.MapCapabilities giao diện

Đối tượng chứa ảnh chụp nhanh về các tính năng hiện có cho Bản đồ. Xin lưu ý rằng điều này không nhất thiết có nghĩa là các mô-đun có liên quan được tải hoặc khởi chạy, mà là bản đồ hiện tại có quyền sử dụng các API này. Hãy xem các thuộc tính để biết danh sách các chức năng có thể có.
isAdvancedMarkersAvailable
không bắt buộc
Loại: boolean optional
Nếu đúng, bản đồ này được định cấu hình đúng cách để cho phép sử dụng điểm đánh dấu nâng cao. Xin lưu ý rằng bạn vẫn phải nhập thư viện marker để sử dụng điểm đánh dấu nâng cao. Hãy xem https://goo.gle/gmp-isAdvancedMarkersAvailable để biết thêm thông tin.
isDataDrivenStylingAvailable
không bắt buộc
Loại: boolean optional
Nếu đúng, bản đồ này được định cấu hình đúng cách để cho phép sử dụng tính năng định kiểu dựa trên dữ liệu cho ít nhất một FeatureLayer. Hãy xem https://goo.gle/gmp-data-driven-styling và https://goo.gle/gmp-FeatureLayerIsAvailable để biết thêm thông tin.
isWebGLOverlayViewAvailable
không bắt buộc
Loại: boolean optional
Nếu đúng, bản đồ này được định cấu hình đúng cách để cho phép sử dụng WebGLOverlayView.