Lớp PlaceService
Lớp google.maps.places.PlacesService
Chứa các phương thức liên quan đến tìm kiếm địa điểm và truy xuất thông tin chi tiết về một địa điểm.
Truy cập bằng cách gọi const {PlacesService} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
PlacesService |
PlacesService(attrContainer) Thông số:
Tạo một thực thể mới của PlacesService hiển thị các thuộc tính trong vùng chứa được chỉ định. |
Phương pháp | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Thông số:
Giá trị trả về: Không có
Truy xuất danh sách các địa điểm dựa trên số điện thoại. Trong hầu hết các trường hợp, chỉ nên có một mục trong danh sách kết quả, tuy nhiên nếu yêu cầu không rõ ràng thì nhiều kết quả có thể được trả về. PlaceResult được chuyển đến lệnh gọi lại là tập hợp con của PlaceResult đầy đủ. Ứng dụng của bạn có thể nhận được một PlaceResult chi tiết hơn cho mỗi địa điểm bằng cách gọi PlacesService.getDetails và truyền PlaceResult.place_id cho địa điểm mong muốn. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Thông số:
Giá trị trả về: Không có
Truy xuất danh sách các địa điểm dựa trên chuỗi truy vấn. Trong hầu hết các trường hợp, chỉ nên có một mục trong danh sách kết quả, tuy nhiên nếu yêu cầu không rõ ràng thì nhiều kết quả có thể được trả về. PlaceResult được chuyển đến lệnh gọi lại là tập hợp con của PlaceResult đầy đủ. Ứng dụng của bạn có thể nhận được một PlaceResult chi tiết hơn cho mỗi địa điểm bằng cách gọi PlacesService.getDetails và truyền PlaceResult.place_id cho địa điểm mong muốn. |
getDetails |
getDetails(request, callback) Thông số:
Giá trị trả về: Không có
Truy xuất thông tin chi tiết về địa điểm được xác định bằng placeId đã cho. |
nearbySearch |
nearbySearch(request, callback) Thông số:
Giá trị trả về: Không có
Truy xuất danh sách các địa điểm gần một vị trí cụ thể, dựa trên từ khóa hoặc loại. Bạn phải luôn chỉ định vị trí bằng cách truyền các tham số LatLngBounds hoặc location và radius . PlaceResult được chuyển đến lệnh gọi lại là tập hợp con của PlaceResult đầy đủ. Ứng dụng của bạn có thể nhận được PlaceResult chi tiết hơn cho từng địa điểm bằng cách gửi yêu cầu Thông tin chi tiết về địa điểm chuyển PlaceResult.place_id cho địa điểm mong muốn. Bạn có thể sử dụng đối tượng PlaceSearchPagination để tìm nạp thêm các trang kết quả (rỗng nếu đây là trang kết quả cuối cùng hoặc nếu chỉ có một trang kết quả). |
textSearch |
textSearch(request, callback) Thông số:
Giá trị trả về: Không có
Truy xuất danh sách các địa điểm dựa trên chuỗi truy vấn (ví dụ: "pizza ở New York" hoặc "cửa hàng giày gần Ottawa"). Tham số vị trí là không bắt buộc; khi vị trí được chỉ định, kết quả chỉ thiên về kết quả lân cận thay vì bị giới hạn ở các địa điểm trong khu vực. Hãy sử dụng textSearch khi bạn muốn tìm kiếm địa điểm bằng một chuỗi tùy ý và trong trường hợp bạn có thể không muốn giới hạn kết quả tìm kiếm ở một vị trí cụ thể. Bạn có thể sử dụng đối tượng PlaceSearchPagination để tìm nạp thêm các trang kết quả (rỗng nếu đây là trang kết quả cuối cùng hoặc nếu chỉ có một trang kết quả). |
Giao diện PlaceDetailsRequest
Giao diện google.maps.places.PlaceDetailsRequest
Truy vấn thông tin chi tiết về Địa điểm sẽ được gửi tới PlacesService
.
Thuộc tính | |
---|---|
placeId |
Loại:
string Mã địa điểm của địa điểm mà bạn đang yêu cầu thông tin chi tiết. |
fields optional |
Loại:
Array<string> optional Các trường cần được đưa vào phản hồi chi tiết, sẽ được lập hoá đơn. Nếu không có trường nào được chỉ định hoặc ['ALL'] được chuyển vào, tất cả các trường có sẵn sẽ được trả về và lập hoá đơn (điều này không được đề xuất cho các triển khai phiên bản chính thức). Để 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 các đường dẫn dấu chấm (ví dụ: "geometry.location" ). |
language optional |
Loại:
string optional Giá trị nhận dạng ngôn ngữ của ngôn ngữ mà thông tin chi tiết sẽ được trả về. Xem danh sách ngôn ngữ được hỗ trợ. |
region 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 những ảnh có thể được trả về 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ự của ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD 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à thực thể của "Vương quốc Anh và Bắc Ireland"). |
sessionToken optional |
Loại:
AutocompleteSessionToken optional Tệp đối chiếu duy nhất dùng để gói yêu cầu chi tiết bằng một phiên tự động hoàn thành. |
Giao diện FindPlaceFromPhoneNumberRequest
Giao diện google.maps.places.FindPlaceFromPhoneNumberRequest
Tìm một địa điểm trong yêu cầu tìm kiếm văn bản đến PlacesService.findPlaceFromPhoneNumber
.
Thuộc tính | |
---|---|
fields |
Loại:
Array<string> Các trường sẽ được đưa vào phản hồi, sẽ được lập hoá đơn cho. Nếu ['ALL'] được chuyển vào, tất cả các trường có sẵn sẽ được trả về và lập hoá đơn (bạn không nên thực hiện việc này cho các hoạt động triển khai thực 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 các đường dẫn dấu chấm (ví dụ: "geometry.location" ). |
phoneNumber |
Loại:
string Số điện thoại của địa điểm cần tra cứu. Định dạng phải là E.164. |
language optional |
Loại:
string optional Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà tên và địa chỉ sẽ được trả về khi có thể. Xem danh sách ngôn ngữ được hỗ trợ. |
locationBias optional |
Loại:
LocationBias optional Độ lệch được sử dụng khi tìm kiếm Địa điểm. Kết quả này sẽ thiên về (nhưng không giới hạn) đối với LocationBias . |
Giao diện FindPlaceFromQueryRequest
Giao diện google.maps.places.FindPlaceFromQueryRequest
Tìm một địa điểm trong yêu cầu tìm kiếm văn bản đến PlacesService.findPlaceFromQuery
.
Thuộc tính | |
---|---|
fields |
Loại:
Array<string> Các trường sẽ được đưa vào phản hồi, sẽ được lập hoá đơn cho. Nếu ['ALL'] được chuyển vào, tất cả các trường có sẵn sẽ được trả về và lập hoá đơn (bạn không nên thực hiện việc này cho các hoạt động triển khai thực 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 các đường dẫn dấu chấm (ví dụ: "geometry.location" ). |
query |
Loại:
string Truy vấn của yêu cầu. Ví dụ: tên hoặc địa chỉ của một địa điểm. |
language optional |
Loại:
string optional Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà tên và địa chỉ sẽ được trả về khi có thể. Xem danh sách ngôn ngữ được hỗ trợ. |
locationBias optional |
Loại:
LocationBias optional Độ lệch được sử dụng khi tìm kiếm Địa điểm. Kết quả này sẽ thiên về (nhưng không giới hạn) đối với LocationBias . |
Giao diện PlaceSearchRequest
Giao diện google.maps.places.PlaceSearchRequest
Cụm từ tìm kiếm về Địa điểm sẽ được gửi đến PlacesService
.
Thuộc tính | |
---|---|
bounds optional |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Các giới hạn bên trong để tìm kiếm Địa điểm. Cả location và radius đều sẽ bị bỏ qua nếu bạn đặt bounds . |
keyword optional |
Loại:
string optional Một cụm từ để so khớp với tất cả các trường hiện có, bao gồm nhưng không giới hạn ở tên, loại và địa chỉ, cũng như bài đánh giá của khách hàng và nội dung khác của bên thứ ba. |
language optional |
Loại:
string optional Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà tên và địa chỉ sẽ được trả về khi có thể. Xem danh sách ngôn ngữ được hỗ trợ. |
location optional |
Loại:
LatLng|LatLngLiteral optional Vị trí xung quanh để tìm kiếm Địa điểm. |
maxPriceLevel optional |
Loại:
number optional Giới hạn kết quả chỉ đến những địa điểm ở mức giá đã chỉ định hoặc thấp hơn. Các giá trị hợp lệ nằm trong khoảng từ 0 (giá cả phải chăng nhất) đến 4 (đắt nhất), bao gồm cả. Phải lớn hơn hoặc bằng minPrice , nếu được chỉ định. |
minPriceLevel optional |
Loại:
number optional Chỉ cho phép hiển thị kết quả ở những địa điểm ở cấp giá đã chỉ định trở lên. Các giá trị hợp lệ nằm trong khoảng từ 0 (giá cả phải chăng nhất) đến 4 (đắt nhất), bao gồm cả. Phải nhỏ hơn hoặc bằng maxPrice , nếu được chỉ định. |
|
Loại:
string optional Tương đương với keyword . Giá trị trong trường này được kết hợp với giá trị trong trường keyword và được chuyển dưới dạng một phần của cùng một chuỗi tìm kiếm. |
openNow optional |
Loại:
boolean optional Giới hạn kết quả chỉ ở những địa điểm hiện đang mở cửa. |
radius optional |
Loại:
number optional Khoảng cách từ vị trí đã cho để tìm Địa điểm, tính bằng mét. Giá trị tối đa được phép là 50 000. |
rankBy optional |
Loại:
RankBy optional Mặc định:
RankBy.PROMINENCE Chỉ định phương thức xếp hạng để sử dụng khi trả về kết quả. Lưu ý rằng khi đặt rankBy thành DISTANCE , bạn phải chỉ định location nhưng không thể chỉ định radius hoặc bounds . |
type optional |
Loại:
string optional Tìm kiếm các địa điểm thuộc loại đã cho. Loại này được dịch sang ngôn ngữ địa phương của vị trí mục tiêu của yêu cầu và được sử dụng làm chuỗi truy vấn. Nếu một truy vấn cũng được cung cấp, thì truy vấn đó sẽ được nối với chuỗi loại đã bản địa hoá. Kết quả thuộc một loại khác sẽ bị loại khỏi câu trả lời. Dùng trường này để thực hiện thao tác tìm kiếm theo danh mục độc lập với ngôn ngữ và khu vực. Bạn có thể xem các loại hợp lệ tại đây. |
Giao diện TextSearchRequest
Giao diện google.maps.places.TextSearchRequest
Yêu cầu tìm kiếm văn bản sẽ được gửi đến PlacesService
.
Thuộc tính | |
---|---|
bounds optional |
Loại:
LatLngBounds|LatLngBoundsLiteral optional Ranh giới dùng để thiên về kết quả khi tìm kiếm địa điểm (không bắt buộc). Cả location và radius đều sẽ bị bỏ qua nếu bạn đặt bounds . Kết quả sẽ không bị giới hạn ở những kết quả nằm trong giới hạn này; nhưng kết quả bên trong sẽ xếp hạng cao hơn. |
language optional |
Loại:
string optional Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà tên và địa chỉ sẽ được trả về khi có thể. Xem danh sách ngôn ngữ được hỗ trợ. |
location optional |
Loại:
LatLng|LatLngLiteral optional Trung tâm của khu vực được dùng để tạo ra kết quả khi tìm kiếm Địa điểm. |
query optional |
Loại:
string optional Cụm từ tìm kiếm của yêu cầu. Ví dụ: tên địa điểm ("Tháp Eiffel", danh mục theo sau là tên địa điểm ("pizza ở New York") hoặc tên địa điểm theo sau là tên phân biệt vị trí ("Starbucks ở Sydney"). |
radius optional |
Loại:
number optional Bán kính của khu vực dùng để thiên vị khi tìm kiếm địa điểm, tính bằng mét. |
region optional |
Loại:
string optional Mã vùng để thiên vị. 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 mã ccTLD 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à thực thể của "Vương quốc Anh và Bắc Ireland"). |
type optional |
Loại:
string optional Tìm kiếm các địa điểm thuộc loại đã cho. Loại này được dịch sang ngôn ngữ địa phương của vị trí mục tiêu của yêu cầu và được sử dụng làm chuỗi truy vấn. Nếu một truy vấn cũng được cung cấp, thì truy vấn đó sẽ được nối với chuỗi loại đã bản địa hoá. Kết quả thuộc một loại khác sẽ bị loại khỏi câu trả lời. Dùng trường này để thực hiện thao tác tìm kiếm theo danh mục độc lập với ngôn ngữ và khu vực. Bạn có thể xem các loại hợp lệ tại đây. |
Hằng số RankBy
Hằng số google.maps.places.RankBy
Các tuỳ chọn xếp hạng cho PlaceSearchRequest.
Truy cập bằng cách gọi const {RankBy} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
DISTANCE |
Thứ hạng xếp hạng kết quả theo khoảng cách từ vị trí đó. |
PROMINENCE |
Thứ hạng được xếp hạng nhờ sự nổi bật của chúng. |
Loại lỗi LocationBias
google.maps.places.LocationBias
defdef
LocationBias thể hiện một ranh giới mềm hoặc gợi ý để sử dụng khi tìm kiếm Địa điểm. Kết quả có thể đến từ bên ngoài khu vực được chỉ định. Để sử dụng địa chỉ IP của người dùng hiện tại làm xu hướng, bạn có thể chỉ định chuỗi "IP_BIAS"
. Lưu ý: nếu sử dụng Circle
, bạn phải xác định tâm và bán kính.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
Loại lỗi Hạn chế vị trí
google.maps.places.LocationRestriction
defdef
Hạn chế vị trí thể hiện một ranh giới nghiêm ngặt để sử dụng khi tìm kiếm Địa điểm.
Hằng số PlaceServiceStatus
Hằng số google.maps.places.PlacesServiceStatus
Trạng thái do PlacesService
trả về khi hoàn tất các lượt tìm kiếm. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách dùng tên của hằng số. Ví dụ: 'OK'
hoặc google.maps.places.PlacesServiceStatus.OK
.
Truy cập bằng cách gọi const {PlacesServiceStatus} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
INVALID_REQUEST |
Yêu cầu này không hợp lệ. |
NOT_FOUND |
Không tìm thấy địa điểm được tham chiếu. |
OK |
Phản hồi chứa kết quả hợp lệ. |
OVER_QUERY_LIMIT |
Ứng dụng đã vượt quá hạn mức yêu cầu. |
REQUEST_DENIED |
Ứng dụng không được phép sử dụng PlacesService . |
UNKNOWN_ERROR |
Không thể xử lý yêu cầu PlacesService do lỗi máy chủ. Yêu cầu có thể thành công nếu bạn thử lại. |
ZERO_RESULTS |
Không tìm thấy kết quả nào cho yêu cầu này. |
Giao diện PlaceSearchPagination
Giao diện google.maps.places.PlaceSearchPagination
Một đối tượng dùng để tìm nạp thêm trang cho kết quả trên Địa điểm.
Thuộc tính | |
---|---|
hasNextPage |
Loại:
boolean Cho biết liệu có kết quả nào khác hay không. true khi có một trang kết quả khác. |
Phương pháp | |
---|---|
nextPage |
nextPage() Thông số: Không có
Giá trị trả về: Không có
Tìm nạp trang kết quả tiếp theo. Sử dụng cùng một hàm callback được cung cấp cho yêu cầu tìm kiếm đầu tiên. |
Giao diện PlaceResult
Giao diện google.maps.places.PlaceResult
Xác định thông tin về một Địa điểm.
Thuộc tính | |
---|---|
address_components optional |
Loại:
Array<GeocoderAddressComponent> optional Bộ sưu tập các thành phần địa chỉ cho vị trí của Địa điểm này. Chỉ có trong PlacesService.getDetails . |
adr_address optional |
Loại:
string optional Đại diện của địa chỉ của Địa điểm trong vi định dạng a. Chỉ có trong PlacesService.getDetails . |
aspects optional |
Loại:
Array<PlaceAspectRating> optional Các khía cạnh được xếp hạng của Địa điểm này, dựa trên các đánh giá của người dùng Google và Zagat. Điểm xếp hạng theo thang điểm từ 0 đến 30. |
business_status optional |
Loại:
BusinessStatus optional Một lá cờ cho biết trạng thái hoạt động của Địa điểm, nếu đó là doanh nghiệp (cho biết địa điểm đang hoạt động hay đóng cửa tạm thời hay vĩnh viễn). Nếu không có dữ liệu, cờ sẽ không xuất hiện trong câu trả lời của tìm kiếm hoặc thông tin chi tiết. |
formatted_address optional |
Loại:
string optional Địa chỉ đầy đủ của Địa điểm. |
formatted_phone_number optional |
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ố. Chỉ có trong PlacesService.getDetails . |
geometry optional |
Loại:
PlaceGeometry optional Thông tin liên quan đến hình học của Địa điểm. |
html_attributions optional |
Loại:
Array<string> optional Văn bản ghi công sẽ xuất hiện cho kết quả Địa điểm này. html_attributions có sẵn luôn được trả về bất kể fields có yêu cầu gì và phải được hiển thị. |
icon optional |
Loại:
string optional URL tới một tài nguyên hình ảnh có thể dùng để đại diện cho danh mục của Địa điểm này. |
icon_background_color optional |
Loại:
string optional Màu nền để sử dụng với biểu tượng của Địa điểm. Xem thêm PlaceResult.icon_mask_base_uri . |
icon_mask_base_uri optional |
Loại:
string optional URL bị cắt bớt đến mặt nạ biểu tượng. Thêm các loại biểu tượng khác nhau bằng cách thêm đuôi tệp vào cuối (tức là .svg hoặc .png ). |
international_phone_number optional |
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ó dấu cộng (+) ở đầu. Chỉ có trong PlacesService.getDetails . |
name optional |
Loại:
string optional Tên của Địa điểm. Lưu ý: Trong trường hợp người dùng nhập Địa điểm, đây là văn bản thô do người dùng nhập. Hãy thận trọng khi sử dụng dữ liệu này, vì người dùng độc hại có thể cố gắng sử dụng dữ liệu này làm vectơ cho các cuộc tấn công chèn mã (Xem http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
Loại:
PlaceOpeningHours optional Xác định thời gian Địa điểm mở cửa hoặc đóng cửa. |
|
Loại:
boolean optional Cờ cho biết Địa điểm đã đóng cửa vĩnh viễn hay tạm thời. Nếu địa điểm đang hoạt động hoặc không có dữ liệu, cờ sẽ không có trong phản hồi. |
photos optional |
Loại:
Array<PlacePhoto> optional Ảnh về Địa điểm này. Bộ sưu tập sẽ chứa tối đa mười đối tượng PlacePhoto . |
place_id optional |
Loại:
string optional Giá trị nhận dạng duy nhất của Địa điểm. |
plus_code optional |
Loại:
PlacePlusCode optional Xác định Mã vị trí mở hoặc "mã cộng" cho Địa điểm. |
price_level optional |
Loại:
number optional Mức giá của Địa điểm, trên thang điểm từ 0 đến 4. Mức giá được diễn giải như sau:
|
rating optional |
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. |
reviews optional |
Loại:
Array<PlaceReview> optional Danh sách bài đánh giá về Địa điểm này. Chỉ có trong PlacesService.getDetails . |
types optional |
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"] ). |
url optional |
Loại:
string optional URL của trang Google chính thức cho địa điểm này. Đây là trang do Google sở hữu có chứa thông tin tốt nhất hiện có về Địa điểm. Chỉ có trong PlacesService.getDetails . |
user_ratings_total optional |
Loại:
number optional Số lượng người dùng xếp hạng đã đóng góp vào PlaceResult.rating của Địa điểm này. |
|
Loại:
number optional Chênh 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ụ: Sydney, Úc theo giờ mùa hè, nhanh hơn 11 giờ so với giờ UTC, nên utc_offset sẽ là 660 . Đối với múi giờ phía sau UTC, độ lệch là số âm. Ví dụ: utc_offset là -60 đối với Áo Verde. Chỉ có trong PlacesService.getDetails . |
utc_offset_minutes optional |
Loại:
number optional Chênh 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ụ: Sydney, Úc theo 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 múi giờ phía sau UTC, độ lệch là số âm. Ví dụ: utc_offset_minutes là -60 đối với Áo Verde. Chỉ có trong PlacesService.getDetails . |
vicinity optional |
Loại:
string optional Địa chỉ đơn giản của Địa điểm, bao gồm tên đường phố, số nhà và vị trí, nhưng không phải là tỉnh/tiểu bang, mã bưu chính hoặc quốc gia. Ví dụ: văn phòng của Úc ở Sydney có giá trị vùng lân cận là "48 Pirrama Road, Pyrmont" . Chỉ có trong PlacesService.getDetails . |
website optional |
Loại:
string optional Trang web có căn cứ đáng tin của Địa điểm này, chẳng hạn như trang chủ của một doanh nghiệp. Chỉ có trong PlacesService.getDetails . |
Giao diện PlaceAspectRating
Giao diện google.maps.places.PlaceAspectRating
Xác định thông tin về một khía cạnh của địa điểm mà người dùng đã đánh giá.
Thuộc tính | |
---|---|
rating |
Loại:
number Điểm xếp hạng của khía cạnh này. Đối với các bài đánh giá riêng lẻ, đây là số nguyên từ 0 đến 3. Đối với điểm xếp hạng tổng hợp của một địa điểm, đây là số nguyên từ 0 đến 30. |
type |
Loại:
string Loại khung hình. Ví dụ: "food" , "decor" , "service" hoặc "overall" . |
Hằng số BusinessStatus
Hằng số google.maps.places.BusinessStatus
Trạng thái hoạt động của Địa điểm, nếu là một doanh nghiệp, được trả về trong PlaceResult (cho biết địa điểm đang hoạt động hay đóng cửa tạm thời hoặc vĩnh viễn). Hãy chỉ định các giá trị này theo giá trị hoặc tên hằng số (ví dụ: 'OPERATIONAL'
hoặc google.maps.places.BusinessStatus.OPERATIONAL
).
Truy cập bằng cách gọi const {BusinessStatus} = await google.maps.importLibrary("places")
. Xem phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
CLOSED_PERMANENTLY |
Doanh nghiệp bị đóng cửa vĩnh viễn. |
CLOSED_TEMPORARILY |
Doanh nghiệp tạm thời đóng cửa. |
OPERATIONAL |
Doanh nghiệp đang hoạt động bình thường. |
Giao diện PlaceGeometry
Giao diện google.maps.places.PlaceGeometry
Xác định thông tin về hình học của một Địa điểm.
Thuộc tính | |
---|---|
location optional |
Loại:
LatLng optional Vị trí của Địa điểm. |
viewport optional |
Loại:
LatLngBounds optional Chế độ xem ưu tiên khi hiển thị Địa điểm này trên bản đồ. Thuộc tính này sẽ là null nếu khung nhìn ưu tiên cho Địa điểm không được xác định. Chỉ có trong PlacesService.getDetails . |
Giao diện PlaceMởHours
Giao diện google.maps.places.PlaceOpeningHours
Xác định thông tin về giờ mở cửa của một Địa điểm.
Thuộc tính | |
---|---|
|
Loại:
boolean optional Địa điểm có mở cửa vào thời gian hiện tại hay không. |
periods optional |
Loại:
Array<PlaceOpeningHoursPeriod> optional Các khoảng thời gian mở cửa diễn ra mỗi ngày trong tuần, bắt đầu từ Chủ Nhật, theo thứ tự thời gian. Những ngày mà Địa điểm không mở cửa sẽ không được bao gồm. Chỉ có trong PlacesService.getDetails . |
weekday_text optional |
Loại:
Array<string> optional Một 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 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 vào tuần thứ Hai trong khi các ngôn ngữ khác bắt đầu vào Chủ Nhật. Chỉ có trong PlacesService.getDetails . Các lệnh gọi khác có thể trả về một mảng trống. |
Phương pháp | |
---|---|
isOpen |
isOpen([date]) Thông số:
Giá trị trả về:
boolean|undefined Kiểm tra xem địa điểm hiện có mở cửa hay không (khi không thông qua ngày nào) hoặc vào ngày cụ thể. Nếu địa điểm này không có PlaceResult.utc_offset_minutes hoặc PlaceOpeningHours.periods , thì undefined được trả về (PlaceOpeningHours.periods chỉ áp dụng qua PlacesService.getDetails ). Phương thức này không tính đến các giờ ngoại lệ, chẳng hạn như giờ hoạt động vào ngày lễ. |
Giao diện PlaceOpenHoursPeriod
Giao diện google.maps.places.PlaceOpeningHoursPeriod
Xác định thông tin có cấu trúc về giờ mở cửa của một Địa điểm. Lưu ý: Nếu một Địa điểm luôn mở, câu trả lời sẽ bị thiếu phần close
. Ứng dụng có thể dựa vào trạng thái luôn mở là khoảng thời gian open
chứa day
với giá trị 0
và time
với giá trị "0000"
, và không có close
.
Thuộc tính | |
---|---|
open |
Loại:
PlaceOpeningHoursTime Giờ mở cửa của Địa điểm. |
close optional |
Loại:
PlaceOpeningHoursTime optional Thời gian đóng cửa của Địa điểm. |
Giao diện PlaceMởHoursTime
Giao diện google.maps.places.PlaceOpeningHoursTime
Xác định khi một Địa điểm mở cửa hoặc đóng cửa.
Thuộc tính | |
---|---|
day |
Loại:
number Các 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. |
hours |
Loại:
number Giờ hoạt động của PlaceOpeningHoursTime.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. |
minutes |
Loại:
number Số phút của PlaceOpeningHoursTime.time dưới dạng số, trong phạm vi [0 , 59 ]. Thông tin này sẽ được báo cáo theo múi giờ của Địa điểm. |
time |
Loại:
string Thời gian trong ngày theo định dạng 24 giờ "hhmm". Các giá trị nằm trong khoảng [ "0000" , "2359" ]. Thời gian sẽ được báo cáo theo múi giờ của Địa điểm. |
nextDate optional |
Loại:
number optional Dấu thời gian (dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống, phù hợp để sử dụng với new Date() ) đại diện cho lần xuất hiện tiếp theo của Thời gian đặt địa điểm này. Giá trị này được tính từ PlaceOpeningHoursTime.day trong tuần, PlaceOpeningHoursTime.time và PlaceResult.utc_offset_minutes . Nếu PlaceResult.utc_offset_minutes là undefined , thì nextDate sẽ là undefined . |
Giao diện PlacePlusCode
Giao diện google.maps.places.PlacePlusCode
Xác định Mã vị trí mở hoặc "mã cộng" cho một Địa điểm. Các mã cộng có thể được dùng để thay thế cho địa chỉ đường phố ở những nơi không tồn tại (mã không được đánh số hoặc không có tên trên các đường phố).
Thuộc tính | |
---|---|
global_code |
Loại:
string Mã cộng có 1/8000 độ bằng 1/8000 của một khu vực bằng cấp. Ví dụ: "8FVC9G8F+5W" . |
compound_code optional |
Loại:
string optional Mã cộng có tỷ lệ 1/8000 của 1/8000 của khu vực có 4 ký tự đầu tiên (mã vùng) được thả và thay thế bằng nội dung mô tả địa phương. Ví dụ: "9G8F+5W Zurich, Switzerland" . Nếu không thể tìm thấy địa phương thích hợp để rút ngắn mã, thì trường này sẽ bị bỏ qua. |
Giao diện PlacePhoto
Giao diện google.maps.places.PlacePhoto
Thể hiện phần tử ảnh của một Địa điểm.
Thuộc tính | |
---|---|
height |
Loại:
number Chiều cao của ảnh tính bằng pixel. |
html_attributions |
Loại:
Array<string> Văn bản thuộc tính sẽ hiển thị cho ảnh này. |
width |
Loại:
number Chiều rộng của ảnh tính bằng pixel. |
Phương pháp | |
---|---|
getUrl |
getUrl([opts]) Thông số:
Giá trị trả về:
string Trả về URL hình ảnh tương ứng với các lựa chọn được chỉ định. |
Giao diện PhotoOptions
Giao diện google.maps.places.PhotoOptions
Xác định các tùy chọn yêu cầu ảnh.
Thuộc tính | |
---|---|
maxHeight optional |
Loại:
number optional Chiều cao tối đa tính bằng pixel của hình ảnh được trả về. |
maxWidth optional |
Loại:
number optional Chiều rộng tối đa tính bằng pixel của hình ảnh được trả về. |
Giao diện PlaceReview
Giao diện google.maps.places.PlaceReview
Đại diện cho một bài đánh giá về một địa điểm.
Thuộc tính | |
---|---|
author_name |
Loại:
string Tên của người đánh giá. |
language |
Loại:
string Mã ngôn ngữ IETF cho biết ngôn ngữ dùng để viết bài đánh giá này. Xin lưu ý rằng mã này chỉ bao gồm thẻ ngôn ngữ chính và 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 được gắn thẻ 'en' thay vì "en-AU" hoặc "en-UK". |
profile_photo_url |
Loại:
string URL đến ảnh hồ sơ của người khôi phục. |
relative_time_description |
Loại:
string Một chuỗi thời gian được định dạng gần đây, cho biết thời gian xem xét tương ứng 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ụ: "a month ago" . |
text |
Loại:
string Nội dung của bài đánh giá. |
time |
Loại:
number Dấu thời gian cho bài đánh giá, được biểu thị bằng giây kể từ lúc bắt đầu hệ thống. |
|
Loại:
Array<PlaceAspectRating> optional Các khía cạnh được đánh giá trong bài đánh giá. Điểm xếp hạng trên thang điểm từ 0 đến 3. |
author_url optional |
Loại:
string optional URL đến hồ sơ của người đánh giá. Trạng thái này sẽ là undefined khi hồ sơ của người đánh giá không xuất hiện. |
rating optional |
Loại:
number optional Điểm xếp hạng của bài đánh giá này, tức là một số từ 1,0 đến 5 (bao gồm cả 2). |