Places Service (deprecated)

Lớp PlacesService

lớp google.maps.places.PlacesService
thư viện "places"

Chứa các phương thức liên quan đến việc tìm kiếm địa điểm và truy xuất thông tin chi tiết về một địa điểm.

const {PlacesService} = await google.maps.importLibrary("places");
PlacesService
PlacesService(attrContainer)
Tham số:
Tạo một thực thể mới của PlacesService để hiển thị thông tin ghi nhận tác giả trong vùng chứa được chỉ định.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Tham số:
Giá trị trả về: Không có
Truy xuất danh sách địa điểm dựa trên số điện thoại. Trong hầu hết các trường hợp, chỉ 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ì có thể có nhiều kết quả được trả về. PlaceResult được truyền đến lệnh gọi lại là các 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 PlacesService.getDetails và truyền PlaceResult.place_id cho địa điểm mong muốn.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Tham số:
Giá trị trả về: Không có
Truy xuất danh sách địa điểm dựa trên một chuỗi truy vấn. Trong hầu hết các trường hợp, chỉ 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ì có thể có nhiều kết quả được trả về. PlaceResult được truyền đến lệnh gọi lại là các 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 PlacesService.getDetails và truyền PlaceResult.place_id cho địa điểm mong muốn.
getDetails
getDetails(request, callback)
Tham 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)
Tham 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ừ khoá hoặc loại. Bạn phải luôn chỉ định vị trí, bằng cách truyền tham số LatLngBounds hoặc location và radius. PlaceResult được truyền đến lệnh gọi lại là các 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 Place Details, truyền PlaceResult.place_id cho địa điểm mong muốn. Bạn có thể dùng đối tượng PlaceSearchPagination để tìm nạp các trang kết quả khác (null 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)
Tham số:
Giá trị trả về: Không có
Truy xuất danh sách địa điểm dựa trên một chuỗi truy vấn (ví dụ: "pizza ở New York" hoặc "cửa hàng giày gần Ottawa"). Các tham số vị trí là không bắt buộc; khi vị trí được chỉ định, kết quả chỉ thiên về các kết quả lân cận thay vì bị giới hạn ở các địa điểm bên trong khu vực. Sử dụng textSearch khi bạn muốn tìm kiếm địa điểm bằng một chuỗi tuỳ ý và trong trường hợp bạn 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ể dùng đối tượng PlaceSearchPagination để tìm nạp các trang kết quả khác (null 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

Một truy vấn Chi tiết địa điểm sẽ được gửi đến PlacesService.
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
không bắt buộc
Loại: Array<string> optional
Các trường cần đưa vào phản hồi chi tiết, sẽ được tính phí. Nếu bạn không chỉ định trường nào hoặc truyền ['ALL'] vào, thì tất cả các trường hiện có 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). Để 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").
language
không bắt buộc
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ợ.
region
không bắt buộc
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").
sessionToken
không bắt buộc
Loại: AutocompleteSessionToken optional
Giá trị nhận dạng duy nhất dùng để nhóm yêu cầu thông tin chi tiết với một phiên tự động hoàn thành.

Giao diện FindPlaceFromPhoneNumberRequest

giao diện google.maps.places.FindPlaceFromPhoneNumberRequest

Yêu cầu tìm địa điểm từ nội dung tìm kiếm dạng văn bản sẽ được gửi đến PlacesService.findPlaceFromPhoneNumber.
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 ['ALL'] 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). Để 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").
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
không bắt buộc
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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
locationBias
không bắt buộc
Loại: LocationBias optional
Xu hướng được sử dụng khi tìm kiếm Địa điểm. Kết quả sẽ thiên về LocationBias đã cho, nhưng không chỉ giới hạn ở đó.

Giao diện FindPlaceFromQueryRequest

giao diện google.maps.places.FindPlaceFromQueryRequest

