Place Data

Lớp Place

Lớp google.maps.places.Place

Lớp này triển khai PlaceOptions.

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)
Tham số: 
searchByText
searchByText(request)
Tham số: 
Giá trị trả về:  Promise<{places:Array<Place>}>
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)
Tham số: 
Giá trị trả về:  Promise<{places:Array<Place>}>
Tìm kiếm địa điểm lân cận.
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 lựa 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ỉ đã biết. undefined nếu dữ liệu địa chỉ chưa được gọi từ máy chủ.
adrFormatAddress
Loại:  string optional
Biểu thị địa chỉ của Địa điểm ở định dạng vi mô adr.
allowsDogs
Loại:  boolean optional
attributions
Loại:  Array<Attribution> optional
Nhà cung cấp dữ liệu phải được hiển thị cho Địa điểm.
businessStatus
Loại:  BusinessStatus optional
Trạng thái hoạt động của địa điểm. null nếu không xác định được trạng thái. undefined nếu dữ liệu trạng thái chưa được tải từ máy chủ.
consumerAlert
Loại:  ConsumerAlert optional
Cảnh báo cho người dùng về địa điểm này.
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ủ.
displayNameLanguageCode
Loại:  string optional
Ngôn ngữ của 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
Nội dung tóm tắt của ban biên tập về địa điểm này. null nếu không có bản tóm tắt của ban 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 nội dung tóm tắt của ban biên tập cho địa điểm này. null nếu không có bản tóm tắt của ban biên tập. undefined nếu trường này chưa được yêu cầu.
evChargeAmenitySummary
Loại:  EVChargeAmenitySummary optional
EVChargeAmenitySummary cho địa điểm này.
evChargeOptions
Loại:  EVChargeOptions optional
Các lựa chọn sạc xe điện do địa điểm cung cấp. undefined nếu các lựa chọn sạc xe điện chưa được gọi từ máy chủ.
formattedAddress
Loại:  string optional
Địa chỉ đầy đủ của vị trí.
fuelOptions
Loại:  FuelOptions optional
Các loại nhiên liệu mà địa điểm này cung cấp. undefined nếu các lựa chọn nhiên liệu chưa được gọi từ máy chủ.
generativeSummary
Loại:  GenerativeSummary optional
Bản tóm tắt do AI tạo cho địa điểm này.
googleMapsURI
Loại:  string optional
URL của trang chính thức trên Google cho địa điểm này. Đây là trang do Google sở hữu, chứa thông tin chính xác nhất hiện có 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ả về "null" 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 hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" 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 tại chỗ hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" 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ề "null" 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.
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 ở định dạng quốc tế. Định dạng quốc tế bao gồm mã quốc gia và có dấu cộng (+) ở đầu.
isGoodForChildren
Loại:  boolean optional
isGoodForGroups
Loại:  boolean optional
isGoodForWatchingSports
Loại:  boolean optional
isReservable
Loại:  boolean optional
Địa điểm có cho phép đặt chỗ trước hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" 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 khu vực của số điện thoại.
neighborhoodSummary
Loại:  NeighborhoodSummary optional
NeighborhoodSummary cho địa điểm này.
parkingOptions
Loại:  ParkingOptions optional
Các lựa chọn đỗ xe mà đị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 mà địa điểm này chấp nhận. undefined nếu dữ liệu về các phương thức thanh toán chưa được gọi từ máy chủ.
photos
Loại:  Array<Photo> optional
Ả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
postalAddress
Loại:  PostalAddress 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
priceRange
Loại:  PriceRange optional
Khoảng giá cho Địa điểm này. endPrice có thể không được đặt, cho biết một phạm vi không có giới hạn trên (ví dụ: "Hơn 100 USD").
primaryType
Loại:  string optional
Loại chính của địa điểm. null nếu không có loại. undefined nếu dữ liệu loại chưa được tải từ máy chủ.
primaryTypeDisplayName
Loại:  string optional
Tên hiển thị của loại địa điểm chính. null nếu không có loại. undefined nếu dữ liệu loại chưa được tải từ máy chủ.
primaryTypeDisplayNameLanguageCode
Loại:  string optional
Ngôn ngữ của tên hiển thị loại chính của vị trí. null nếu không có loại. undefined nếu dữ liệu loại chưa được tải từ máy chủ.
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.
resourceName
Loại:  string
Tên tài nguyên duy nhất của địa điểm.
reviews
Loại:  Array<Review> optional
Danh sách bài đánh giá về Địa điểm này.
reviewSummary
Loại:  ReviewSummary optional
ReviewSummary cho địa điểm này.
servesBeer
Loại:  boolean optional
Đị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ề "null" 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
Đị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ề "null" 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
Đị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ề "null" 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
Đị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ả về "null" 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
Đị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ả về "null" 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
Đị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ả về "null" 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ề "null" 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.
shortFormattedAddress
Loại:  string optional
Địa chỉ ngắn của vị trí.
subDestinations
Loại:  Array<Place> optional
Danh sách các điểm đến phụ cho địa điểm này. Điểm đến phụ là những địa điểm cụ thể liên kết với một địa điểm chính. Những điểm đến này cung cấp thông tin cụ thể hơn cho những người dùng đang tìm thông tin trong một địa điểm lớn hoặc phức tạp, chẳng hạn như sân bay, công viên quốc gia, trường đại học hoặc sân vận động.
svgIconMaskURI
Loại:  string optional
URI đến tài nguyên mặt nạ hình ảnh svg có thể dùng để thể hiện danh mục của một địa điểm.
types
Loại:  Array<string> optional
Một mảng loại cho Địa điểm này (ví dụ: ["political", "locality"] hoặc ["restaurant", "establishment"]).
userRatingCount
Loại:  number optional
Số lượng điểm xếp hạng từ 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) trong giờ mùa hè nhanh hơn 11 giờ so với giờ UTC, nên utc_offset_minutes sẽ là 660. Đối với các múi giờ chậm hơn UTC, độ lệch sẽ là số âm. Ví dụ: utc_offset_minutes là -60 cho Cape Verde.
viewport
Loại:  LatLngBounds optional
Khung nhìn ưu tiên khi hiển thị Địa điểm này trên bản đồ.
websiteURI
Loại:  string optional
Trang web chính thức của Địa điểm này, chẳng hạn như trang chủ của một doanh nghiệp.
openingHours
Loại:  OpeningHours optional
hasWiFi
Loại:  boolean optional
fetchFields
fetchFields(options)
Tham số: 
Giá trị trả về:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Tham số: 
  • date:  Date optional
