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.

Truy cập bằng cách gọi const {PlacesService} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlacesService
PlacesService(attrContainer)
Tham số: 
Tạo một phiên bản mới của PlacesService để hiển thị thông tin ghi nhận quyề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, danh sách kết quả chỉ có một mục. Tuy nhiên, nếu yêu cầu không rõ ràng, hệ thống có thể trả về nhiều kết quả. 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 các đị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, danh sách kết quả chỉ có một mục. Tuy nhiên, nếu yêu cầu không rõ ràng, hệ thống có thể trả về nhiều kết quả. 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 các 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 Chi tiết về địa điểm 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 (giá trị 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)
Tham số: 
Giá trị trả về:  Không có
Truy xuất danh sách các đị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"). Bạn không bắt buộc phải sử dụng các tham số vị trí; khi bạn chỉ định vị trí, kết quả chỉ thiên về kết quả ở gần chứ không bị giới hạn ở những địa điểm 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 (giá trị 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

google.maps.places.PlaceDetailsRequestgiao diện

Một truy vấn Chi tiết về đị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 cung cấp thông tin chi tiết.
fields optional
Loại:  Array<string> optional
Các trường sẽ được đưa vào phản hồi chi tiết, bạn sẽ phải trả phí cho các trường này. Nếu bạn không chỉ định trường nào hoặc truyền ['ALL'], thì tất cả các trường có sẵn sẽ được trả về và tính phí (không nên dùng cách này cho các hoạt động triển khai sản xuất). Để 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 optional
Loại:  string optional
Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà bạn muốn nhận thông tin chi tiết. Xem danh sách ngôn ngữ được hỗ trợ.
region 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ể ảnh hưởng đến những thứ khác. Mã khu vực chấp nhận giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp đá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 Anh và Bắc Ireland").
sessionToken optional
Loại:  AutocompleteSessionToken optional
Mã tham chiếu duy nhất dùng để kết hợp yêu cầu chi tiết với một phiên tự động hoàn thành.

Giao diện FindPlaceFromPhoneNumberRequest

google.maps.places.FindPlaceFromPhoneNumberRequestgiao diện

Yêu cầu tìm địa điểm từ cụm từ tìm kiếm sẽ được gửi đến PlacesService.findPlaceFromPhoneNumber.
fields
Loại:  Array<string>
Các trường sẽ được đưa vào phản hồi, bạn sẽ phải trả phí cho các trường này. Nếu ['ALL'] được truyền vào, tất cả các trường có sẵn sẽ được trả về và tính phí (không nên dùng cách này cho các hoạt động triển khai sản xuất). Để 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 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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
locationBias optional
Loại:  LocationBias optional
Độ lệch được dùng khi tìm kiếm Địa điểm. Kết quả sẽ thiên về LocationBias đã cho, nhưng không bị giới hạn ở LocationBias đó.

Giao diện FindPlaceFromQueryRequest

google.maps.places.FindPlaceFromQueryRequestgiao diện

Yêu cầu tìm địa điểm từ cụm từ tìm kiếm sẽ được gửi đến PlacesService.findPlaceFromQuery.
fields
Loại:  Array<string>
Các trường sẽ được đưa vào phản hồi, bạn sẽ phải trả phí cho các trường này. Nếu ['ALL'] được truyền vào, tất cả các trường có sẵn sẽ được trả về và tính phí (không nên dùng cách này cho các hoạt động triển khai sản xuất). Để 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 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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
locationBias optional
Loại:  LocationBias optional
Độ lệch được dùng khi tìm kiếm Địa điểm. Kết quả sẽ thiên về LocationBias đã cho, nhưng không bị giới hạn ở LocationBias đó.

Giao diện PlaceSearchRequest

google.maps.places.PlaceSearchRequestgiao diện

Cụm từ tìm kiếm Địa điểm sẽ được gửi đến PlacesService.
bounds optional
Ranh giới trong đó tìm kiếm Địa điểm. Cả location và radius sẽ bị bỏ qua nếu bạn đặt bounds.
keyword optional
Loại:  string optional
Một cụm từ cần 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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
location optional
Loại:  LatLng|LatLngLiteral optional
Vị trí mà bạn muốn tìm kiếm Địa điểm.
maxPriceLevel optional
Loại:  number optional
Giới hạn kết quả chỉ ở những địa điểm có mức giá được chỉ định hoặc thấp hơn. Các giá trị hợp lệ nằm trong khoảng từ 0 (rẻ nhất) đến 4 (đắt nhất). Phải lớn hơn hoặc bằng minPrice , nếu được chỉ định.
minPriceLevel optional
Loại:  number optional
Giới hạn kết quả chỉ ở những địa điểm có mức giá được chỉ định hoặc cao hơn. Các giá trị hợp lệ nằm trong khoảng từ 0 (rẻ nhất) đến 4 (đắt nhất). 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. 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 optional
Loại:  boolean optional
Chỉ hiển thị kết quả là những địa điểm đang mở cửa.
radius optional
Loại:  number optional
Khoảng cách từ vị trí đã cho mà trong đó cần 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 pháp xếp hạng sẽ dùng khi trả về kết quả. Xin 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 những đị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 truy vấn, thì truy vấn đó sẽ được nối vào chuỗi loại đã bản địa hoá. Kết quả thuộc một 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 tìm kiếm theo danh mục độc lập với 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

google.maps.places.TextSearchRequestgiao diện

Yêu cầu tìm kiếm bằng văn bản sẽ được gửi đến PlacesService.
bounds optional
Ranh giới dùng để điều chỉnh 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 phạm vi này, nhưng kết quả nằm trong phạm vi này sẽ được 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ề, nếu có thể. Xem danh sách ngôn ngữ được hỗ trợ.
location optional
Loại:  LatLng|LatLngLiteral optional
Tâm của khu vực dùng để điều chỉnh 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 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à thông tin phân biệt vị trí ("Starbucks ở Sydney").
radius optional
Loại:  number optional
Bán kính của khu vực được dùng để điều chỉ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 để thiên về kết quả. Mã khu vực chấp nhận giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp đá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 Anh và Bắc Ireland").
type optional
Loại:  string optional
Tìm kiếm những đị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 truy vấn, thì truy vấn đó sẽ được nối vào chuỗi loại đã bản địa hoá. Kết quả thuộc một 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 tìm kiếm theo danh mục độc lập với 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

Các lựa 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 Thư viện trong Maps JavaScript API.
DISTANCE Xếp hạng kết quả địa điểm theo khoảng cách từ vị trí.