Yêu cầu tìm địa điểm từ nội dung tìm kiếm dạng văn bản sẽ được gửi đến PlacesService.findPlaceFromQuery.
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 ['ALL'] 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). Để 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").
query
Loại: string
Cụm từ tìm kiếm của yêu cầu. Ví dụ: tên hoặc địa chỉ của một địa điểm.
language
không bắt buộc
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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
locationBias
không bắt buộc
Loại: LocationBias optional
Xu hướng được sử dụng khi tìm kiếm Địa điểm. Kết quả sẽ thiên về LocationBias đã cho, nhưng không chỉ giới hạn ở đó.

Giao diện PlaceSearchRequest

giao diện google.maps.places.PlaceSearchRequest

Cụm từ tìm kiếm địa điểm sẽ được gửi đến PlacesService.
bounds
không bắt buộc
Ranh giới để tìm kiếm Địa điểm. Cả location và radius sẽ bị bỏ qua nếu bạn đặt bounds.
keyword
không bắt buộc
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 của bên thứ ba.
language
không bắt buộc
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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
location
không bắt buộc
Loại: LatLng|LatLngLiteral optional
Vị trí xung quanh để tìm kiếm Địa điểm.
maxPriceLevel
không bắt buộc
Loại: number optional
Chỉ giới hạn kết quả ở những địa điểm có mức giá được chỉ định hoặc thấp hơn. Giá trị hợp lệ nằm trong khoảng từ 0 (giá phải chăng nhất) đến 4 (giá đắt nhất). Phải lớn hơn hoặc bằng minPrice , nếu được chỉ định.
minPriceLevel
không bắt buộc
Loại: number optional
Giới hạn kết quả chỉ ở những địa điểm có mức giá được chỉ định trở lên. Giá trị hợp lệ nằm trong khoảng từ 0 (giá phải chăng nhất) đến 4 (giá đắt nhất). Phải nhỏ hơn hoặc bằng maxPrice, nếu được chỉ định.
name
không bắt buộc
Loại: string optional
Tương đương với keyword. Các giá trị trong trường này được kết hợp với các giá trị trong trường keyword và được truyền dưới dạng một phần của cùng một chuỗi tìm kiếm.
openNow
không bắt buộc
Loại: boolean optional
Chỉ trả về kết quả là những địa điểm đang mở cửa.
radius
không bắt buộc
Loại: number optional
Khoảng cách từ vị trí đã cho để tìm kiếm Địa điểm, tính bằng mét. Giá trị tối đa được phép là 50.000.
rankBy
không bắt buộc
Loại: RankBy optional
Mặc định: RankBy.PROMINENCE
Chỉ định phương thức xếp hạng cần sử dụng khi trả về kết quả. Lưu ý rằng khi rankBy được đặt thành DISTANCE, bạn phải chỉ định location nhưng không thể chỉ định radius hoặc bounds.
type
không bắt buộc
Loại: string optional
Tìm kiếm đị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 trong yêu cầu và được dùng làm chuỗi truy vấn. Nếu bạn cũng cung cấp một cụm từ tìm kiếm, thì cụm từ đó sẽ được nối với chuỗi loại đã bản địa hoá. Kết quả thuộc loại khác sẽ bị loại bỏ khỏi phản hồi. Sử dụng trường này để thực hiện các lượt tìm kiếm theo danh mục không phụ thuộc vào ngôn ngữ và khu vực. Các loại hợp lệ được cung cấp 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.
bounds
không bắt buộc
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 sẽ bị bỏ qua nếu bạn đặt bounds. Kết quả sẽ không bị giới hạn trong các ranh giới này; nhưng kết quả bên trong ranh giới sẽ có thứ hạng cao hơn.
language
không bắt buộc
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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
location
không bắt buộc
Loại: LatLng|LatLngLiteral optional
Tâm của khu vực được dùng để ưu tiên kết quả khi tìm kiếm Địa điểm.
query
không bắt buộc
Loại: string optional
Cụm từ tìm kiếm của yêu cầu. Ví dụ: tên của một địa điểm ("Tháp Eiffel"), một danh mục theo sau là tên của một vị trí ("pizza ở New York") hoặc tên của một địa điểm theo sau là một từ phân biệt vị trí ("Starbucks ở Sydney").
radius
không bắt buộc
Loại: number optional
Bán kính của khu vực dùng để thiên vị kết quả khi tìm kiếm Địa điểm, tính bằng mét.
region
không bắt buộc
Loại: string optional
Mã vùng để ưu tiên kết quả. 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").
type
không bắt buộc
Loại: string optional
Tìm kiếm đị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 trong yêu cầu và được dùng làm chuỗi truy vấn. Nếu bạn cũng cung cấp một cụm từ tìm kiếm, thì cụm từ đó sẽ được nối với chuỗi loại đã bản địa hoá. Kết quả thuộc loại khác sẽ bị loại bỏ khỏi phản hồi. Sử dụng trường này để thực hiện các lượt tìm kiếm theo danh mục không phụ thuộc vào ngôn ngữ và khu vực. Các loại hợp lệ được cung cấp tại đây.

