Map View

Lớp LocalContextMapView

Lớp google.maps.localContext.LocalContextMapView

Không dùng nữa: Ngữ cảnh cục bộ không còn được dùng nữa và không còn được đề xuất cho các trang web mới. Tính năng này sẽ tiếp tục hoạt động và sẽ thông báo trước 12 tháng trước khi ngừng hỗ trợ. Nếu bạn muốn tự xây dựng trải nghiệm giống Ngữ cảnh cục bộ, chúng tôi khuyên bạn nên xem giải pháp "Khám phá vùng lân cận" trong Trình tạo nhanh hoặc sử dụng Thư viện địa điểm, API Maps JavaScript. 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 vv beta.

Thể hiện trải nghiệm theo Ngữ cảnh cục bộ bằng Map.

Lớp này sẽ 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 Maps JavaScript API.

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. Phần tử DOM sao lưu chế độ xem.
isTransitioningMapBounds	Loại:  boolean Được đặt thành true trước khi LocalContextMapView bắt đầu thay đổi 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 giới hạn của Map bên trong. (Không đặt khi chế độ bố cục thay đổi do việc thay đổ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 pháp
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 các địa điểm để hiển thị 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 xảy ra lỗi khi thực hiện 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 hoạt ảnh.
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 hoạt ảnh.

Giao diện LocalContextMapViewOptions

Giao diện google.maps.localContext.LocalContextMapViewOptions

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

Các lựa chọn để tạo một LocalContextMapView hoặc truy cập vào một 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 thông 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 để tìm kiếm (tối đa 10). 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 vốn hỗ trợ Ký hiệu JavaScript.
directionsOptions optional	Loại:  MapDirectionsOptions|MapDirectionsOptionsLiteral optional Các tuỳ chọn để tuỳ chỉnh đường đi. Nếu bạn không đặt chính sách này, thì thông tin đường đi và khoảng cách sẽ bị tắt.
element optional	Loại:  HTMLElement|SVGElement optional Trường này chỉ đọc. Phần tử DOM sao lưu chế độ xem.
locationBias optional	Loại:  LocationBias optional Mặc định: null Gợi ý hoặc ranh giới mềm để sử dụng khi tìm kiếm địa điểm.
locationRestriction optional	Loại:  LocationRestriction optional Giới hạn các kết quả tìm kiếm. Nếu bạn không chỉ định, các kết quả sẽ bị hạn chế với 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 chuyển tới, 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ử được 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ử này.
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 địa điểm dựa trên trạng thái biểu tượng. Được gọi bất cứ khi nào đầu vào cho lệnh gọi lại thay đổi. Truyền một hàm để ghi đè động chế độ thiết lập mặc định khi LocalContextMapView vẽ điểm đánh dấu địa điểm. 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 (sẽ sử dụng mặc định và các 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ế độ xem của trình chọn địa điểm. Truyền một hàm để ghi đè động chế độ thiết lập mặc định khi LocalContextMapView có thể thay đổi bố cục do việc thay đổ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 được phát hiện khi xây dựng 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ế độ xem chi tiết về địa điểm. Truyền một hàm để ghi đè động chế độ thiết lập mặc định khi LocalContextMapView có thể thay đổi bố cục do việc thay đổ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 (sẽ sử dụng mặc định và các lỗi sẽ được ghi vào bảng điều khiển). Lỗi được phát hiện khi xây dựng sẽ khiến lỗi được gửi đồng bộ.

Loại lỗi PlaceTypePreference

google.maps.localContext.PlaceTypePreference defdef

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

Loại địa điểm để tìm kiếm và trọng lượng sử dụng. Nếu bạn bỏ qua weight, thư viện sẽ xác định trọng số mặc định, 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 vv beta.

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

Lớp này sẽ 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 Maps JavaScript API.

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

Phương pháp
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 vv beta.

Hằng đối tượng được chấp nhận thay cho đối tượng MapDirectionsOptions ở một số nơi để thuận tiện. Các đối tượng này được chuyển đổi thành các đối tượng MapDirectionsOptions khi API Maps gặp các đối tượng đó.

Thuộc tính
origin	Loại:  LatLng|LatLngLiteral Điểm khởi hành cho chỉ đường 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 vv beta.

Các tùy chọn để tùy 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ự của 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ệ biểu tượng. Giá trị này là tuyệt đối, không liên quan đến kích thước mặc định ở mỗi trạng thái.

Giao diện PlaceChooserViewSetupOptions

Giao diện google.maps.localContext.PlaceChooserViewSetupOptions

Tùy chọn thiết lập cho trình 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 vượt qua, một vị trí sẽ được xác định tự động 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 vv beta.

Chế độ bố cục cho trình 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 Maps JavaScript API.

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

Hằng số PlaceChooserPosition

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

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

Hiển thị các vị trí cho trình 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 Maps JavaScript API.

Các hằng số
BLOCK_END	Công cụ chọn địa điểm được 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 được hiển thị cùng dòng với bản đồ ở cuối dòng. (Đối với ngôn ngữ từ trái sang phải, điều này có nghĩa là người chọn địa điểm nằm ở bên phải bản đồ.)
INLINE_START	Trình chọn địa điểm được hiển thị cùng dòng với bản đồ ở đầu dòng. (Đối với ngôn ngữ từ trái sang phải, điều này có nghĩa là người chọn địa điểm nằm ở bên trái bản đồ.)

Giao diện PlaceDetailsViewSetupOptions

Giao diện google.maps.localContext.PlaceDetailsViewSetupOptions

Thiết lập tuỳ chọn 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 vượt qua, một vị trí sẽ được xác định tự động 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 vv beta.

Các 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 Maps JavaScript API.

Các 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 được 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 vv beta.

Hiển thị các 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 Maps JavaScript API.

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