Giá trị trả về:  Promise<Date optional>
Tính Date cho giờ mở cửa tiếp theo bằng cách sử dụng Place.regularOpeningHours của Địa điểm. Trả về giá trị không xác định nếu không có đủ dữ liệu để tính kết quả hoặc địa điểm này không hoạt động.
BetaisOpen
isOpen([date])
Tham số: 
  • date:  Date optional Mặc định là hiện tại.
Giá trị trả về:  Promise<boolean optional>
Kiểm tra xem địa điểm có mở cửa vào Date đã cho hay không. Trả về undefined nếu dữ liệu đã biết về vị trí không đủ để tính toán, ví dụ: nếu giờ mở cửa chưa được đăng ký.
toJSON
toJSON()
Tham 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

google.maps.places.PlaceOptions giao diện

Các lựa chọn để tạo một Địa điểm.

id optional
Loại:  string optional
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 người dùng. Điều này có thể ảnh hưởng đến những bức ảnh được trả về và có thể là những nội dung 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 các mã ccTLD đều 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 của quốc gia này là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Liên hiệp Anh và Bắc Ireland").
resourceName optional
Loại:  string optional
Tên tài nguyên duy nhất của địa điểm.

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

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ả về "null" nếu không xác định được giá trị.
hasWheelchairAccessibleParking
Loại:  boolean optional
Địa điểm có bãi đỗ xe dành cho xe lăn hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" nếu không xác định được giá trị.
hasWheelchairAccessibleRestroom
Loại:  boolean optional
Địa điểm có nhà vệ sinh phù hợp cho xe lăn hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" 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ề "null" nếu không xác định được giá trị.

Lớp AddressComponent

