Place (beta)

Place

Lớp google.maps.places.Place

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

Place
Place(options)
Thông số: 
BetafindPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
Thông số: 
Giá trị trả về:  Promise<{places:Array<Place>}>
Tìm kiếm địa điểm dựa trên số điện thoại đã cho. Trả về một mảng do một số ít trường hợp có thể chia sẻ cùng một số điện thoại.
BetafindPlaceFromQuery
findPlaceFromQuery(request)
Thông số: 
Giá trị trả về:  Promise<{places:Array<Place>}>
Tìm kiếm địa điểm dựa trên truy vấn văn bản đã cho. Trả về một mảng do truy vấn không rõ ràng, và nhiều vị trí được trả về. Phương pháp này không dành cho những lượt tìm kiếm dự kiến có nhiều kết quả.
addressComponents
Loại:  Array<AddressComponent> optional
Tập hợp các thành phần của đị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ỉ đã biết. undefined nếu dữ liệu địa chỉ chưa được gọi từ máy chủ.
adrFormatAddress
Loại:  string optional
Phần trình bày địa chỉ của Địa điểm trong vi định dạng gần đúng.
attributions
Loại:  Array<Attribution> optional
Văn bản thuộc tính được hiển thị cho kết quả Địa điểm này.
businessStatus
Loại:  BusinessStatus optional
Trạng thái hoạt động của vị trí. null nếu không có trạng thái đã biết nào. 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ủ.
formattedAddress
Loại:  string optional
Địa chỉ đầy đủ của các vị trí.
googleMapsURI
Loại:  string optional
URL của trang chính thức của Google cho địa điểm này. Đây là trang của Google có chứa thông tin sẵn có tốt nhất về Địa điểm.
hasCurbsidePickup
Loại:  boolean optional
Địa điểm có 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ả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
hasDelivery
Loại:  boolean optional
Cho dù địa điểm có giao hàng hay không. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
hasDineIn
Loại:  boolean optional
Cho dù địa điểm đã dùng bữa hay chưa. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
hasTakeout
Loại:  boolean optional
Cho dù đị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ả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
hasWheelchairAccessibleEntrance
Loại:  boolean optional
Đị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ả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
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
Id địa điểm duy nhất.
internationalPhoneNumber
Loại:  string optional
Số điện thoại của Địa điểm ở đị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 (+).
isReservable
Loại:  boolean optional
Địa điểm có thể đặt trước hay không. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' 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 khu vực của số.
openingHours
Loại:  OpeningHours optional
photos
Loại:  Array<Photo> optional
Ảnh về Địa điểm này. Bộ sưu tập sẽ chứa tối đa mười đố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
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Loại:  number optional
Xếp hạng, từ 1,0 đến 5,0, dựa trên đánh giá của người dùng về Địa điểm này.
requestedLanguage
Loại:  string optional
Ngôn ngữ được yêu cầu cho địa điểm này.
requestedRegion
Loại:  string optional
Vùng được yêu cầu cho địa điểm này.
reviews
Loại:  Array<Review> optional
Danh sách bài đánh giá về Địa điểm này.
servesBeer
Loại:  boolean optional
Cho dù địa điểm có phục vụ bia hay không. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
servesBreakfast
Loại:  boolean optional
Cho dù đị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ả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
servesBrunch
Loại:  boolean optional
Cho dù địa điểm có phục vụ bữa nửa buổi hay không. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
servesDinner
Loại:  boolean optional
Cho dù địa điểm có phục vụ bữa tối hay không. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
servesLunch
Loại:  boolean optional
Cho dù địa điểm có phục vụ bữa trưa hay không. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
servesVegetarianFood
Loại:  boolean optional
Cho dù địa điểm có phục vụ đồ ăn chay hay không. Trả về 'true' hoặc 'false' nếu biết giá trị. Trả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' nếu trường này chưa được yêu cầu.
servesWine
Loại:  boolean optional
Cho dù đị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ả lại 'null' nếu giá trị không xác định. Trả lại 'không xác định' 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 để đại diện cho danh mục của một địa điểm.
types
Loại:  Array<string> optional
Một loạt 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 đã đóng góp vào Place.rating của Địa điểm này.
utcOffsetMinutes
Loại:  number optional
Chênh lệch so với giờ UTC theo 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 Áo (GMT+10) tiết kiệm ánh sáng ban ngày trước giờ UTC 11 giờ nên utc_offset_minutes sẽ là 660. Đối với múi giờ phía sau UTC, độ lệch là âm. Ví dụ: utc_offset_minutes-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ó căn cứ cho Địa điểm này, chẳng hạn như trang chủ của doanh nghiệp.
BetafetchFields
fetchFields(options)
Thông số: 
Giá trị trả về:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Thông số: 
  • dateDate optional
Giá trị trả về:  Promise<Date optional>
Tính toán Ngày tháng đại diện cho Giờ mở cửa tiếp theo. Trả về giá trị không xác định nếu dữ liệu không đủ để tính kết quả hoặc vị trí này không hoạt động.
BetaisOpen
isOpen([date])
Thông số: 
  • dateDate optional Mặc định là bây giờ.
