Places Service

Lớp PlacesService

Lớp google.maps.places.PlacesService

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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

PlacesService
PlacesService(attrContainer)
Thông số:
Tạo một bản sao mới của PlacesService, nơi hiển thị các thông tin ghi công trong vùng chứa được chỉ định.
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, nhiều kết quả có thể được trả về. Các 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à chuyể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, nhiều kết quả có thể được trả về. Các 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à chuyể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 placeId xác định.
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 tham số LatLngBounds hoặc locationradius. Các PlaceResult 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 và truyền PlaceResult.place_id cho địa điểm mong muốn. Có thể dùng đối tượng PlaceSearchPagination để tìm nạp các trang kết quả bổ sung (null nếu đây là trang cuối cùng của kết quả 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ề các kết quả lân cận thay vì bị hạn chế ở các địa điểm trong khu vực. Hãy sử dụng textSearch khi bạn muốn tìm các địa điểm bằng một chuỗi tuỳ ý và trong trường hợp có thể bạn không muốn giới hạn kết quả tìm kiếm cho một vị trí cụ thể. Có thể dùng đối tượng PlaceSearchPagination để tìm nạp các trang kết quả bổ sung (null nếu đây là trang cuối cùng của kết quả 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 đến PlacesService.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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 sẽ xuất hiện trong phản hồi chi tiết sẽ được lập hóa đơn. Nếu bạn không chỉ định trường nào hoặc ['ALL'] được chuyển vào, thì tất cả các trường có sẵn sẽ được trả về và lập hóa đơn (không nên triển khai cho quá trình 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 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ữ cho ngôn ngữ mà chi tiết sẽ được trả về. Xem danh sách các 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. Thao tác này có thể ảnh hưởng đến việc trả lại ảnh và có thể cả những nội dung khác. Mã vùng chấp nhận một giá trị hai ký tự gồm ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đều giống với mã ISO 3166-1, trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 là "gb" (về mặt kỹ thuật là pháp nhân "Vương quốc Anh và Bắc Ireland".
sessionToken optional
Loại: AutocompleteSessionToken optional
Mã tham chiếu duy nhất dùng để nhóm 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 địa điểm từ yêu cầu tìm kiếm văn bản sẽ được gửi đến PlacesService.findPlaceFromPhoneNumber.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

fields
Loại: Array<string>
Các trường có trong phản hồi sẽ được lập hóa đơn. Nếu ['ALL'] được chuyển, tất cả các trường có sẵn sẽ được trả về và lập hóa đơn (không nên triển khai việc này). Để 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 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 các ngôn ngữ được hỗ trợ.
locationBias optional
Loại: LocationBias optional
Thành kiến được sử dụng khi tìm kiếm Địa điểm. Kết quả này sẽ có xu hướng nhưng không giới hạn ở LocationBias nhất định.

Giao diện FindPlaceFromQueryRequest

Giao diện google.maps.places.FindPlaceFromQueryRequest

Tìm địa điểm từ yêu cầu tìm kiếm văn bản sẽ được gửi đến PlacesService.findPlaceFromQuery.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

fields
Loại: Array<string>
Các trường có trong phản hồi sẽ được lập hóa đơn. Nếu ['ALL'] được chuyển, tất cả các trường có sẵn sẽ được trả về và lập hóa đơn (không nên triển khai việc này). Để 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 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 các ngôn ngữ được hỗ trợ.
locationBias optional
Loại: LocationBias optional
Thành kiến được sử dụng khi tìm kiếm Địa điểm. Kết quả này sẽ có xu hướng nhưng không giới hạn ở LocationBias nhất định.

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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

bounds optional
Giới hạn trong đó để tìm kiếm Địa điểm. Cả locationradius đều sẽ bị bỏ qua nếu bạn đặt bounds.
keyword optional
Loại: string optional
Một cụm từ để khớp với tất cả các trường có sẵn, 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 các ngôn ngữ được hỗ trợ.
location optional
Loại: LatLng|LatLngLiteral optional
Vị trí xung quanh để tìm Địa điểm.
maxPriceLevel optional
Loại: number optional
Chỉ cho phép các đị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ả hai giá trị đó. 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 các địa điểm đó ở mức 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ả hai giá trị đó. Phải nhỏ hơn hoặc bằng maxPrice, nếu được chỉ định.
name optional
Loại: string optional
Tương đương với keyword. Giá trị trong trường này được kết hợp với các 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
Chỉ hạn chế kết quả ở những địa điểm hiện đang mở cửa.
radius optional
Loại: number optional
Khoảng cách từ một vị trí cụ thể để 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 optional
Loại: RankBy optional
Mặc định: RankBy.PROMINENCE
Chỉ định phương thức xếp hạng mà bạn muốn sử dụng khi trả về kết quả. Xin 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 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 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á. Các kết quả thuộc một loại khác sẽ bị loại khỏi câu trả lời. Sử dụng trường này để thực hiện 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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

bounds optional
Ranh giới dùng để xu hướng kết quả khi tìm kiếm Địa điểm (không bắt buộc). Cả locationradius đều sẽ bị bỏ qua nếu bạn đặt bounds. Kết quả sẽ không bị giới hạn ở những giới hạn trong các 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 các ngôn ngữ được hỗ trợ.
location optional
Loại: LatLng|LatLngLiteral optional
Trung tâm của khu vực thường dùng cho kết quả thiên về 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 của một địa điểm (&hl=vi&
radius optional
Loại: number optional
Bán kính của khu vực dùng để tạo thành kết quả khi tìm kiếm Địa điểm, tính bằng mét.
region optional
Loại: string optional
Mã vùng tới xu hướng dẫn đến kết quả. Mã vùng chấp nhận một giá trị hai ký tự gồm ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đều giống với mã ISO 3166-1, trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 là "gb" (về mặt kỹ thuật là pháp nhân "Vương quốc Anh và Bắc Ireland".
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 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á. Các kết quả thuộc một loại khác sẽ bị loại khỏi câu trả lời. Sử dụng trường này để thực hiện 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ố StackBy

Hằng số google.maps.places.RankBy

Các tuỳ chọn xếp hạng cho một PlaceSearchRequest.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

DISTANCE Thứ hạng đưa ra kết quả theo khoảng cách từ vị trí.
PROMINENCE Thứ hạng của các kết quả theo mức độ nổi bật.

Typedef LocationBias

Type (kiểu) google.maps.places.LocationBias

LocationBias biểu thị 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 đã chỉ định. Để dùng địa chỉ IP của người dùng hiện tại làm vị trí, 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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

Typedef Hạn chế vị trí

Type (kiểu) google.maps.places.LocationRestriction

Hạn chế vị trí thể hiện ranh giới nghiêm ngặt để sử dụng khi tìm kiếm Địa điểm.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

LatLngBounds|LatLngBoundsLiteral

Hằng số PlacesServiceStatus

Hằng số google.maps.places.PlacesServiceStatus

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

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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 PlaceSearchPagration

Giao diện google.maps.places.PlaceSearchPagination

Một đối tượng dùng để tìm nạp các trang bổ sung trong kết quả Địa điểm.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

hasNextPage
Loại: boolean
Cho biết có thêm kết quả hay không. true khi có trang kết quả bổ sung.
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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

address_components optional
Tập hợp các thành phần địa chỉ cho vị trí của Địa điểm này. Chỉ dùng được với PlacesService.getDetails.
adr_address optional
Loại: string optional
Biểu thị địa chỉ của Địa điểm trong vi định dạng adr. Chỉ dùng được với 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
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 hoặc vĩnh viễn). Nếu không có dữ liệu thì cờ sẽ không xuất hiện trong kết quả tìm kiếm hoặc câu trả lời 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ố điện thoại. Chỉ dùng được với 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 thuộc tính sẽ hiển thị cho kết quả Tìm kiếm đị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 đế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 optional
Loại: string optional
Màu nền để sử dụng với biểu tượng Địa điểm Xem thêm PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
Loại: string optional
URL bị cắt ngắn đế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 optional
Loại: string optional
Số điện thoại của địa điểm ở định dạng quốc tế. Định dạng quốc tế bao gồm mã quốc gia và có tiền tố là dấu cộng (+). Chỉ dùng được với 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ơ để tấn công việc chèn mã (Xem http://en.wikipedia.org/wiki/Code_injection).
opening_hours optional
Loại: PlaceOpeningHours optional
Xác định thời điểm Địa điểm mở hoặc đóng.
permanently_closed optional
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 xuất hiện trong phản hồi.
photos optional
Loại: Array<PlacePhoto> optional
Ảnh về Địa điểm này. Tập hợp này 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 cho Đị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 hiểu như sau:
  • 0: Miễn phí
  • 1: Rẻ
  • 2: Trung bình
  • 3: Đắt
  • 4: Rất đắt
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ỉ dùng được với PlacesService.getDetails.
types optional
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 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 chứa thông tin tốt nhất hiện có về Địa điểm. Chỉ dùng được với PlacesService.getDetails.
user_ratings_total optional
Loại: number optional
Số xếp hạng của người dùng đã đóng góp vào PlaceResult.rating của Địa điểm này.
utc_offset optional
Loại: number optional
Chênh lệch so với giờ UTC theo múi giờ hiện tại của Địa điểm, tính bằng phút. Ví dụ: Sydney, Úc theo giờ mùa hè, sớm 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à âm. Ví dụ: utc_offset-60 của Cape Verde. Chỉ dùng được với PlacesService.getDetails.
utc_offset_minutes optional
Loại: number optional
Chênh lệch so với giờ UTC theo múi giờ hiện tại của Địa điểm, tính bằng phút. Ví dụ: Sydney, Úc theo giờ mùa hè, sớm 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à âm. Ví dụ: utc_offset_minutes-60 của Cape Verde. Chỉ dùng được với PlacesService.getDetails.
vicinity optional
Loại: string optional
Địa chỉ đơn giản cho Địa điểm, bao gồm tên đường phố, số đường phố và địa phương, nhưng không phải tỉnh/tiểu bang, mã bưu chính hoặc quốc gia. Ví dụ: văn phòng của Google ở Sydney, Úc có giá trị lân cận là "48 Pirrama Road, Pyrmont". Chỉ dùng được với PlacesService.getDetails.
website optional
Loại: string optional
Trang web đáng tin cậy cho Địa điểm này, chẳng hạn như doanh nghiệp\39; trang chủ. Chỉ dùng được với 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á.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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à một số nguyên từ 0 đến 3. Đối với điểm xếp hạng tổng hợp về 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

Trạng thái hoạt động của Địa điểm (nếu là 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).

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

CLOSED_PERMANENTLY Doanh nghiệp đó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 Địa điểm.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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 không có khung nhìn ưu tiên cho Địa điểm. Chỉ dùng được với PlacesService.getDetails.

Giao diện PlaceOpenHours

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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

open_now optional
Loại: boolean optional
Địa điểm có mở cửa vào thời điểm hiện tại hay không.
periods optional
Loại: Array<PlaceOpeningHoursPeriod> optional
Khoảng thời gian mở đầu cho 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 tính. Chỉ dùng được với PlacesService.getDetails.
weekday_text optional
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 phù hợp với ngôn ngữ hiện tại. Thứ tự của các thành phần 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 các ngôn ngữ khác bắt đầu vào Chủ Nhật. Chỉ dùng được với PlacesService.getDetails. Các lệnh gọi khác có thể trả về một mảng trống.
isOpen
isOpen([date])
Thông số:
  • dateDate optional
Giá trị trả về: boolean|undefined
Kiểm tra xem địa điểm có mở cửa ngay bây giờ không (khi không có ngày nào qua) 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 được trả về (PlaceOpeningHours.periods chỉ có sẵn qua PlacesService.getDetails). Phương pháp này không tính đến giờ đặc biệt, chẳng hạn như giờ hoạt động vào ngày lễ.

Giao diện PlaceOpenHoursInterval

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

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

open
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 PlaceOpenHoursTime

Giao diện google.maps.places.PlaceOpeningHoursTime

Xác định thời điểm Địa điểm mở hoặc đóng.

Yêu cầu tham số URL &libraries=places. Hãy xem phần 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 có nghĩa là thứ Ba.
hours
Loại: number
Giờ làm việc của PlaceOpeningHoursTime.time dưới dạng một 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 ở đị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 (tính bằng mili giây kể từ thời gian bắt đầu của hệ thống, thích hợp để sử dụng với new Date()) thể hiện cho lần xuất hiện tiếp theo của Place nghiHoursTime này. Giá trị này được tính từ PlaceOpeningHoursTime.day trong tuần, PlaceOpeningHoursTime.timePlaceResult.utc_offset_minutes. Nếu PlaceResult.utc_offset_minutesundefined, 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. Plus code có thể được sử dụng để thay thế cho địa chỉ đường phố ở những nơi chúng không tồn tại (nơi các tòa nhà không được đánh số hoặc không có tên của đường phố).

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

global_code
Loại: string
Mã cộng có 1/8000 bằng 1/8000 trên 1 khu vực. Ví dụ: "8FVC9G8F+5W".
compound_code optional
Loại: string optional
Mã cộng bằng 1/8000 độ bằng 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ả về đị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

Đại diện cho phần tử ảnh của một Địa điểm.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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.
getUrl
getUrl([opts])
Thông số:
Giá trị trả về: string
Trả về URL hình ảnh tương ứng với các tuỳ chọn đã chỉ định.

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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

maxHeight optional
Loại: number optional
Chiều cao tối đa tính bằng pixel của hình ảnh 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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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ữ 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 mà không có thẻ phụ nào cho biết quốc gia hoặc khu vực. Ví dụ: tất cả bài đánh giá bằng tiếng Anh đều được gắn thẻ 'en' thay vì # 39; en-AU&39; hoặc 'en-UK&39;.
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, thể hiện thời gian xem xét tương ứng với thời gian hiện tại trong một 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
Văn bản của một bài đánh giá.
time
Loại: number
Dấu thời gian cho bài đánh giá, tính bằng giây kể từ lúc bắt đầu hệ thống.
aspects optional
Loại: Array<PlaceAspectRating> optional
Các khía cạnh được đánh giá theo 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á. Đây sẽ là undefined khi hồ sơ của người đánh giá không có sẵn.
rating optional
Loại: number optional
Xếp hạng của bài đánh giá này, một số từ 1.0 đến 5.0 (bao gồm).