Lớp google.maps.places.AddressComponent

Thành phần địa chỉ cho vị trí của Địa điểm.

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
Toàn văn của 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 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 Attribution

Lớp google.maps.places.Attribution

Thông tin về nhà cung cấp dữ liệu cho một Địa điểm.

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
Tên của nhà cung cấp dữ liệu về Địa điểm.
providerURI
Loại:  string optional
URI đến nhà cung cấp dữ liệu của Địa điểm.

Lớp AuthorAttribution

Lớp google.maps.places.AuthorAttribution

Thông tin về tác giả của nội dung do người dùng tạo.

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

Lớp ConnectorAggregation

Lớp google.maps.places.ConnectorAggregation

Thông tin về việc sạc xe điện, được tổng hợp cho các đầu nối cùng loại và cùng tốc độ sạc.

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

availabilityLastUpdateTime
Loại:  Date optional
Thời điểm thông tin về tình trạng hoạt động của trạm sạc trong dữ liệu tổng hợp này được cập nhật gần đây nhất.
availableCount
Loại:  number optional
Số lượng trình kết nối trong dữ liệu tổng hợp này hiện có sẵn.
count
Loại:  number
Số lượng đầu nối trong dữ liệu tổng hợp này.
maxChargeRateKw
Loại:  number
Tốc độ sạc tối đa tĩnh (tính bằng kW) của mỗi đầu nối trong dữ liệu tổng hợp.
outOfServiceCount
Loại:  number optional
Số lượng đầu nối trong dữ liệu tổng hợp này hiện không hoạt động.
type
Loại:  EVConnectorType optional
Loại trình kết nối của dữ liệu tổng hợp này.

Lớp ConsumerAlert

Lớp google.maps.places.ConsumerAlert

Thông báo cảnh báo cho người dùng. Tất cả văn bản đều được hiển thị bằng ngôn ngữ được chỉ định trong trường languageCode.

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

details
Loại:  ConsumerAlertDetails optional
Thông tin chi tiết về thông báo cảnh báo người dùng.
languageCode
Loại:  string optional
Mã ngôn ngữ của thông báo cảnh báo cho người dùng.
overview
Loại:  string optional
Thông tin tổng quan về thông báo cảnh báo cho người dùng.

Lớp ConsumerAlertDetails

Lớp google.maps.places.ConsumerAlertDetails

Thông tin chi tiết về thông báo cảnh báo cho người dùng.

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

aboutLinkTitle
Loại:  string optional
Tiêu đề hiển thị cho một đường liên kết để cung cấp thêm thông tin.
aboutLinkURI
Loại:  string optional
URI của đường liên kết để cung cấp thêm thông tin.
description
Loại:  string optional
Nội dung mô tả thông báo cảnh báo cho người dùng.
title
Loại:  string optional
Tiêu đề hiển thị cùng với nội dung mô tả chi tiết.

Lớp ContentBlock

Lớp google.maps.places.ContentBlock

ContentBlock mô tả nội dung của một bản tóm tắt và nguồn gốc của bản tóm tắt đó.

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

content
Loại:  string optional
Nội dung liên quan đến chủ đề.
contentLanguageCode
Loại:  string optional
Mã ngôn ngữ của nội dung.
referencedPlaces
Loại:  Array<Place>
Danh sách Place được tham chiếu. Khi được truy xuất lần đầu, mỗi Địa điểm chỉ chứa một mã địa điểm trong trường id.

Lớp EVChargeAmenitySummary

Lớp google.maps.places.EVChargeAmenitySummary

Bản tóm tắt do AI tạo về các tiện nghi gần trạm sạc xe điện. Điều này chỉ áp dụng cho những địa điểm có loại electric_vehicle_charging_station.

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

coffee
Loại:  ContentBlock optional
Thông tin tóm tắt về các quán cà phê gần đó.
disclosureText
Loại:  string optional
Văn bản cho thông tin công bố liên quan đến bản tóm tắt này.
disclosureTextLanguageCode
Loại:  string optional
Mã ngôn ngữ của văn bản công bố.
flagContentURI
Loại:  string optional
URI để báo cáo vấn đề về bản tóm tắt.
overview
Loại:  ContentBlock optional
Thông tin tổng quan về các tiện nghi hiện có.
restaurant
Loại:  ContentBlock optional
Bản tóm tắt về các nhà hàng gần đó.
store
Loại:  ContentBlock optional
Tóm tắt về các cửa hàng gần đây.

