Map View

Lớp LocalContextMapView

Lớp google.maps.localContext.LocalContextMapView

Không dùng nữa: Không nên sử dụng ngữ cảnh cục bộ cho các trang web mới nữa. Tính năng này sẽ tiếp tục hoạt động và chúng tôi sẽ thông báo trước 12 tháng trước khi ngừng hỗ trợ. Nếu muốn tự xây dựng trải nghiệm tương tự như Ngữ cảnh cục bộ, bạn nên xem giải pháp "Khám phá khu vực lân cận" trong Trình tạo nhanh hoặc sử dụng Thư viện địa điểm, Maps JavaScript API. Mã mẫu và lớp học lập trình cho Thư viện địa điểm có thể giúp bạn.

Thông báo: Chỉ có trong kênh v=beta.

Hiển thị trải nghiệm Ngữ cảnh cục bộ bằng Map.

Lớp này triển khai LocalContextMapViewOptions.

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

Hàm dựng
LocalContextMapView	LocalContextMapView(options) Thông số:  options:  LocalContextMapViewOptions

Thuộc tính
directionsOptions	Loại:  MapDirectionsOptions|MapDirectionsOptionsLiteral optional Vui lòng xem LocalContextMapViewOptions.directionsOptions.
element optional	Loại:  HTMLElement|SVGElement optional Trường này chỉ có thể đọc. Phần tử DOM sao lưu thành phần hiển thị.
isTransitioningMapBounds	Loại:  boolean Được đặt thành true trước khi LocalContextMapView bắt đầu thay đổi các giới hạn của Map bên trong và được đặt thành false sau khi LocalContextMapView hoàn tất việc thay đổi các giới hạn của Map bên trong. (Không được đặt khi chế độ bố cục thay đổi do đổi kích thước thích ứng.)
locationBias	Loại:  LocationBias optional Vui lòng xem LocalContextMapViewOptions.locationBias. Việc thay đổi thuộc tính này trên LocalContextMapView có thể kích hoạt một lượt tìm kiếm mới.
locationRestriction	Loại:  LocationRestriction optional Vui lòng xem LocalContextMapViewOptions.locationRestriction. Việc thay đổi thuộc tính này trên LocalContextMapView có thể kích hoạt một lượt tìm kiếm mới.
maxPlaceCount	Loại:  number Vui lòng xem LocalContextMapViewOptions.maxPlaceCount. Việc thay đổi thuộc tính này trên LocalContextMapView có thể kích hoạt một lượt tìm kiếm mới.
placeTypePreferences	Loại:  Array<PlaceTypePreference> Vui lòng xem LocalContextMapViewOptions.placeTypePreferences. Việc thay đổi thuộc tính này trên LocalContextMapView có thể kích hoạt một lượt tìm kiếm mới. Iterable<string|PlaceTypePreference> cũng được chấp nhận.
Kế thừa: map, pinOptionsSetup, placeChooserViewSetup, placeDetailsViewSetup

Phương thức
addListener	addListener(eventName, handler) Thông số:  eventName:  string handler:  Function Giá trị trả về:  MapsEventListener Thêm hàm trình nghe đã cho vào tên sự kiện đã cho.
hidePlaceDetailsView	hidePlaceDetailsView() Thông số:  Không có Giá trị trả về:  Không có Ẩn thông tin chi tiết về địa điểm.
search	search() Thông số:  Không có Giá trị trả về:  Không có Tìm kiếm địa điểm để hiển thị cho người dùng dựa trên maxPlaceCount, placeTypePreferences, locationRestriction và locationBias hiện tại.

Sự kiện
error	function(event) Đối số:  event:  ErrorEvent Sự kiện này được kích hoạt nếu có lỗi trong khi tìm kiếm.
placedetailsviewhidestart	function() Đối số:  Không có Sự kiện này được kích hoạt trước khi thông tin chi tiết về địa điểm bắt đầu tạo hiệu ứng ảnh động.
placedetailsviewshowstart	function() Đối số:  Không có Sự kiện này được kích hoạt trước khi thông tin chi tiết về địa điểm bắt đầu tạo hiệu ứng ảnh động.

Giao diện LocalContextMapViewOptions

Giao diện google.maps.localContext.LocalContextMapViewOptions

Thông báo: Chỉ có trong kênh v=beta.

Các tuỳ chọn để tạo LocalContextMapView hoặc truy cập vào LocalContextMapView hiện có.