Giá trị trả về:  Promise<boolean optional>
Kiểm tra xem địa điểm có mở cửa tại ngày giờ đã định hay không. Phân giải bằng undefined nếu dữ liệu đã biết cho vị trí không đủ để tính toán trường hợp này, 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 đối tượng JSON với tất cả các thuộc tính Địa điểm được yêu cầu.

PlaceOptions

Giao diện google.maps.places.PlaceOptions

Tùy chọn để xây dựng Địa điểm.

id
Loại:  string
Id đị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à chi tiết sẽ được trả về. Xem danh sách các ngôn ngữ được hỗ trợ.
requestedRegion optional
Loại:  string optional
Mã vùng của khu vực của người dùng. Điều này có thể ảnh hưởng đến việc trả lại ảnh và có thể ảnh hưởng đến những nội dung khác. Mã vùng chấp nhận giá trị hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đề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 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à pháp nhân "Vương quốc Anh và Bắc Ireland").

AddressComponent

Lớp google.maps.places.AddressComponent

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

longText
Loại:  string optional
Văn bản đầy đủ của thành phần địa chỉ.
shortText
Loại:  string optional
Văn bản ngắn gọ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.

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 Thư viện trong API JavaScript của Maps.

provider
Loại:  string optional
Văn bản thuộc tính được hiển thị cho kết quả Địa điểm này.
providerURI
Loại:  string optional

Giao diện FetchFieldsRequest

Giao diện google.maps.places.FetchFieldsRequest

Tùy chọn tìm nạp trường Địa điểm.

fields
Loại:  Array<string>
Danh sách trường cần tìm nạp.
sessionToken optional
Loại:  AutocompleteSessionToken optional
Tham chiếu duy nhất dùng để gói yêu cầu chi tiết với một phiên tự động hoàn thành.

Lớp ỞGiờ

Lớp google.maps.places.OpeningHours

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

periods
Khoảng thời gian mở cửa bao gồm tất cả các ngày trong tuần, bắt đầu từ Chủ Nhật, theo trình tự thời gian. Không bao gồm các ngày mà Địa điểm không mở cửa.
weekdayDescriptions
Loại:  Array<string>
Mảng gồm bảy 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 hóa giờ mở cửa phù hợp cho 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 các ngày trong tuần vào Thứ Hai, trong khi các 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 Thư viện trong API JavaScript của Maps.

close
Loại:  OpeningHoursPoint optional
Giờ đóng cửa của Địa điểm.
open
Thời gian mở 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 Thư viện trong API JavaScript của Maps.

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 nghĩa là Thứ Ba.
hour
Loại:  number
Giờ của số Giờ mở Mở.Thời gian dưới dạng số, trong phạm vi [0, 23]. Điều 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 Giờ khai trương.Dưới dạng một số, trong phạm vi [0, 59]. Điều này sẽ được báo cáo theo múi giờ của Địa điểm.

Lớp học về Ảnh

Lớp google.maps.places.Photo

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

authorAttributions
Văn bản thuộc tính được hiển thị cho ả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 bằng pixel.
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.

AuthorAttribution

Lớp google.maps.places.AuthorAttribution

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

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. Không phải lúc nào bạn cũng có thể sử dụng tính năng này.
uri
Loại:  string optional
URI hồ sơ của tác giả cho kết quả này.

PlusCode

Lớp google.maps.places.PlusCode

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

compoundCode
Loại:  string optional
Ví dụ: "9G8F+5W Zurich, Thụy Sĩ".
globalCode
Loại:  string optional
Mã cộng với 1/8000 của bằng 1/8000 của khu vực bằng cấp. Ví dụ: "8FVC9G8F + 5W".

Xem lại lớp

Lớp google.maps.places.Review

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

authorAttribution
Loại:  AuthorAttribution optional
Người đánh giá.
publishTime
Loại:  Date optional
rating
Loại:  number optional
Xếp hạng của bài đánh giá này, từ 1,0 đến 5,0 (bao gồm).
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 xem xét liên quan đến thời gian hiện tại ở dạng thích hợp cho ngôn ngữ và quốc gia. Ví dụ: `"một tháng trước"'.
text
Loại:  string optional
Văn bản đánh giá.
textLanguageCode
Loại:  string optional
Mã ngôn ngữ IETF cho biết ngôn ngữ viết bài đánh giá này. Lưu ý rằng mã này chỉ bao gồm thẻ ngôn ngữ chính mà không có bất kỳ thẻ phụ nào cho biết quốc gia hoặc vùng. Ví dụ: tất cả các bài đánh giá bằng tiếng Anh được gắn thẻ 'en' thay vì 'en-AU' hoặc 'en-UK'.

Hằng số PriceLevel

hằng số google.maps.places.PriceLevel

Enum cấp giá cho các đối tượng Place (Địa điểm).

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

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE