Lớp PlaceAutocompleteElement
Lớp google.maps.places.PlaceAutocompleteElement
Địa điểm tự động hoàn thành là một lớp con HTMLElement
, cung cấp thành phần giao diện người dùng cho API tự động hoàn thành địa điểm.
Phần tử tuỳ chỉnh:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>
Lớp này mở rộng HTMLElement
.
Lớp này sẽ triển khai PlaceAutocompleteElementOptions
.
Truy cập bằng cách gọi const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
. Xem Thư viện trong API JavaScript Maps.
Hàm dựng | |
---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options) Các thông số:
|
Thuộc tính | |
---|---|
componentRestrictions |
Loại:
ComponentRestrictions optional Các hạn chế về thành phần. Các hạn chế về thành phần dùng để hạn chế các cụm từ gợi ý chỉ ở những thành phần trong thành phần mẹ. Ví dụ: quốc gia. |
locationBias |
Loại:
LocationBias optional Ranh giới hoặc gợi ý mềm để sử dụng khi tìm kiếm địa điểm. |
locationRestriction |
Loại:
LocationRestriction optional Các giới hạn để ràng buộc kết quả tìm kiếm. |
name |
Loại:
string optional Tên được sử dụng cho phần tử đầu vào. Xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name để biết chi tiết. Hoạt động tương tự như thuộc tính tên cho dữ liệu đầu vào. Xin lưu ý rằng đây là tên sẽ được sử dụng khi bạn gửi biểu mẫu. Xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form để biết chi tiết.
Thuộc tính HTML:
|
requestedLanguage |
Loại:
string optional Giá trị nhận dạng ngôn ngữ của ngôn ngữ mà kết quả trả về, nếu có thể. Kết quả bằng ngôn ngữ đã chọn có thể được xếp hạng cao hơn, nhưng các đề xuất không bị hạn chế ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ.
Thuộc tính HTML:
|
requestedRegion |
Loại:
string optional Mã vùng được dùng để định dạng và lọc kết quả. Không hạn chế đề xuất cho quốc gia này. Mã vùng chấp nhận giá trị hai ký tự của ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD (miền cấp cao nhất theo mã quốc gia) đều giống với mã ISO 3166-1, trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD (miền cấp cao nhất theo mã quốc gia) của Vương quốc Anh là "uk" (
.co.uk ) trong khi mã ISO 3166-1 của quốc gia này là "gb" (về mặt kỹ thuật, tên này là "Vương quốc Anh và Bắc Ireland").Thuộc tính HTML:
|
types |
Loại:
Array<string> optional Các loại cụm từ gợi ý sẽ được trả về. Để biết các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu không có loại nào được chỉ định, thì hàm sẽ trả về tất cả các loại.
Thuộc tính HTML:
|
Phụ tùng | |
---|---|
prediction-item |
Một mục trong trình đơn thả xuống chứa cụm từ gợi ý đại diện cho một cụm từ gợi ý. |
prediction-item-icon |
Biểu tượng hiển thị ở bên trái mỗi mục trong danh sách dự đoán. |
prediction-item-main-text |
Một phần của mục dự đoán là văn bản chính của cụm từ gợi ý. Đối với vị trí địa lý, mục này chứa tên địa điểm như "Sydney" hoặc tên đường phố và số nhà, chẳng hạn như "10 King Street". Theo mặc định, văn bản dự đoán-mục-chính có màu đen. Nếu có bất kỳ văn bản nào khác trong mục dự đoán, thì văn bản đó nằm ngoài văn bản dự đoán-mục-main-text và kế thừa kiểu của mục dự đoán đó. Theo mặc định, thẻ này có màu xám. Văn bản bổ sung thường là địa chỉ. |
prediction-item-match |
Phần của cụm từ gợi ý được trả về khớp với thông tin mà người dùng nhập. Theo mặc định, văn bản trùng khớp này được làm nổi bật bằng văn bản in đậm. Xin lưu ý rằng văn bản trùng khớp có thể nằm ở vị trí bất kỳ trong mục dự đoán. Giá trị này không nhất thiết là thuộc tính dự đoán-item-main-text. |
prediction-item-selected |
Mục khi người dùng chuyển đến mục đó thông qua bàn phím. Lưu ý: Các mục đã chọn sẽ chịu ảnh hưởng của cả kiểu bộ phận này và kiểu bộ phận của mục dự đoán. |
prediction-list |
Phần tử hình ảnh có chứa danh sách các dự đoán do dịch vụ Tự động hoàn thành địa điểm trả về. Danh sách này xuất hiện dưới dạng danh sách thả xuống bên dưới Địa điểm tự động hoàn thành. |
Phương thức | |
---|---|
|
addEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện đã chỉ định được phân phối đến mục tiêu. Hãy xem addEventListener |
|
removeEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener |
Sự kiện | |
---|---|
gmp-placeselect |
function(placeAutocompletePlaceSelectEvent) Đối số:
Sự kiện này được kích hoạt khi người dùng chọn một thông tin dự đoán địa điểm. Chứa đối tượng Địa điểm. |
gmp-requesterror |
function(placeAutocompleteRequestErrorEvent) Đối số:
Sự kiện này được kích hoạt khi yêu cầu tới phần phụ trợ bị từ chối (ví dụ: khoá API không chính xác). Sự kiện này không tạo bong bóng trò chuyện. |
Giao diện PlaceAutocompleteElementOptions
Giao diện google.maps.places.PlaceAutocompleteElementOptions
Các tuỳ chọn để tạo Địa điểm tự động hoàn thành.
Thuộc tính | |
---|---|
componentRestrictions optional |
Loại:
ComponentRestrictions optional |
locationBias optional |
Loại:
LocationBias optional |
locationRestriction optional |
Loại:
LocationRestriction optional |
requestedLanguage optional |
Loại:
string optional |
requestedRegion optional |
Loại:
string optional |
types optional |
Loại:
Array<string> optional |
Lớp PlaceAutocompletePlaceSelectEvent
Lớp google.maps.places.PlaceAutocompletePlaceSelectEvent
Sự kiện này được tạo sau khi người dùng chọn một địa điểm có Phần tử tự động hoàn thành địa điểm. Truy cập vùng chọn bằng event.place
.
Lớp này mở rộng Event
.
Truy cập bằng cách gọi const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places")
. Xem Thư viện trong API JavaScript Maps.
Thuộc tính | |
---|---|
|
Loại:
Place |
Lớp PlaceAutocompleteRequestErrorEvent
Lớp google.maps.places.PlaceAutocompleteRequestErrorEvent
Sự kiện này do địa điểm tự động hoàn thành phát ra khi có vấn đề về yêu cầu mạng.
Lớp này mở rộng Event
.
Truy cập bằng cách gọi const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places")
. Xem Thư viện trong API JavaScript Maps.
Lớp Tự động hoàn thành
Lớp google.maps.places.Autocomplete
Một tiện ích cung cấp các dự đoán địa điểm dựa trên nội dung nhập bằng văn bản của người dùng. Mã này sẽ đính kèm vào phần tử đầu vào thuộc loại text
và theo dõi mục nhập văn bản trong trường đó. Danh sách cụm từ gợi ý được trình bày dưới dạng danh sách thả xuống và được cập nhật khi người dùng nhập văn bản.
Lớp này mở rộng MVCObject
.
Truy cập bằng cách gọi const {Autocomplete} = await google.maps.importLibrary("places")
. Xem Thư viện trong API JavaScript Maps.
Hàm dựng | |
---|---|
Autocomplete |
Autocomplete(inputField[, opts]) Các thông số:
Tạo một thực thể mới của Autocomplete . Bản sao này sẽ đính kèm vào trường văn bản nhập được chỉ định với các tuỳ chọn cho sẵn. |
Phương thức | |
---|---|
getBounds |
getBounds() Tham số: Không có
Giá trị trả về:
LatLngBounds|undefined Giới hạn xu hướng.Trả về giới hạn mà các truy vấn dự đoán được thiên vị. |
getFields |
getFields() Tham số: Không có
Giá trị trả về:
Array<string>|undefined Trả về các trường cần đưa vào cho Địa điểm trong phản hồi chi tiết khi thông tin được truy xuất thành công. Để xem danh sách trường, hãy xem PlaceResult . |
getPlace |
getPlace() Tham số: Không có
Giá trị trả về:
PlaceResult Địa điểm do người dùng chọn.Trả về thông tin chi tiết của Địa điểm do người dùng chọn nếu thông tin chi tiết được truy xuất thành công. Nếu không, sẽ trả về một đối tượng Place (Vị trí) mã giả lập, trong đó thuộc tính name được đặt thành giá trị hiện tại của trường nhập dữ liệu. |
setBounds |
setBounds(bounds) Các thông số:
Giá trị trả lại hàng: Không có
Đặt vùng ưu tiên nơi trả về kết quả Địa điểm. Kết quả thiên về, nhưng không giới hạn ở khu vực này. |
setComponentRestrictions |
setComponentRestrictions(restrictions) Các thông số:
Giá trị trả lại hàng: Không có
Đặt các hạn chế về thành phần. Các hạn chế về thành phần dùng để hạn chế các cụm từ gợi ý chỉ ở những thành phần trong thành phần mẹ. Ví dụ: quốc gia. |
setFields |
setFields(fields) Các thông số:
Giá trị trả lại hàng: Không có
Đặt các trường cần đưa vào cho Địa điểm trong phản hồi chi tiết khi thông tin được truy xuất thành công. Để xem danh sách trường, hãy xem PlaceResult . |
setOptions |
setOptions(options) Các thông số:
Giá trị trả lại hàng: Không có
|
setTypes |
setTypes(types) Các thông số:
Giá trị trả lại hàng: Không có
Đặt loại dự đoán sẽ được trả về. Để biết các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu không có loại nào được chỉ định, thì hàm sẽ trả về tất cả các loại. |
Kế thừa:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Sự kiện | |
---|---|
place_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi người dùng đã chọn một PlaceResult cho một Địa điểm mà người dùng đã chọn. Nếu người dùng nhập tên của một địa điểm không do chế độ kiểm soát đề xuất và nhấn phím Enter hoặc nếu yêu cầu Chi tiết địa điểm không thành công, thì PlaceResult sẽ chứa thông tin do người dùng nhập vào thuộc tính name mà không có thuộc tính nào khác được xác định. |
Giao diện AutocompleteOptions
Giao diện google.maps.places.AutocompleteOptions
Các tuỳ chọn có thể đặt cho đối tượng Autocomplete
.
Thuộc tính | |
---|---|
bounds optional |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Khu vực mà trong đó để tìm kiếm địa điểm. |
componentRestrictions optional |
Loại:
ComponentRestrictions optional Các hạn chế về thành phần. Các hạn chế về thành phần dùng để hạn chế các cụm từ gợi ý chỉ ở những thành phần trong thành phần mẹ. Ví dụ: quốc gia. |
fields optional |
Loại:
Array<string> optional Các trường sẽ được thêm cho Địa điểm trong phản hồi chi tiết khi thông tin được truy xuất thành công. Thông tin này sẽ được tính phí. Nếu ['ALL'] được truyền vào, tất cả các trường có sẵn sẽ được trả về và thanh toán (điều này không được đề xuất cho quá trình triển khai sản xuất). Để xem danh sách trường, hãy xem PlaceResult . Bạn có thể chỉ định các trường lồng nhau bằng đường dẫn dấu chấm (ví dụ: "geometry.location" ). Giá trị mặc định là ['ALL'] . |
|
Loại:
boolean optional Liệu có chỉ truy xuất ID địa điểm hay không. PlaceResult cung cấp khi sự kiện place_thay đổi được kích hoạt sẽ chỉ có các trường place_id, loại và tên, cùng với place_id, loại và nội dung mô tả do dịch vụ Tự động hoàn thành trả về. Tắt theo mặc định. |
strictBounds optional |
Loại:
boolean optional Một giá trị boolean, cho biết rằng tiện ích Tự động hoàn thành chỉ trả về các vị trí nằm trong ranh giới của tiện ích Tự động hoàn thành tại thời điểm gửi truy vấn. Việc đặtStrictBounds thành false (giá trị mặc định) sẽ làm cho kết quả sai lệch (nhưng không bị giới hạn ở những vị trí nằm trong giới hạn). |
types optional |
Loại:
Array<string> optional Các loại cụm từ gợi ý sẽ được trả về. Để biết các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu không có loại nào được chỉ định, thì hàm sẽ trả về tất cả các loại. |
Lớp SearchBox
Lớp google.maps.places.SearchBox
Một tiện ích cung cấp các cụm từ dự đoán truy vấn dựa trên nội dung văn bản mà người dùng nhập. Mã này sẽ đính kèm vào phần tử đầu vào thuộc loại text
và theo dõi mục nhập văn bản trong trường đó. Danh sách cụm từ gợi ý được trình bày dưới dạng danh sách thả xuống và được cập nhật khi người dùng nhập văn bản.
Lớp này mở rộng MVCObject
.
Truy cập bằng cách gọi const {SearchBox} = await google.maps.importLibrary("places")
. Xem Thư viện trong API JavaScript Maps.
Hàm dựng | |
---|---|
SearchBox |
SearchBox(inputField[, opts]) Các thông số:
Tạo một thực thể mới của SearchBox . Bản sao này sẽ đính kèm vào trường văn bản nhập được chỉ định với các tuỳ chọn cho sẵn. |
Phương thức | |
---|---|
getBounds |
getBounds() Tham số: Không có
Giá trị trả về:
LatLngBounds|undefined Trả về giới hạn mà các dự đoán truy vấn được đặt lệch. |
getPlaces |
getPlaces() Tham số: Không có
Giá trị trả về:
Array<PlaceResult>|undefined Trả về truy vấn do người dùng chọn để sử dụng cùng với sự kiện places_changed . |
setBounds |
setBounds(bounds) Các thông số:
Giá trị trả lại hàng: Không có
Đặt vùng dùng để dự đoán truy vấn xu hướng. Kết quả sẽ chỉ thiên về khu vực này chứ không bị giới hạn hoàn toàn. |
Kế thừa:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Sự kiện | |
---|---|
places_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi người dùng chọn một truy vấn, getPlaces sẽ được sử dụng để nhận các địa điểm mới. |
Giao diện SearchBoxOptions
Giao diện google.maps.places.SearchBoxOptions
Các tuỳ chọn có thể đặt cho đối tượng SearchBox
.
Thuộc tính | |
---|---|
bounds optional |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Vùng mà xu hướng dự đoán truy vấn. Thông tin dự đoán được thiên vị (nhưng không chỉ gồm) các cụm từ tìm kiếm nhắm đến những giới hạn này. |