Map View

Lớp LocalContextMapView

Lớp google.maps.localContext.LocalContextMapView

Không dùng nữa: Bối cảnh địa phương không còn được dùng nữa và bạn không nên sử dụng cho các trang web mới. 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ự tạo một trải nghiệm tương tự như Local Context, bạn nên xem giải pháp "Khám phá khu vực lân cận" trong Quick Builder 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 Places có thể giúp bạn.

Lưu ý: Chỉ có trong kênh v=beta.

Hiện một trải nghiệm Ngữ cảnh địa phương 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 Thư viện trong Maps JavaScript API.

Hàm dựng
LocalContextMapView	LocalContextMapView(options) Tham 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ế độ chỉ đọc. Phần tử DOM hỗ trợ khung hiển thị.
isTransitioningMapBounds	Loại:  boolean Được đặt thành true trước khi LocalContextMapView bắt đầu thay đổi ranh giới của Map bên trong và được đặt thành false sau khi LocalContextMapView hoàn tất việc thay đổi ranh giới của Map bên trong. (Không được đặt khi chế độ bố cục thay đổi do 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) Tham 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() Tham số:  Không có Giá trị trả về:  Không có Ẩn thông tin chi tiết về địa điểm.
search	search() Tham số:  Không có Giá trị trả về:  Không có Tìm kiếm những địa điểm để cho người dùng thấy 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 sẽ kích hoạt nếu có lỗi xảy ra trong 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 chuyển động ra ngoài.
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 chuyển động.

Giao diện LocalContextMapViewOptions

google.maps.localContext.LocalContextMapViewOptionsgiao diện

Lưu ý: Chỉ có trong kênh v=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 tham số này là 0, Thư viện bối cảnh địa phương sẽ không tải các đị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 loại). Loại Iterable<string|PlaceTypePreference> cũng được chấp nhận, nhưng chỉ được hỗ trợ trong những trình duyệt hỗ trợ Symbol JavaScript gốc.
directionsOptions optional	Loại:  MapDirectionsOptions|MapDirectionsOptionsLiteral optional Các lựa chọn để tuỳ chỉnh đường đi. Nếu bạn không đặt, thì đường đi và khoảng cách sẽ bị tắt.
element optional	Loại:  HTMLElement|SVGElement optional Trường này ở chế độ chỉ đọc. Phần tử DOM hỗ trợ khung hiển thị.
locationBias optional	Loại:  LocationBias optional Mặc định: null Một 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 Ranh giới để hạn chế kết quả tìm kiếm. Nếu bạn không chỉ định, kết quả sẽ bị giới hạn trong khung hiển thị bản đồ.
map optional	Loại:  Map optional Một thực thể Map đã được tạo. Nếu được truyền vào, bản đồ sẽ được di chuyển vào DOM của LocalContextMapView và 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 do LocalContextMapView áp dụng.
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 giá trị đầu vào của lệnh gọi lại thay đổi. Truyền một hàm để ghi đè chế độ thiết lập mặc định một cách linh động khi LocalContextMapView vẽ điểm đánh dấu địa điểm. 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 dùng 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ế độ thiết lập của chế độ xem bộ chọn địa điểm. Truyền một hàm để linh hoạt ghi đè 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 (thay vào đó, các giá trị mặc định sẽ được sử dụng và các lỗi sẽ được ghi vào bảng điều khiển). Các lỗi được phát hiện trong quá trình tạo sẽ khiến các lỗi được truyền đồng bộ.
placeDetailsViewSetup optional	Loại:  (function({   defaultLayoutMode:PlaceDetailsLayoutMode,   defaultPosition:PlaceDetailsPosition optional }): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional Ghi đè chế độ thiết lập của khung hiển thị thông tin chi tiết về địa điểm. Truyền một hàm để linh hoạt ghi đè 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 dùng và các lỗi sẽ được ghi vào bảng điều khiển). Các lỗi được phát hiện trong quá trình tạo sẽ khiến các lỗi được truyền đồng bộ.

PlaceTypePreference typedef

google.maps.localContext.PlaceTypePreference typedef

Lưu ý: 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 trọng số mặc định. 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

Lưu ý: Chỉ có trong kênh v=beta.

Cung cấp chế độ cài đặt cho chỉ đường 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 Thư viện trong Maps JavaScript API.

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

Phương thức
addListener	addListener(eventName, handler) Tham 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

google.maps.localContext.MapDirectionsOptionsLiteralgiao diện

Lưu ý: Chỉ có trong kênh v=beta.

Các đối tượng chữ được chấp nhận thay cho các đối tượng MapDirectionsOptions, vì sự thuận tiện ở nhiều nơi. Các đối tượng này sẽ được chuyển đổi thành các đối tượng MapDirectionsOptions khi Maps API gặp phải chúng.

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

Giao diện PinOptions

google.maps.localContext.PinOptionsgiao diện

Lưu ý: Chỉ có trong kênh v=beta.

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

Thuộc tính
background optional	Loại:  string optional Màu sắc 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 glyph trong 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à giá trị tuyệt đối, không phải giá trị tương đối so với kích thước mặc định ở mỗi trạng thái.

Giao diện PlaceChooserViewSetupOptions

google.maps.localContext.PlaceChooserViewSetupOptionsgiao diện

Thiết lập các lựa chọn 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, 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

Lưu ý: 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 Thư viện trong Maps JavaScript API.

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

Hằng số PlaceChooserPosition

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

Lưu ý: Chỉ có trong kênh v=beta.

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

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

Hằng số
BLOCK_END	Bộ chọn địa điểm xuất hiện 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	Bộ chọn địa điểm xuất hiện cùng với bản đồ ở cuối đườ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 xuất hiện cùng với bản đồ ở đầu đườ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

google.maps.localContext.PlaceDetailsViewSetupOptionsgiao diện

Thiết lập các lựa 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 được truyền, 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

Lưu ý: Chỉ có trong kênh v=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 Thư viện trong Maps JavaScript API.

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

Hằng số PlaceDetailsPosition

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

Lưu ý: Chỉ có trong kênh v=beta.

Vị trí hiển thị 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 Thư viện trong Maps JavaScript API.

Hằng số
INLINE_END	Thông tin chi tiết về địa điểm sẽ xuất hiện cù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ẽ xuất hiện cùng với bản đồ ở đầu đườ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 đồ.)