Lớp EVChargeOptions

Lớp google.maps.places.EVChargeOptions

Thông tin về trạm sạc xe điện tại địa điểm đó.

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

connectorAggregations
Danh sách các nhóm đầu nối sạc xe điện chứa các đầu nối có cùng loại và cùng tốc độ sạc.
connectorCount
Loại:  number
Số lượng đầu cắm tại trạm này. Vì một số cổng có thể có nhiều đầu cắm nhưng chỉ có thể sạc cho một ô tô tại một thời điểm, nên số lượng đầu cắm có thể lớn hơn tổng số ô tô có thể sạc cùng lúc.

Hằng số EVConnectorType

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

Các loại đầu nối sạc xe điện.

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

CCS_COMBO_1 Hệ thống sạc kết hợp (AC và DC). Dựa trên đầu nối SAE Type-1 J-1772.
CCS_COMBO_2 Hệ thống sạc kết hợp (AC và DC). Dựa trên đầu nối Mennekes Loại 2.
CHADEMO Đầu nối loại CHAdeMO.
J1772 Giắc cắm J1772 loại 1.
NACS Hệ thống sạc Bắc Mỹ (NACS), được tiêu chuẩn hoá theo SAE J3400.
OTHER Các loại đầu nối khác.
TESLA Trình kết nối TESLA chung. Đây là NACS ở Bắc Mỹ nhưng có thể không phải là NACS ở các khu vực khác trên thế giới (ví dụ: CCS Combo 2 (CCS2) hoặc GB/T). Giá trị này ít thể hiện loại giắc cắm thực tế hơn, mà chủ yếu thể hiện khả năng sạc xe mang thương hiệu Tesla tại trạm sạc do Tesla sở hữu.
TYPE_2 Đầu nối IEC 62196 loại 2. Thường được gọi là MENNEKES.
UNSPECIFIED_GB_T Loại GB/T tương ứng với tiêu chuẩn GB/T ở Trung Quốc. Loại này bao gồm tất cả các loại GB_T.
UNSPECIFIED_WALL_OUTLET Ổ cắm trên tường không xác định.

Giao diện EVSearchOptions

google.maps.places.EVSearchOptions giao diện

Các lựa chọn liên quan đến xe điện có thể được chỉ định cho một yêu cầu tìm kiếm địa điểm.

connectorTypes optional
Loại:  Array<EVConnectorType> optional
Danh sách các loại giắc cắm xe điện ưu tiên. Địa điểm không hỗ trợ bất kỳ loại đầu nối nào trong danh sách sẽ bị lọc ra.
minimumChargingRateKw optional
Loại:  number optional
Tốc độ sạc tối thiểu cần thiết (tính bằng kilowatt). Địa điểm có tốc độ sạc thấp hơn tốc độ đã chỉ định sẽ bị lọc ra.

Giao diện FetchFieldsRequest

google.maps.places.FetchFieldsRequest giao diện

Các lựa chọn để tìm nạp trường Địa điểm.

fields
Loại:  Array<string>
Danh sách các trường cần tìm nạp.

Lớp FuelOptions

Lớp google.maps.places.FuelOptions

Thông tin mới nhất về các loại nhiên liệu tại một trạm xăng. Thông tin này được cập nhật thường xuyên.

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

fuelPrices
Loại:  Array<FuelPrice>
Danh sách giá nhiên liệu cho từng loại nhiên liệu mà trạm này có, mỗi loại nhiên liệu có một mục.

Lớp FuelPrice

Lớp google.maps.places.FuelPrice

Thông tin về giá nhiên liệu cho một loại nhiên liệu nhất định.

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

price
Loại:  Money optional
Giá nhiên liệu.
type
Loại:  FuelType optional
Loại nhiên liệu.
updateTime
Loại:  Date optional
Thời gian cập nhật giá nhiên liệu gần đây nhất.