Hằng số RankBy

hằng số google.maps.places.RankBy
thư viện "places"

Các lựa chọn xếp hạng cho PlaceSearchRequest.

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE Xếp hạng kết quả về địa điểm theo khoảng cách từ vị trí.
PROMINENCE Xếp hạng kết quả về địa điểm theo mức độ nổi bật.

typedef LocationBias

typedef google.maps.places.LocationBias

LocationBias đại diện cho một ranh giới hoặc gợi ý mềm để sử dụng khi tìm kiếm Địa điểm. Kết quả có thể nằm 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 độ lệch, 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|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

Typedef LocationRestriction

typedef google.maps.places.LocationRestriction

LocationRestriction đại diện cho một ranh giới nghiêm ngặt cần sử dụng khi tìm kiếm Địa điểm.

LatLngBounds|LatLngBoundsLiteral

Hằng số PlacesServiceStatus

hằng số google.maps.places.PlacesServiceStatus
thư viện "places"

Trạng thái do PlacesService trả về khi hoàn tất quá trình tìm kiếm. Chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. Ví dụ: 'OK' hoặc google.maps.places.PlacesServiceStatus.OK

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại PlacesServiceStatusString.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
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 Câu trả lờ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 phía 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.

PlaceSearchPagination

giao diện google.maps.places.PlaceSearchPagination

Một đối tượng dùng để tìm nạp các trang kết quả khác của Địa điểm.
hasNextPage
Loại: boolean
Cho biết liệu có thêm kết quả hay không. true khi có thêm trang kết quả.
nextPage
nextPage()
Tham số: Không có
Giá trị trả về: void
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.
address_components
không bắt buộc
Tập hợ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
không bắt buộc
Loại: string optional
Biểu thị địa chỉ của Địa điểm ở định dạng vi mô adr. Chỉ có trong PlacesService.getDetails.
aspects
không bắt buộc
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 bài đánh giá của người dùng trên Google và Zagat. Điểm xếp hạng được tính theo thang điểm từ 0 đến 30.
business_status
không bắt buộc
Loại: BusinessStatus optional
Cờ cho biết trạng thái hoạt động của Địa điểm, nếu đó là một doanh nghiệp (cho biết địa điểm đó đang hoạt động hay đã đóng cửa tạm thời hoặc vĩnh viễn). Nếu không có dữ liệu, cờ này sẽ không xuất hiện trong phản hồi tìm kiếm hoặc phản hồi chi tiết.
formatted_address
không bắt buộc
Loại: string optional
Địa chỉ đầy đủ của Địa điểm.
formatted_phone_number
không bắt buộc
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. Chỉ có trong PlacesService.getDetails.
geometry
không bắt buộc
Loại: PlaceGeometry optional
Thông tin liên quan đến hình học của Địa điểm.
html_attributions
không bắt buộc
Loại: Array<string> optional
Văn bản ghi công sẽ hiển thị cho kết quả Địa điểm này. html_attributions có sẵn luôn được trả về bất kể fields nào đã được yêu cầu và phải được hiển thị.
icon
không bắt buộc
Loại: string optional
URL đến 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
không bắt buộc
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
không bắt buộc
Loại: string optional
URL bị cắt bớt đến mặt nạ biểu tượng. Truy cập vào 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
không bắt buộc
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. Chỉ có trong PlacesService.getDetails.
name
không bắt buộc
Loại: string optional
Tên của địa điểm. Lưu ý: Trong trường hợp Địa điểm do người dùng nhập, đâ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ó ý đồ xấu 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
không bắt buộc
Loại: PlaceOpeningHours optional
Xác định thời điểm Địa điểm mở cửa hoặc đóng cửa.
permanently_closed
không bắt buộc
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 nếu không có dữ liệu, thì cờ này sẽ không có trong phản hồi.
photos
không bắt buộc
Loại: Array<PlacePhoto> optional
Ảnh về địa điểm này. Tập hợp này sẽ chứa tối đa 10 đối tượng PlacePhoto.
place_id
không bắt buộc
Loại: string optional
Giá trị nhận dạng riêng biệt của Địa điểm.
plus_code
không bắt buộc
Loại: PlacePlusCode optional
Xác định Mã địa điểm mở hoặc "Plus Codes" cho Địa điểm.
price_level
không bắt buộc
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:
  • 0: Miễn phí
  • 1: Giá rẻ
  • 2: Trung bình
  • 3: Đắt
  • 4: Rất đắt
rating
không bắt buộc
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.
reviews
không bắt buộc
Loại: Array<PlaceReview> optional
Danh sách bài đánh giá về Địa điểm này. Chỉ có trong PlacesService.getDetails.
types
không bắt buộc
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"]).
url
không bắt buộc
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. Chỉ có trong PlacesService.getDetails.
user_ratings_total
không bắt buộc
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 PlaceResult.rating của Địa điểm này.
utc_offset
không bắt buộc
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ụ: Sydney, Úc theo giờ mùa hè nhanh hơn giờ UTC 11 tiếng, nên utc_offset 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 là -60 cho Cape Verde. Chỉ có trong PlacesService.getDetails.
utc_offset_minutes
không bắt buộc
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ụ: Sydney, Úc theo giờ mùa hè nhanh hơn giờ UTC 11 tiếng, 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. Chỉ có trong PlacesService.getDetails.
vicinity
không bắt buộc
Loại: string optional
Địa chỉ đơn giản của Địa điểm, bao gồm tên đường, số đường và địa phương, nhưng không bao gồm tỉnh/tiểu bang, mã bưu chính hoặc quốc gia. Ví dụ: văn phòng của Google tại Sydney, Úc có giá trị vùng lân cận là "48 Pirrama Road, Pyrmont". Chỉ có trong PlacesService.getDetails.
website
không bắt buộc
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. 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á.
rating
Loại: number
Điểm xếp hạng của khía cạnh này. Đối với từng bài đánh giá, đây là một 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à một số nguyên từ 0 đến 30.
type
Loại: string
Loại khía cạnh. Ví dụ: "food", "decor", "service" hoặc "overall".

Hằng số BusinessStatus

hằng số google.maps.places.BusinessStatus
thư viện "places"

Trạng thái hoạt động của địa điểm. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại BusinessStatusString.

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY Cơ sở này đã đóng cửa vĩnh viễn. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
CLOSED_TEMPORARILY Cơ sở này tạm thời đóng cửa. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
FUTURE_OPENING Cơ sở này sẽ mở cửa trong tương lai. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.
OPERATIONAL Cơ sở này đang hoạt động, không nhất thiết phải mở cửa ngay bây giờ. Hãy xem tài liệu về dịch vụ web để biết thêm thông tin.

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.
location
không bắt buộc
Loại: LatLng optional
Vị trí của Địa điểm.
viewport
không bắt buộc
Loại: LatLngBounds optional
Khung nhìn ư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 không xác định được khung nhìn ưu tiên cho Địa điểm. Chỉ có trong PlacesService.getDetails.

Giao diện PlaceOpeningHours

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.
open_now
không bắt buộc
Loại: boolean optional
Liệu Địa điểm có mở cửa vào thời điểm hiện tại hay không.
periods
không bắt buộc
Loại: Array<PlaceOpeningHoursPeriod> optional
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. Chỉ có trong PlacesService.getDetails.
weekday_text
không bắt buộc
Loại: Array<string> optional
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. Chỉ có trong PlacesService.getDetails. Các lệnh gọi khác có thể trả về một mảng trống.
isOpen
isOpen([date])
Tham số:
  • date: Date optional
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 có ngày nào được truyền) hoặc vào ngày đã cho. Nếu địa điểm này không có PlaceResult.utc_offset_minutes hoặc PlaceOpeningHours.periods, thì undefined sẽ được trả về (PlaceOpeningHours.periods chỉ có sẵn thông qua PlacesService.getDetails). Phương thức này không xem xét giờ đặc biệt, chẳng hạn như giờ ngày lễ.

Giao diện PlaceOpeningHoursPeriod

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ửa, thì phần close sẽ bị thiếu trong phản hồi. Khách hàng có thể dựa vào việc luôn mở cửa được biểu thị dưới dạng khoảng thời gian open chứa day có giá trị 0 và time có giá trị "0000", và không có close.
open
Giờ mở cửa của Địa điểm.
close
không bắt buộc
Loại: PlaceOpeningHoursTime optional
Giờ đóng cửa của Địa điểm.

Giao diện PlaceOpeningHoursTime

giao diện google.maps.places.PlaceOpeningHoursTime

Xác định thời điểm một Địa điểm mở cửa hoặc đóng cửa.
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 nghĩa là thứ Ba.
hours
Loại: number
Giờ của PlaceOpeningHoursTime.time dưới dạng số, trong khoảng [0, 23]. Giá trị này sẽ được báo cáo theo múi giờ của Địa điểm.
minutes
Loại: number
Phút của PlaceOpeningHoursTime.time dưới dạng số, trong khoảng [0, 59]. Giá trị 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". 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
không bắt buộc
Loại: number optional
Dấu thời gian (tính bằ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()) thể hiện lần xuất hiện tiếp theo của PlaceOpeningHoursTime này. Chỉ số này được tính từ PlaceOpeningHoursTime.day của 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ã địa điểm mở hoặc "Plus Codes" cho một Địa điểm. Bạn có thể sử dụng Plus Codes để thay thế cho địa chỉ đường phố ở những nơi không có địa chỉ (nơi các toà nhà không được đánh số hoặc đường phố không có tên).
global_code
Loại: string
Plus Code có diện tích 1/8000 độ x 1/8000 độ. Ví dụ: "8FVC9G8F+5W".
compound_code
không bắt buộc
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". Nếu không tìm thấy địa phương phù 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

Đại diện cho một phần tử ảnh của một Địa điểm.
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 ghi công sẽ hiển thị cho ảnh này.
width
Loại: number
Chiều rộng của ảnh, tính bằng pixel.
getUrl
getUrl([opts])
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.

Giao diện PhotoOptions

giao diện google.maps.places.PhotoOptions

Xác định các lựa chọn yêu cầu ảnh.
maxHeight
không bắt buộc
Loại: number optional
Chiều cao tối đa (tính bằng pixel) của hình ảnh được trả về.
maxWidth
không bắt buộc
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.
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ữ của 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ó bất kỳ thẻ phụ nào cho biết quốc gia hoặc khu vực. Ví dụ: tất cả cá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".
profile_photo_url
Loại: string
URL đến ảnh hồ sơ của người đánh giá.
relative_time_description
Loại: string
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ụ: "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ừ thời gian bắt đầu của hệ thống.
aspects
không bắt buộc
Loại: Array<PlaceAspectRating> optional
Các khía cạnh được xếp hạng trong bài đánh giá. Điểm xếp hạng theo thang điểm từ 0 đến 3.
author_url
không bắt buộc
Loại: string optional
URL đến hồ sơ của người đánh giá. Đây sẽ là undefined khi không có hồ sơ của người đánh giá.
rating
không bắt buộc
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).