Thuộc tính
maxPlaceCount	Loại:  number Số lượng địa điểm tối đa để hiển thị. Khi tham số này là 0, Thư viện ngữ cảnh cục bộ sẽ không tải địa điểm. [0,24]
placeTypePreferences	Loại:  Array<PlaceTypePreference> Các loại địa điểm cần tìm (tối đa 10 địa điểm). Loại Iterable<string|PlaceTypePreference> cũng được chấp nhận, nhưng chỉ được hỗ trợ trong các trình duyệt hỗ trợ Ký hiệu JavaScript gốc.
directionsOptions optional	Loại:  MapDirectionsOptions|MapDirectionsOptionsLiteral optional Các tuỳ chọn để tuỳ chỉnh thông tin đường đi. Nếu bạn không đặt, tính năng chỉ đường và khoảng cách sẽ bị tắt.
element optional	Loại:  HTMLElement|SVGElement optional Trường này chỉ có thể đọc. Phần tử DOM sao lưu thành phần hiển thị.
locationBias optional	Loại:  LocationBias optional Mặc định: null Ranh giới mềm hoặc gợi ý để sử dụng khi tìm kiếm địa điểm.
locationRestriction optional	Loại:  LocationRestriction optional Giới hạn để ràng buộc kết quả tìm kiếm. Nếu không được chỉ định, kết quả sẽ bị ràng buộc trong khung nhìn bản đồ.
map optional	Loại:  Map optional Một thực thể Map đã được tạo bản sao. Nếu được truyền vào, bản đồ sẽ được chuyển vào DOM của LocalContextMapView và sẽ không được tạo kiểu lại. Phần tử liên kết với Bản đồ cũng có thể có các kiểu và lớp được LocalContextMapView áp dụng cho phần tử đó.
pinOptionsSetup optional	Loại:  (function({   isSelected:boolean,   isHighlighted:boolean }): (PinOptions optional))|PinOptions optional Định cấu hình biểu tượng điểm đánh dấu vị trí dựa trên trạng thái biểu tượng. Được gọi bất cứ khi nào dữ liệu đầu vào của lệnh gọi lại thay đổi. Truyền một hàm để ghi đè linh động chế độ thiết lập mặc định khi LocalContextMapView vẽ điểm đánh dấu vị trí. Các lỗi và cấu hình không hợp lệ có thể được xác định không đồng bộ và sẽ bị bỏ qua (các giá trị mặc định sẽ được sử dụng và lỗi sẽ được ghi vào bảng điều khiển).
placeChooserViewSetup optional	Loại:  (function({   defaultLayoutMode:PlaceChooserLayoutMode,   defaultPosition:PlaceChooserPosition optional }): (PlaceChooserViewSetupOptions optional))|PlaceChooserViewSetupOptions optional Ghi đè chế độ thiết lập của thành phần hiển thị bộ chọn địa điểm. Truyền một hàm để ghi đè linh động chế độ thiết lập mặc định khi LocalContextMapView có thể thay đổi bố cục do đổi kích thước. Lỗi và cấu hình không hợp lệ có thể được xác định không đồng bộ và sẽ bị bỏ qua (mặc định sẽ được sử dụng và lỗi sẽ được ghi vào bảng điều khiển). Lỗi phát hiện được trong quá trình tạo sẽ khiến lỗi được gửi đồng bộ.
placeDetailsViewSetup optional	Loại:  (function({   defaultLayoutMode:PlaceDetailsLayoutMode,   defaultPosition:PlaceDetailsPosition optional }): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional Ghi đè chế độ thiết lập của chế độ xem thông tin chi tiết về địa điểm. Truyền một hàm để ghi đè linh động chế độ thiết lập mặc định khi LocalContextMapView có thể thay đổi bố cục do đổi kích thước. Các lỗi và cấu hình không hợp lệ có thể được xác định không đồng bộ và sẽ bị bỏ qua (các giá trị mặc định sẽ được sử dụng và lỗi sẽ được ghi vào bảng điều khiển). Lỗi phát hiện được trong quá trình tạo sẽ khiến lỗi được gửi đồng bộ.

PlaceTypePreference typedef

google.maps.localContext.PlaceTypePreference typedef

Thông báo: Chỉ có trong kênh v=beta.

Loại địa điểm cần tìm và trọng số cần sử dụng. Nếu bạn bỏ qua weight, thư viện sẽ xác định các trọng số mặc định. Các trọng số này có thể thay đổi và cải thiện theo thời gian.

{
  type:string,
  weight:number optional
}

Lớp MapDirectionsOptions

Lớp google.maps.localContext.MapDirectionsOptions

Thông báo: Chỉ có trong kênh v=beta.

Cung cấp chế độ cài đặt cho thông tin đường đi bằng LocalContextMapView.

Lớp này triển khai MapDirectionsOptionsLiteral.

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

Thuộc tính
Kế thừa: origin

Phương thức
addListener	addListener(eventName, handler) Thông số:  eventName:  string handler:  Function Giá trị trả về:  MapsEventListener Thêm hàm trình nghe đã cho vào tên sự kiện đã cho.

Giao diện MapDirectionsOptionsLiteral

Giao diện google.maps.localContext.MapDirectionsOptionsLiteral

Thông báo: Chỉ có trong kênh v=beta.

Để thuận tiện, ở nhiều nơi, bạn có thể dùng giá trị cố định đối tượng thay cho đối tượng MapDirectionsOptions. Các đối tượng này được chuyển đổi thành đối tượng MapDirectionsOptions khi API Maps gặp phải.

Thuộc tính
origin	Loại:  LatLng|LatLngLiteral Điểm xuất phát cho đường đi và khoảng cách.

Giao diện PinOptions

Giao diện google.maps.localContext.PinOptions

Thông báo: Chỉ có trong kênh v=beta.

Các tuỳ chọn để tuỳ chỉnh điểm đánh dấu ghim.

Thuộc tính
background optional	Loại:  string optional Màu của hình dạng biểu tượng có thể là bất kỳ màu CSS hợp lệ nào.
glyphColor optional	Loại:  string optional Màu của ký tự biểu tượng có thể là bất kỳ màu CSS hợp lệ nào.
scale optional	Loại:  number optional Tỷ lệ của biểu tượng. Giá trị này là tuyệt đối, không tương ứng với kích thước mặc định trong mỗi trạng thái.

Giao diện PlaceChooserViewSetupOptions

Giao diện google.maps.localContext.PlaceChooserViewSetupOptions

Các tuỳ chọn thiết lập cho bộ chọn địa điểm. Đọc thêm về cách thiết lập bố cục và chế độ hiển thị.

Thuộc tính
layoutMode optional	Loại:  PlaceChooserLayoutMode optional
position optional	Loại:  PlaceChooserPosition optional Bỏ qua khi layoutMode:HIDDEN. Nếu không được truyền, hệ thống sẽ tự động xác định vị trí dựa trên layoutMode.

Hằng số PlaceChooserLayoutMode

Hằng số google.maps.localContext.PlaceChooserLayoutMode

Thông báo: Chỉ có trong kênh v=beta.

Chế độ bố cục cho bộ chọn địa điểm.

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

Hằng số
HIDDEN	Trình chọn địa điểm bị ẩn.
SHEET	Trình chọn địa điểm hiển thị dưới dạng một trang tính.

Hằng số PlaceChooserPosition

Hằng số google.maps.localContext.PlaceChooserPosition

Thông báo: Chỉ có trong kênh v=beta.

Hiển thị vị trí cho bộ chọn địa điểm.

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

Hằng số
BLOCK_END	Bộ chọn địa điểm hiển thị trên một dòng bên dưới bản đồ kéo dài đến cuối vùng chứa.
INLINE_END	Trình chọn địa điểm hiển thị cùng dòng với bản đồ ở cuối dòng. (Đối với ngôn ngữ đọc từ trái sang phải, điều này có nghĩa là bộ chọn địa điểm nằm ở bên phải bản đồ.)
INLINE_START	Trình chọn địa điểm hiển thị cùng dòng với bản đồ ở đầu dòng. (Đối với ngôn ngữ đọc từ trái sang phải, điều này có nghĩa là bộ chọn địa điểm nằm ở bên trái bản đồ.)

Giao diện PlaceDetailsViewSetupOptions

Giao diện google.maps.localContext.PlaceDetailsViewSetupOptions

Các tuỳ chọn thiết lập cho thông tin chi tiết về địa điểm. Đọc thêm về cách thiết lập bố cục và chế độ hiển thị.

Thuộc tính
hidesOnMapClick optional	Loại:  boolean optional
layoutMode optional	Loại:  PlaceDetailsLayoutMode optional
position optional	Loại:  PlaceDetailsPosition optional Bỏ qua khi layoutMode:INFO_WINDOW. Nếu không được truyền, hệ thống sẽ tự động xác định vị trí dựa trên layoutMode.

Hằng số PlaceDetailsLayoutMode

Hằng số google.maps.localContext.PlaceDetailsLayoutMode

Thông báo: Chỉ có trong kênh v=beta.

Chế độ bố cục cho thông tin chi tiết về địa điểm.

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

Hằng số
INFO_WINDOW	Thông tin chi tiết về địa điểm sẽ hiển thị trong InfoWindow.
SHEET	Thông tin chi tiết về địa điểm sẽ hiển thị trong một trang tính.

Hằng số PlaceDetailsPosition

Hằng số google.maps.localContext.PlaceDetailsPosition

Thông báo: Chỉ có trong kênh v=beta.

Hiển thị vị trí cho thông tin chi tiết về địa điểm.

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

Hằng số
INLINE_END	Thông tin chi tiết về địa điểm sẽ hiển thị cùng dòng với bản đồ ở cuối dòng. (Đối với ngôn ngữ đọc từ trái sang phải, điều này có nghĩa là thông tin chi tiết về địa điểm nằm ở bên phải bản đồ.)
INLINE_START	Thông tin chi tiết về địa điểm sẽ hiển thị cùng dòng với bản đồ ở đầu dòng. (Đối với ngôn ngữ đọc từ trái sang phải, điều này có nghĩa là thông tin chi tiết về địa điểm nằm ở bên trái bản đồ.)