Hằng số FuelType

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

Loại nhiên liệu.

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

BIO_DIESEL Dầu diesel sinh học.
DIESEL Nhiên liệu diesel.
DIESEL_PLUS Nhiên liệu diesel plus.
E100 E 100.
E80 E 80.
E85 E 85.
LPG LPG.
METHANE Khí methane.
MIDGRADE Loại trung.
PREMIUM Premium.
REGULAR_UNLEADED Xăng không chì thông thường.
SP100 SP 100.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
TRUCK_DIESEL Dầu diesel cho xe tải.

Lớp GenerativeSummary

Lớp google.maps.places.GenerativeSummary

Bản tóm tắt do AI tạo về địa điểm.

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

disclosureText
Loại:  string optional
Văn bản cho thông tin công bố liên quan đến bản tóm tắt này.
disclosureTextLanguageCode
Loại:  string optional
Mã ngôn ngữ của văn bản công bố.
flagContentURI
Loại:  string optional
URI để báo cáo vấn đề về bản tóm tắt.
overview
Loại:  string optional
Thông tin tổng quan về địa điểm.
overviewLanguageCode
Loại:  string optional
Mã ngôn ngữ của bản tổng quan.

Lớp google.maps.places.GoogleMapsLinks

Đường liên kết để kích hoạt các hành động khác nhau trên Google Maps.

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

directionsURI
Loại:  string optional
Đường liên kết để xem đường đi đến địa điểm đó trên Google Maps. Đường liên kết này chỉ điền sẵn vị trí điểm đến và sử dụng phương thức di chuyển mặc định DRIVE.
photosURI
Loại:  string optional
Đường liên kết để xem ảnh của địa điểm trên Google Maps.
placeURI
Loại:  string optional
Đường liên kết để hiển thị địa điểm trên Google Maps.
reviewsURI
Loại:  string optional
Đường liên kết để xem các bài đánh giá về địa điểm trên Google Maps.
writeAReviewURI
Loại:  string optional
Đường liên kết để viết bài đánh giá về địa điểm đó trên Google Maps.

Lớp Money

Lớp google.maps.places.Money

Biểu thị số tiền cùng với loại đơn vị tiền tệ.

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

currencyCode
Loại:  string
Mã tiền tệ gồm 3 chữ cái, được xác định theo tiêu chuẩn ISO 4217.
nanos
Loại:  number
Số đơn vị nano (10^-9) của số tiền.
units
Loại:  number
Đơn vị nguyên của số tiền. Ví dụ: nếu Money.currencyCode là "USD", thì 1 đơn vị là 1 đô la Mỹ.
toString
toString()
Tham số:  Không có
Giá trị trả về:  string
Trả về một giá trị con người có thể đọc được, thể hiện số tiền kèm theo ký hiệu tiền tệ.

Lớp NeighborhoodSummary

Lớp google.maps.places.NeighborhoodSummary

Bản tóm tắt do AI tạo về các địa điểm yêu thích gần địa điểm này.

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

description
Loại:  ContentBlock optional
Nội dung mô tả chi tiết về khu vực lân cận.
disclosureText
Loại:  string optional
Văn bản cho thông tin công bố liên quan đến bản tóm tắt này.
disclosureTextLanguageCode
Loại:  string optional
Mã ngôn ngữ của văn bản công bố.
flagContentURI
Loại:  string optional
URI để báo cáo vấn đề về bản tóm tắt.
overview
Loại:  ContentBlock optional
Tổng quan về khu vực lân cận.

Lớp OpeningHours

Lớp google.maps.places.OpeningHours

Thông tin về giờ hoạt động của một Địa điểm.

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
Giờ 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

Khoảng thời gian Địa điểm mở cửa.

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
Giờ mở cửa của Địa điểm.

Lớp OpeningHoursPoint

Lớp google.maps.places.OpeningHoursPoint

