Lớp Place
Lớp google.maps.places.Place
Truy cập bằng cách gọi const {Place} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Hàm dựng | |
---|---|
Place |
Place(options) Thông số:
|
Phương thức tĩnh | |
---|---|
searchByText |
searchByText(request) Thông số:
Tìm kiếm địa điểm dựa trên cụm từ tìm kiếm dạng văn bản. |
searchNearby |
searchNearby(request) Thông số:
Tìm kiếm địa điểm lân cận. |
Thuộc tính | |
---|---|
accessibilityOptions |
Loại:
AccessibilityOptions optional Các lựa chọn hỗ trợ tiếp cận của Địa điểm này. undefined nếu dữ liệu về các tuỳ chọn hỗ trợ tiếp cận chưa được gọi từ máy chủ. |
addressComponents |
Loại:
Array<AddressComponent> optional Tập hợp các thành phần địa chỉ cho vị trí của Địa điểm này. Đối tượng trống nếu không có dữ liệu địa chỉ nào được biết. undefined nếu dữ liệu địa chỉ chưa được gọi từ máy chủ. |
adrFormatAddress |
Loại:
string optional Nội dung thể hiện địa chỉ của Địa điểm theo định dạng vi mô adr. |
allowsDogs |
Loại:
boolean optional |
attributions |
Loại:
Array<Attribution> optional Văn bản ghi công sẽ xuất hiện cho kết quả về Địa điểm này. |
businessStatus |
Loại:
BusinessStatus optional Trạng thái hoạt động của địa điểm. null nếu không có trạng thái nào được biết. undefined nếu dữ liệu trạng thái chưa được tải từ máy chủ. |
displayName |
Loại:
string optional Tên hiển thị của vị trí. null nếu không có tên. undefined nếu dữ liệu tên chưa được tải từ máy chủ. |
editorialSummary |
Loại:
string optional Bản tóm tắt nội dung biên tập về địa điểm này. null nếu không có bản tóm tắt nội dung biên tập. undefined nếu trường này chưa được yêu cầu. |
editorialSummaryLanguageCode |
Loại:
string optional Ngôn ngữ của bản tóm tắt nội dung biên tập cho địa điểm này. null nếu không có bản tóm tắt nội dung biên tập. undefined nếu trường này chưa được yêu cầu. |
formattedAddress |
Loại:
string optional Địa chỉ đầy đủ của vị trí. |
googleMapsURI |
Loại:
string optional URL của trang chính thức của Google về địa điểm này. Đây là trang do Google sở hữu, chứa thông tin tốt nhất hiện có về Địa điểm. |
hasCurbsidePickup |
Loại:
boolean optional Địa điểm có cung cấp dịch vụ nhận hàng ở lề đường hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
hasDelivery |
Loại:
boolean optional Địa điểm có dịch vụ giao hàng tận nơi hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
hasDineIn |
Loại:
boolean optional Địa điểm có phục vụ ăn uống tại chỗ hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
hasLiveMusic |
Loại:
boolean optional |
hasMenuForChildren |
Loại:
boolean optional |
hasOutdoorSeating |
Loại:
boolean optional |
hasRestroom |
Loại:
boolean optional |
hasTakeout |
Loại:
boolean optional Địa điểm có phục vụ đồ ăn mang đi hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
hasWiFi |
Loại:
boolean optional |
iconBackgroundColor |
Loại:
string optional Mã màu HEX mặc định cho danh mục của địa điểm. |
id |
Loại:
string Mã địa điểm duy nhất. |
internationalPhoneNumber |
Loại:
string optional Số điện thoại của địa điểm theo định dạng quốc tế. Định dạng quốc tế bao gồm mã quốc gia và có tiền tố là dấu cộng (+). |
isGoodForChildren |
Loại:
boolean optional |
isGoodForGroups |
Loại:
boolean optional |
isGoodForWatchingSports |
Loại:
boolean optional |
isReservable |
Loại:
boolean optional Liệu một địa điểm có thể đặt chỗ trước hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
location |
Loại:
LatLng optional Vị trí của Địa điểm. |
nationalPhoneNumber |
Loại:
string optional Số điện thoại của Địa điểm, được định dạng theo quy ước theo khu vực của số điện thoại. |
parkingOptions |
Loại:
ParkingOptions optional Các lựa chọn đỗ xe do địa điểm cung cấp. undefined nếu dữ liệu về các lựa chọn đỗ xe chưa được gọi từ máy chủ. |
paymentOptions |
Loại:
PaymentOptions optional Các phương thức thanh toán do địa điểm cung cấp. undefined nếu dữ liệu về phương thức thanh toán chưa được gọi từ máy chủ. |
photos |
Ảnh về địa điểm này. Tập hợp này sẽ chứa tối đa 10 đối tượng Photo . |
plusCode |
Loại:
PlusCode optional |
priceLevel |
Loại:
PriceLevel optional Mức giá của Địa điểm. Thuộc tính này có thể trả về bất kỳ giá trị nào sau đây
|
rating |
Loại:
number optional Điểm xếp hạng từ 1 đến 5, dựa trên bài đánh giá của người dùng về Địa điểm này. |
regularOpeningHours |
Loại:
OpeningHours optional |
requestedLanguage |
Loại:
string optional Ngôn ngữ được yêu cầu cho địa điểm này. |
requestedRegion |
Loại:
string optional Khu vực được yêu cầu cho địa điểm này. |
reviews |
Danh sách bài đánh giá về Địa điểm này. |
servesBeer |
Loại:
boolean optional Liệu địa điểm đó có phục vụ bia hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
servesBreakfast |
Loại:
boolean optional Liệu địa điểm đó có phục vụ bữa sáng hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
servesBrunch |
Loại:
boolean optional Liệu địa điểm đó có phục vụ bữa sáng muộn hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
servesCocktails |
Loại:
boolean optional |
servesCoffee |
Loại:
boolean optional |
servesDessert |
Loại:
boolean optional |
servesDinner |
Loại:
boolean optional Liệu địa điểm đó có phục vụ bữa tối không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
servesLunch |
Loại:
boolean optional Liệu địa điểm đó có phục vụ bữa trưa không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
servesVegetarianFood |
Loại:
boolean optional Liệu địa điểm đó có phục vụ đồ ăn chay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
servesWine |
Loại:
boolean optional Địa điểm có phục vụ rượu vang hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. Trả về "undefined" nếu trường này chưa được yêu cầu. |
svgIconMaskURI |
Loại:
string optional URI đến tài nguyên mặt nạ hình ảnh svg có thể dùng để biểu thị danh mục của một địa điểm. |
types |
Loại:
Array<string> optional Một mảng các loại cho Địa điểm này (ví dụ: ["political", "locality"] hoặc ["restaurant", "establishment"] ). |
userRatingCount |
Loại:
number optional Số lượt xếp hạng của người dùng đã góp phần tạo nên Place.rating của Địa điểm này. |
utcOffsetMinutes |
Loại:
number optional Độ lệch so với giờ UTC của múi giờ hiện tại của Địa điểm, tính bằng phút. Ví dụ: Giờ chuẩn miền Đông Úc (GMT+10) theo giờ mùa hè nhanh hơn 11 giờ so với giờ UTC, vì vậy utc_offset_minutes sẽ là 660 . Đối với các múi giờ chậm hơn giờ UTC, độ lệch sẽ là âm. Ví dụ: utc_offset_minutes là -60 cho Cape Verde. |
viewport |
Loại:
LatLngBounds optional Chế độ xem ưu tiên khi hiển thị Địa điểm này trên bản đồ. |
websiteURI |
Loại:
string optional Trang web có thẩm quyền về Địa điểm này, chẳng hạn như trang chủ của doanh nghiệp. |
|
Loại:
OpeningHours optional |
Phương thức | |
---|---|
fetchFields |
fetchFields(options) Thông số:
|
getNextOpeningTime |
getNextOpeningTime([date]) Thông số:
Tính toán Ngày đại diện cho OpeningHoursTime tiếp theo. Trả về giá trị không xác định nếu không có đủ dữ liệu để tính toán kết quả hoặc địa điểm này không hoạt động. |
isOpen |
isOpen([date]) Thông số:
Giá trị trả về:
Promise<boolean optional> Kiểm tra xem địa điểm có mở cửa vào ngày giờ đã cho hay không. Giải quyết bằng undefined nếu dữ liệu đã biết cho vị trí không đủ để tính toán, ví dụ: nếu giờ mở cửa chưa được đăng ký. |
toJSON |
toJSON() Thông số: Không có
Giá trị trả về:
Object một đối tượng JSON có tất cả các thuộc tính Địa điểm được yêu cầu. |
Giao diện PlaceOptions
Giao diện google.maps.places.PlaceOptions
Các tuỳ chọn để tạo một Địa điểm.
Thuộc tính | |
---|---|
id |
Loại:
string Mã địa điểm duy nhất. |
requestedLanguage optional |
Loại:
string optional Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà thông tin chi tiết sẽ được trả về. Xem danh sách ngôn ngữ được hỗ trợ. |
requestedRegion optional |
Loại:
string optional Mã khu vực của khu vực của người dùng. Điều này có thể ảnh hưởng đến những bức ảnh có thể được trả về và có thể ảnh hưởng đến những thứ khác. Mã khu vực chấp nhận giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD giống với mã ISO 3166-1, ngoại trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" ( .co.uk ) trong khi mã ISO 3166-1 là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Anh và Bắc Ireland"). |
Lớp AccessibilityOptions
Lớp google.maps.places.AccessibilityOptions
Truy cập bằng cách gọi const {AccessibilityOptions} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
hasWheelchairAccessibleEntrance |
Loại:
boolean optional Liệu địa điểm đó có lối vào dành cho xe lăn hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasWheelchairAccessibleParking |
Loại:
boolean optional Địa điểm có chỗ đỗ xe cho xe lăn hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasWheelchairAccessibleRestroom |
Loại:
boolean optional Địa điểm có nhà vệ sinh cho xe lăn hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasWheelchairAccessibleSeating |
Loại:
boolean optional Địa điểm có chỗ ngồi cho xe lăn hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
Lớp AddressComponent
Lớp google.maps.places.AddressComponent
Truy cập bằng cách gọi const {AddressComponent} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
longText |
Loại:
string optional Toàn văn thành phần địa chỉ. |
shortText |
Loại:
string optional Văn bản ngắn, viết tắt của thành phần địa chỉ đã cho. |
types |
Loại:
Array<string> Một mảng các chuỗi biểu thị loại thành phần địa chỉ này. Bạn có thể xem danh sách các loại hợp lệ tại đây. |
Lớp Phân bổ
Lớp google.maps.places.Attribution
Truy cập bằng cách gọi const {Attribution} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
provider |
Loại:
string optional Văn bản ghi công sẽ xuất hiện cho kết quả về Địa điểm này. |
providerURI |
Loại:
string optional |
Giao diện FetchFieldsRequest
Giao diện google.maps.places.FetchFieldsRequest
Các tuỳ chọn để tìm nạp các trường Địa điểm.
Thuộc tính | |
---|---|
fields |
Loại:
Array<string> Danh sách các trường cần tìm nạp. |
Lớp OpeningHours
Lớp google.maps.places.OpeningHours
Truy cập bằng cách gọi const {OpeningHours} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
periods |
Loại:
Array<OpeningHoursPeriod> Khoảng thời gian mở cửa cho mỗi ngày trong tuần, bắt đầu từ Chủ Nhật, theo thứ tự thời gian. Không bao gồm những ngày mà Địa điểm không mở cửa. |
weekdayDescriptions |
Loại:
Array<string> Một mảng gồm 7 chuỗi đại diện cho giờ mở cửa được định dạng cho mỗi ngày trong tuần. Dịch vụ Địa điểm sẽ định dạng và bản địa hoá giờ mở cửa cho phù hợp với ngôn ngữ hiện tại. Thứ tự của các phần tử trong mảng này phụ thuộc vào ngôn ngữ. Một số ngôn ngữ bắt đầu tuần vào thứ Hai, trong khi một số ngôn ngữ khác bắt đầu vào Chủ Nhật. |
Lớp OpeningHoursPeriod
Lớp google.maps.places.OpeningHoursPeriod
Truy cập bằng cách gọi const {OpeningHoursPeriod} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
close |
Loại:
OpeningHoursPoint optional Giờ đóng cửa của Địa điểm. |
open |
Loại:
OpeningHoursPoint Giờ mở cửa của Địa điểm. |
Lớp OpeningHoursPoint
Lớp google.maps.places.OpeningHoursPoint
Truy cập bằng cách gọi const {OpeningHoursPoint} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
day |
Loại:
number Ngày trong tuần, dưới dạng một số trong phạm vi [0, 6], bắt đầu từ Chủ Nhật. Ví dụ: 2 có nghĩa là thứ Ba. |
hour |
Loại:
number Giờ của OpeningHoursPoint.time dưới dạng số, trong phạm vi [0, 23]. Thông tin này sẽ được báo cáo theo múi giờ của Địa điểm. |
minute |
Loại:
number Phút của OpeningHoursPoint.time dưới dạng số, trong khoảng [0, 59]. Thông tin này sẽ được báo cáo theo múi giờ của Địa điểm. |
Lớp ParkingOptions
Lớp google.maps.places.ParkingOptions
Truy cập bằng cách gọi const {ParkingOptions} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
hasFreeGarageParking |
Loại:
boolean optional Liệu địa điểm đó có cung cấp chỗ đỗ xe miễn phí trong gara hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasFreeParkingLot |
Loại:
boolean optional Liệu địa điểm đó có bãi đỗ xe miễn phí hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasFreeStreetParking |
Loại:
boolean optional Liệu địa điểm đó có chỗ đỗ xe miễn phí trên đường không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasPaidGarageParking |
Loại:
boolean optional Liệu địa điểm đó có cung cấp gara đỗ xe có tính phí hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasPaidParkingLot |
Loại:
boolean optional Địa điểm có bãi đỗ xe có tính phí hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasPaidStreetParking |
Loại:
boolean optional Liệu địa điểm đó có cung cấp chỗ đỗ xe có tính phí trên đường hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
hasValetParking |
Loại:
boolean optional Liệu địa điểm đó có cung cấp dịch vụ đỗ xe không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
Lớp PaymentOptions
Lớp google.maps.places.PaymentOptions
Truy cập bằng cách gọi const {PaymentOptions} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
acceptsCashOnly |
Loại:
boolean optional Liệu địa điểm đó có chỉ chấp nhận thanh toán bằng tiền mặt hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
acceptsCreditCards |
Loại:
boolean optional Liệu một địa điểm có chấp nhận thanh toán qua thẻ tín dụng hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
acceptsDebitCards |
Loại:
boolean optional Liệu địa điểm đó có chấp nhận thanh toán qua thẻ ghi nợ hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
acceptsNFC |
Loại:
boolean optional Liệu một địa điểm có chấp nhận thanh toán qua NFC hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "rỗng" nếu không xác định được giá trị. |
Lớp Ảnh
Lớp google.maps.places.Photo
Truy cập bằng cách gọi const {Photo} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
authorAttributions |
Loại:
Array<AuthorAttribution> Văn bản ghi công sẽ xuất hiện cho bức ảnh này. |
heightPx |
Loại:
number Chiều cao của ảnh, tính bằng pixel. |
widthPx |
Loại:
number Chiều rộng của ảnh tính bằng pixel. |
Phương thức | |
---|---|
getURI |
getURI([options]) Thông số:
Giá trị trả về:
string Trả về URL hình ảnh tương ứng với các tuỳ chọn đã chỉ định. |
Lớp AuthorAttribution
Lớp google.maps.places.AuthorAttribution
Truy cập bằng cách gọi const {AuthorAttribution} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
displayName |
Loại:
string Tên tác giả của kết quả này. |
photoURI |
Loại:
string optional URI ảnh của tác giả cho kết quả này. Tính năng này không phải lúc nào cũng có. |
uri |
Loại:
string optional URI hồ sơ của tác giả cho kết quả này. |
Lớp PlusCode
Lớp google.maps.places.PlusCode
Truy cập bằng cách gọi const {PlusCode} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
compoundCode |
Loại:
string optional Mã cộng có diện tích 1/8000 độ theo 1/8000 độ, trong đó 4 ký tự đầu tiên (mã vùng) bị xoá và thay thế bằng nội dung mô tả địa phương. Ví dụ: "9G8F+5W Zurich, Thuỵ Sĩ". |
globalCode |
Loại:
string optional Một mã cộng có diện tích 1/8000 độ theo 1/8000 độ. Ví dụ: "8FVC9G8F+5W". |
Lớp Review (Xem lại)
Lớp google.maps.places.Review
Truy cập bằng cách gọi const {Review} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Thuộc tính | |
---|---|
authorAttribution |
Loại:
AuthorAttribution optional Người đánh giá. |
publishTime |
Loại:
Date optional |
rating |
Loại:
number optional Điểm xếp hạng của bài đánh giá này, một số từ 1 đến 5 (bao gồm cả hai giá trị này). |
relativePublishTimeDescription |
Loại:
string optional Một chuỗi thời gian gần đây được định dạng, thể hiện thời gian đánh giá so với thời gian hiện tại ở dạng phù hợp với ngôn ngữ và quốc gia. Ví dụ: "một tháng trước". |
text |
Loại:
string optional Nội dung bài đánh giá. |
textLanguageCode |
Loại:
string optional Mã ngôn ngữ IETF cho biết ngôn ngữ được dùng trong bài đánh giá này. Xin lưu ý rằng mã này chỉ bao gồm thẻ ngôn ngữ chính mà không có thẻ phụ nào cho biết quốc gia hoặc khu vực. Ví dụ: tất cả bài đánh giá bằng tiếng Anh đều được gắn thẻ là 'en' thay vì "en-AU" hoặc "en-UK". |
Hằng số PriceLevel
Hằng số google.maps.places.PriceLevel
Giá cấp enum cho các đối tượng Địa điểm.
Truy cập bằng cách gọi const {PriceLevel} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Hằng số | |
---|---|
EXPENSIVE |
|
FREE |
|
INEXPENSIVE |
|
MODERATE |
|
VERY_EXPENSIVE |
Giao diện SearchByTextRequest
Giao diện google.maps.places.SearchByTextRequest
Yêu cầu giao diện cho Place.searchByText
.
Thuộc tính | |
---|---|
fields |
Loại:
Array<string> Các trường sẽ được đưa vào phản hồi và sẽ được tính phí. Nếu bạn truyền ['*'] , tất cả các trường có sẵn sẽ được trả về và tính phí (không nên dùng cách này cho các bản triển khai chính thức). Để xem danh sách các 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" ). |
includedType optional |
Loại:
string optional Loại địa điểm được yêu cầu. Danh sách đầy đủ các loại được hỗ trợ: https://developers.google.com/maps/documentation/places/web-service/place-types. Chỉ hỗ trợ một loại được đưa vào. Xem SearchByTextRequest.useStrictTypeFiltering |
isOpenNow optional |
Loại:
boolean optional Mặc định:
false Dùng để giới hạn kết quả tìm kiếm ở những địa điểm hiện đang mở cửa. |
language optional |
Loại:
string optional Thông tin chi tiết về địa điểm sẽ hiển thị bằng ngôn ngữ ưu tiên (nếu có). Sẽ được đặt mặc định theo lựa chọn ngôn ngữ ưu tiên của trình duyệt. Danh sách ngôn ngữ hiện được hỗ trợ: https://developers.google.com/maps/faq#languagesupport. |
locationBias optional |
Loại:
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|CircleLiteral|Circle optional Khu vực cần tìm kiếm. Vị trí này đóng vai trò là độ lệch, tức là kết quả xung quanh vị trí đã cho có thể được trả về. Không thể đặt cùng với locationRestriction. |
locationRestriction optional |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Khu vực cần tìm kiếm. Vị trí này đóng vai trò là một quy tắc hạn chế, tức là hệ thống sẽ không trả về kết quả bên ngoài vị trí đã cho. Không thể đặt cùng với locationBias. |
maxResultCount optional |
Loại:
number optional Số lượng kết quả tối đa cần trả về. Phải nằm trong khoảng từ 1 đến 20. |
minRating optional |
Loại:
number optional Lọc ra những kết quả có điểm xếp hạng trung bình của người dùng thấp hơn giới hạn này. Giá trị hợp lệ phải là số thực từ 0 đến 5 (bao gồm cả hai giá trị này) với tốc độ 0,5, tức là [0, 0,5, 1,0, ... , 5,0]. Điểm xếp hạng đầu vào sẽ được làm tròn lên đến 0,5 gần nhất(giới hạn trên). Ví dụ: điểm xếp hạng 0,6 sẽ loại bỏ tất cả kết quả có điểm xếp hạng dưới 1,0. |
priceLevels optional |
Loại:
Array<PriceLevel> optional Dùng để giới hạn phạm vi tìm kiếm ở những địa điểm được đánh dấu là ở một số mức giá nhất định. Bạn có thể chọn bất kỳ tổ hợp cấp giá nào. Mặc định là tất cả các mức giá. |
|
Loại:
string optional |
|
Loại:
SearchByTextRankPreference optional |
rankPreference optional |
Loại:
SearchByTextRankPreference optional Mặc định:
SearchByTextRankPreference.DISTANCE Cách xếp hạng kết quả trong câu trả lời. |
region optional |
Loại:
string optional Mã quốc gia/khu vực Unicode (CLDR) của vị trí nơi yêu cầu đến. Tham số này dùng để hiển thị thông tin chi tiết về địa điểm, chẳng hạn như tên địa điểm theo khu vực (nếu có). Thông số này có thể ảnh hưởng đến kết quả dựa trên luật hiện hành. Để biết thêm thông tin, hãy xem https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Xin lưu ý rằng mã vùng gồm 3 chữ số hiện không được hỗ trợ. |
textQuery optional |
Loại:
string optional Bắt buộc. Cụm từ tìm kiếm dạng văn bản. |
useStrictTypeFiltering optional |
Loại:
boolean optional Mặc định:
false Dùng để đặt tính năng lọc loại nghiêm ngặt cho SearchByTextRequest.includedType . Nếu bạn đặt giá trị này thành true, thì chỉ những kết quả cùng loại mới được trả về. |
Hằng số SearchByTextRankPreference
Hằng số google.maps.places.SearchByTextRankPreference
Loại enum RankPreference cho SearchByTextRequest.
Truy cập bằng cách gọi const {SearchByTextRankPreference} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Hằng số | |
---|---|
DISTANCE |
Xếp hạng kết quả theo khoảng cách. |
RELEVANCE |
Xếp hạng kết quả theo mức độ liên quan. |
Giao diện SearchNearbyRequest
Giao diện google.maps.places.SearchNearbyRequest
Yêu cầu giao diện cho Place.searchNearby
. Để biết thêm thông tin về yêu cầu này, hãy xem tài liệu tham khảo về API Địa điểm.
Thuộc tính | |
---|---|
fields |
Loại:
Array<string> Các trường sẽ được đưa vào phản hồi và sẽ được tính phí. Nếu bạn truyền ['*'] , tất cả các trường có sẵn sẽ được trả về và tính phí (không nên dùng cách này cho các bản triển khai chính thức). Để xem danh sách các 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" ). |
locationRestriction |
Loại:
Circle|CircleLiteral Khu vực cần tìm kiếm, được chỉ định dưới dạng một hình tròn có tâm và bán kính. Không trả về kết quả bên ngoài vị trí đã cho. |
excludedPrimaryTypes optional |
Loại:
Array<string> optional Loại địa điểm chính bị loại trừ. Xem danh sách đầy đủ các loại được hỗ trợ. Một địa điểm chỉ có thể có một loại chính. Bạn có thể chỉ định tối đa 50 loại. Nếu bạn chỉ định cùng một loại trong cả danh sách included và excluded , thì lỗi INVALID_ARGUMENT sẽ được trả về. |
includedPrimaryTypes optional |
Loại:
Array<string> optional Đã bao gồm loại địa điểm chính. Xem danh sách đầy đủ các loại được hỗ trợ. Một địa điểm chỉ có thể có một loại chính. Bạn có thể chỉ định tối đa 50 loại. Nếu bạn chỉ định cùng một loại trong cả danh sách included và excluded , thì lỗi INVALID_ARGUMENT sẽ được trả về. |
includedTypes optional |
Loại:
Array<string> optional Loại địa điểm được đưa vào. Xem danh sách đầy đủ các loại được hỗ trợ. Một địa điểm có thể có nhiều loại địa điểm. Bạn có thể chỉ định tối đa 50 loại. Nếu bạn chỉ định cùng một loại trong cả danh sách included và excluded , thì lỗi INVALID_ARGUMENT sẽ được trả về. |
language optional |
Loại:
string optional Thông tin chi tiết về địa điểm sẽ hiển thị bằng ngôn ngữ ưu tiên (nếu có). Sẽ được đặt mặc định theo lựa chọn ngôn ngữ ưu tiên của trình duyệt. Danh sách ngôn ngữ hiện được hỗ trợ: https://developers.google.com/maps/faq#languagesupport. |
maxResultCount optional |
Loại:
number optional Số lượng kết quả tối đa cần trả về. Phải nằm trong khoảng từ 1 đến 20. |
rankPreference optional |
Loại:
SearchNearbyRankPreference optional Mặc định:
SearchNearbyRankPreference.DISTANCE Cách xếp hạng kết quả trong câu trả lời. |
region optional |
Loại:
string optional Mã quốc gia/khu vực Unicode (CLDR) của vị trí nơi yêu cầu đến. Tham số này dùng để hiển thị thông tin chi tiết về địa điểm, chẳng hạn như tên địa điểm theo khu vực (nếu có). Thông số này có thể ảnh hưởng đến kết quả dựa trên luật hiện hành. Để biết thêm thông tin, hãy xem https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Xin lưu ý rằng mã vùng gồm 3 chữ số hiện không được hỗ trợ. |
Hằng số SearchNearbyRankPreference
Hằng số google.maps.places.SearchNearbyRankPreference
Loại enum RankPreference cho SearchNearbyRequest.
Truy cập bằng cách gọi const {SearchNearbyRankPreference} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong API Maps JavaScript.
Hằng số | |
---|---|
DISTANCE |
Xếp hạng kết quả theo khoảng cách. |
POPULARITY |
Xếp hạng kết quả theo mức độ phổ biến. |