Thời điểm mà Địa điểm thay đổi tình trạng mở cửa.

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 OpeningHoursPoint.time dưới dạng số, trong khoảng [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 Thư viện trong API JavaScript của Maps.

hasFreeGarageParking
Loại:  boolean optional
Đị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ề "null" nếu không xác định được giá trị.
hasFreeParkingLot
Loại:  boolean optional
Đị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ề "null" nếu không xác định được giá trị.
hasFreeStreetParking
Loại:  boolean optional
Liệu một địa điểm có chỗ đỗ xe miễn phí trên đường hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" nếu không xác định được giá trị.
hasPaidGarageParking
Loại:  boolean optional
Địa điểm có gara đỗ xe có tính phí hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" 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ề "null" nếu không xác định được giá trị.
hasPaidStreetParking
Loại:  boolean optional
Liệu một địa điểm có chỗ đỗ xe trên đường có tính phí hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" nếu không xác định được giá trị.
hasValetParking
Loại:  boolean optional
Địa điểm có dịch vụ hỗ trợ đỗ xe hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" 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 Thư viện trong API JavaScript của Maps.

acceptsCashOnly
Loại:  boolean optional
Liệu một địa điểm 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ề "null" nếu không xác định được giá trị.
acceptsCreditCards
Loại:  boolean optional
Địa điểm có chấp nhận thanh toán bằng thẻ tín dụng hay không. Trả về "true" hoặc "false" nếu biết giá trị. Trả về "null" nếu không xác định được giá trị.
acceptsDebitCards
Loại:  boolean optional
Đị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ề "null" 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ề "null" nếu không xác định được giá trị.

Lớp Photo

Lớp google.maps.places.Photo

Thông tin về ảnh của một Địa điểm.

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 ghi công sẽ hiển thị cho ảnh này.
flagContentURI
Loại:  string optional
Đường liên kết mà người dùng có thể dùng để gắn cờ báo cáo vấn đề về ảnh.
googleMapsURI
Loại:  string optional
Một đường liên kết để hiển thị ảnh trên Google Maps.
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.
getURI
getURI([options])
Tham số: 
Giá trị trả về:  string
Trả về URL hình ảnh tương ứng với các lựa chọn đã chỉ định.

Lớp PlusCode

Lớp google.maps.places.PlusCode

Plus Code cho Địa điểm. Hãy xem https://plus.codes/ để biết thêm thông tin.

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
Plus Code có diện tích 1/8000 độ x 1/8000 độ, trong đó bốn ký tự đầu tiên (mã vùng) được bỏ qua và thay thế bằng nội dung mô tả địa phương. Ví dụ: "9G8F+5W Zurich, Switzerland".
globalCode
Loại:  string optional
Mã Plus Code có diện tích 1/8000 độ x 1/8000 độ. Ví dụ: "8FVC9G8F+5W".

Lớp PostalAddress

Lớp google.maps.places.PostalAddress

Đại diện cho một địa chỉ bưu chính (ví dụ: địa chỉ để dịch vụ bưu chính giao hàng đến). Lưu ý: JavaScript API sử dụng PostalAddress để tạo thực thể cho các đối tượng đại diện cho dữ liệu do Dịch vụ web trả về.

Lớp này triển khai PostalAddressLiteral.

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

addressLines
Loại:  Array<string>
Các dòng địa chỉ không có cấu trúc mô tả các cấp thấp hơn của một địa chỉ.
administrativeArea
Loại:  string optional
Phân khu hành chính cao nhất được dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực.
languageCode
Loại:  string optional
Mã ngôn ngữ BCP-47 của nội dung trong địa chỉ này. Ví dụ: "zh-Hant", "ja", "ja-Latn", "en".
locality
Loại:  string optional
Thường là phần thành phố/thị trấn của địa chỉ.
organization
Loại:  string optional
Tên của tổ chức tại địa chỉ này.
postalCode
Loại:  string optional
Mã bưu chính của địa chỉ.
recipients
Loại:  Array<string>
Người nhận tại địa chỉ.
regionCode
Loại:  string
Mã vùng CLDR của quốc gia/khu vực của địa chỉ. Ví dụ: "CH" cho Thuỵ Sĩ. Hãy xem https://cldr.unicode.org/ và https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin chi tiết.
sortingCode
Loại:  string optional
Mã ngân hàng của địa chỉ.
sublocality
Loại:  string optional
Khu vực nhỏ của địa chỉ, chẳng hạn như khu phố, quận hoặc huyện.

Giao diện PostalAddressLiteral

google.maps.places.PostalAddressLiteral giao diện

Dữ liệu để điền vào PostalAddress.

regionCode
Loại:  string
addressLines optional
Loại:  Iterable<string> optional
administrativeArea optional
Loại:  string optional
languageCode optional
Loại:  string optional
locality optional
Loại:  string optional
Vui lòng xem PostalAddress.locality.
organization optional
Loại:  string optional
postalCode optional
Loại:  string optional
recipients optional
Loại:  Iterable<string> optional
sortingCode optional
Loại:  string optional
sublocality optional
Loại:  string optional

Hằng số PriceLevel

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

Mức giá của một Đị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

Lớp PriceRange

Lớp google.maps.places.PriceRange

Khoảng giá liên kết với một Địa điểm. endPrice có thể không được đặt, cho biết một phạm vi không có giới hạn trên (ví dụ: "Hơn 100 USD").

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

endPrice
Loại:  Money optional
Mức giá cao nhất trong khoảng giá (bao gồm cả mức giá này). Giá phải thấp hơn số tiền này.
startPrice
Loại:  Money
Mức thấp nhất của khoảng giá (bao gồm cả mức này). Giá phải bằng hoặc cao hơn số tiền này.

Xem lại lớp

Lớp google.maps.places.Review

Thông tin về bài đánh giá một Địa điểm.

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á.
flagContentURI
Loại:  string optional
Đường liên kết để người dùng có thể gắn cờ báo cáo vấn đề về bài đánh giá.
googleMapsURI
Loại:  string optional
Đường liên kết để xem bài đánh giá trên Google Maps.
originalText
Loại:  string optional
Văn bản bài đánh giá bằng ngôn ngữ gốc.
originalTextLanguageCode
Loại:  string optional
Mã ngôn ngữ IETF cho biết ngôn ngữ gốc của bà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,0 đến 5,0 (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 theo biểu mẫu 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
Văn bản đã bản địa hoá của bài đánh giá.
textLanguageCode
Loại:  string optional
Mã ngôn ngữ IETF cho biết ngôn ngữ bản địa hoá của bài đánh giá.
visitDateMonth
Loại:  number optional
Tháng của ngày mà tác giả bài đánh giá ghé thăm địa điểm. Trường này bắt đầu từ 0; 0 là tháng 1 và 11 là tháng 12.
visitDateYear
Loại:  number optional
Năm mà tác giả bài đánh giá ghé thăm địa điểm.

Lớp ReviewSummary

Lớp google.maps.places.ReviewSummary

Bản tóm tắt do AI tạo về bài đánh giá của người dùng về địa điểm.

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

disclosureText
Loại:  string optional
Văn bản cho thông tin công bố liên quan đến bản tóm tắt này.
disclosureTextLanguageCode
Loại:  string optional
Mã ngôn ngữ của văn bản công bố.
flagContentURI
Loại:  string optional
URI để báo cáo vấn đề về bản tóm tắt.
reviewsURI
Loại:  string optional
URI để hiển thị các bài đánh giá về địa điểm này trên Google Maps.
text
Loại:  string optional
Bản tóm tắt bài đánh giá của người dùng.
textLanguageCode
Loại:  string optional
Mã ngôn ngữ của bản tóm tắt bài đánh giá của người dùng.

Giao diện SearchByTextRequest

google.maps.places.SearchByTextRequest giao diện

Giao diện yêu cầu cho Place.searchByText.

fields
Loại:  Array<string>
Các trường cần đưa vào phản hồi, sẽ được tính phí. Nếu bạn truyền ['*'] vào, thì tất cả các trường có sẵn sẽ được trả về và tính phí (bạn không nên làm như vậy khi triển khai chính thức). Bạn có thể yêu cầu bất kỳ thuộc tính nào trong lớp Place dưới dạng một trường.
evSearchOptions optional
Loại:  EVSearchOptions optional
Các lựa chọn liên quan đến xe điện có thể được chỉ định cho một yêu cầu tìm kiếm địa điểm.
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 bao gồm. 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ẽ được hiển thị bằng ngôn ngữ ưu tiên (nếu có). Ngôn ngữ mặc định sẽ là 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
Khu vực cần tìm kiếm. Vị trí này đóng vai trò là một thiên kiến, 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
Khu vực cần tìm kiếm. Vị trí này đóng vai trò là một quy định 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ề. Giá trị 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 từ người dùng trung bình thấp hơn giới hạn này. Giá trị hợp lệ phải là một số thực từ 0 đến 5 (bao gồm cả 0 và 5) với khoảng cách là 0,5, tức là [0, 0,5, 1,0, ... , 5,0] (bao gồm cả 0 và 5). Điểm xếp hạng đầu vào sẽ được làm tròn lên đến 0,5 gần nhất(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.
priceLevels optional
Loại:  Array<PriceLevel> optional
Dùng để giới hạn kết quả tìm kiếm ở những địa điểm được đánh dấu là có mức giá nhất định. Bạn có thể chọn bất kỳ kiểu kết hợp mức giá nào. Mặc định là tất cả các mức giá.
query optional
Loại:  string optional
BetarankBy optional
Loại:  SearchByTextRankPreference optional
rankPreference optional
Loại:  SearchByTextRankPreference optional
Mặc định: SearchByTextRankPreference.RELEVANCE
Cách xếp hạng kết quả trong phản hồ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 được gửi đến. Tham số này được dùng để hiển thị Place Details, chẳng hạn như tên địa điểm theo khu vực cụ thể (nếu có). Tham 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 chưa được hỗ trợ.
textQuery optional
Loại:  string optional
Bắt buộc khi bạn không sử dụng SearchByTextRequest.query. Cụm từ tìm kiếm dạng văn bản để tìm kiếm văn bản.
useStrictTypeFiltering optional
Loại:  boolean optional
Mặc định: false
Dùng để đặt bộ lọc loại nghiêm ngặt cho SearchByTextRequest.includedType. Nếu bạn đặt thành true, thì chỉ những kết quả có cùng loại mới được trả về.

Hằng số SearchByTextRankPreference

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

Enum RankPreference cho SearchByTextRequest.

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

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

google.maps.places.SearchNearbyRequest giao diện

Giao diện yêu cầu cho Place.searchNearby. Để biết thêm thông tin về yêu cầu, hãy xem Tài liệu tham khảo về API Địa điểm.

fields
Loại:  Array<string>
Các trường cần đưa vào phản hồi, sẽ được tính phí. Nếu bạn truyền ['*'] vào, thì tất cả các trường có sẵn sẽ được trả về và tính phí (bạn không nên làm như vậy khi triển khai chính thức). Bạn có thể yêu cầu bất kỳ thuộc tính nào trong lớp Place dưới dạng một trường.
locationRestriction
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. Kết quả bên ngoài vị trí đã cho sẽ không được trả về.
excludedPrimaryTypes optional
Loại:  Array<string> optional
Các 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ì hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
excludedTypes optional
Loại:  Array<string> optional
Các loại địa điểm bị loại trừ. 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ì hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
includedPrimaryTypes optional
Loại:  Array<string> optional
Các loại địa điểm chính được đưa vào. 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ì hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
includedTypes optional
Loại:  Array<string> optional
Các 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ì hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
language optional
Loại:  string optional
Thông tin chi tiết về địa điểm sẽ được hiển thị bằng ngôn ngữ ưu tiên (nếu có). Ngôn ngữ mặc định sẽ là 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ề. Để biết các giá trị được chấp nhận và giá trị mặc định, hãy xem Tài liệu tham khảo API Địa điểm.
rankPreference optional
Loại:  SearchNearbyRankPreference optional
Mặc định: SearchNearbyRankPreference.POPULARITY
Cách xếp hạng kết quả trong phản hồ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 được gửi đến. Tham số này được dùng để hiển thị Place Details, chẳng hạn như tên địa điểm theo khu vực cụ thể (nếu có). Tham 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 chưa được hỗ trợ.

Hằng số SearchNearbyRankPreference

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

Enum RankPreference cho SearchNearbyRequest.

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

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.