Package google.maps.places.v1

Chỉ mục

Địa điểm

Định nghĩa dịch vụ cho API Địa điểm. Lưu ý: mọi yêu cầu (ngoại trừ yêu cầu Tự động hoàn thành) đều yêu cầu mặt nạ trường được đặt bên ngoài proto yêu cầu (all/*, không được giả định). Bạn có thể đặt mặt nạ trường thông qua tiêu đề HTTP X-Goog-FieldMask. Xem: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Trả về kết quả dự đoán cho dữ liệu đầu vào đã cho.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Lấy nội dung nghe nhìn dạng ảnh có chuỗi tham chiếu ảnh.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

Nhận thông tin chi tiết về một địa điểm dựa trên tên tài nguyên của địa điểm đó, tên này là một chuỗi ở định dạng places/{place_id}.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Tìm kiếm địa điểm gần các vị trí.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Tìm kiếm địa điểm dựa trên cụm từ tìm kiếm dạng văn bản.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

Nội dung mô tả quan hệ về một vị trí. Bao gồm một tập hợp các địa danh lân cận và khu vực chứa chính xác được xếp hạng cùng mối quan hệ của các địa danh đó với vị trí mục tiêu.

Trường
landmarks[]

Landmark

Danh sách địa danh lân cận được xếp hạng. Những địa danh nổi tiếng và gần nhất được xếp hạng đầu tiên.
areas[]

Area

Danh sách được xếp hạng gồm các khu vực chứa hoặc liền kề. Những khu vực dễ nhận biết và chính xác nhất sẽ được xếp hạng trước.

Khu vực

Thông tin về khu vực và mối quan hệ của khu vực đó với vị trí mục tiêu.

Khu vực bao gồm các địa phương phụ, khu dân cư và khu phức hợp lớn chính xác, hữu ích cho việc mô tả một vị trí.

Trường
name

string

Tên tài nguyên của khu vực.
place_id

string

Mã địa điểm của khu vực.
display_name

LocalizedText

Tên hiển thị của khu vực.
containment

Containment

Xác định mối quan hệ không gian giữa vị trí mục tiêu và khu vực.

Vùng chứa

Xác định mối quan hệ không gian giữa vị trí mục tiêu và khu vực.

Enum
CONTAINMENT_UNSPECIFIED Chưa xác định vùng chứa.
WITHIN Vị trí mục tiêu nằm trong khu vực, gần trung tâm.
OUTSKIRTS Vị trí mục tiêu nằm trong vùng, gần cạnh.
NEAR Vị trí mục tiêu nằm ngoài khu vực, nhưng ở gần.

Địa danh

Thông tin cơ bản về địa danh và mối quan hệ của địa danh đó với vị trí mục tiêu.

Địa điểm nổi bật là những địa điểm nổi tiếng có thể dùng để mô tả một vị trí.

Trường
name

string

Tên tài nguyên của địa danh.
place_id

string

Mã địa điểm của địa danh.
display_name

LocalizedText

Tên hiển thị của địa danh.
types[]

string

Một tập hợp thẻ loại cho địa danh này. Để xem danh sách đầy đủ các giá trị có thể có, hãy xem https://developers.google.com/maps/documentation/places/web-service/place-types.
spatial_relationship

SpatialRelationship

Xác định mối quan hệ không gian giữa vị trí mục tiêu và điểm đánh dấu.
straight_line_distance_meters

float

Khoảng cách theo đường thẳng, tính bằng mét, giữa điểm giữa của mục tiêu và điểm giữa của điểm đánh dấu. Trong một số trường hợp, giá trị này có thể dài hơn travel_distance_meters.
travel_distance_meters

float

Khoảng cách di chuyển, tính bằng mét, dọc theo mạng lưới đường từ mục tiêu đến điểm mốc (nếu có). Giá trị này không tính đến phương tiện di chuyển, chẳng hạn như đi bộ, lái xe hoặc đi xe đạp.

SpatialRelationship

Xác định mối quan hệ không gian giữa vị trí mục tiêu và điểm đánh dấu.

Enum
NEAR Đây là mối quan hệ mặc định khi không có mối quan hệ cụ thể nào khác áp dụng ở bên dưới.
WITHIN Điểm đánh dấu có hình học không gian và mục tiêu nằm trong giới hạn của điểm đánh dấu.
BESIDE Mục tiêu nằm ngay cạnh điểm đánh dấu.
ACROSS_THE_ROAD Mục tiêu nằm ngay đối diện với điểm mốc ở phía bên kia đường.
DOWN_THE_ROAD Trên cùng một tuyến đường với địa điểm yêu thích, nhưng không phải bên cạnh hoặc đối diện.
AROUND_THE_CORNER Không nằm trên cùng tuyến đường với địa điểm yêu thích nhưng chỉ cách một ngã rẽ.
BEHIND Gần cấu trúc của địa danh nhưng xa lối vào đường.

AuthorAttribution

Thông tin về tác giả của dữ liệu nội dung do người dùng tạo. Được dùng trong Photo và Review.

Trường
display_name

string

Tên của tác giả Photo hoặc Review.
uri

string

URI của tác giả Photo hoặc Review.
photo_uri

string

URI ảnh hồ sơ của tác giả Photo hoặc Review.

AutocompletePlacesRequest

Yêu cầu proto cho AutocompletePlaces.

Trường
input

string

Bắt buộc. Chuỗi văn bản cần tìm kiếm.
location_bias

LocationBias

Không bắt buộc. Cung cấp kết quả thiên vị cho một vị trí cụ thể.

Bạn chỉ nên đặt tối đa một trong hai thuộc tính location_bias hoặc location_restriction. Nếu bạn không đặt giá trị cho cả hai, thì kết quả sẽ bị thiên lệch theo địa chỉ IP, tức là địa chỉ IP sẽ được liên kết với một vị trí không chính xác và được dùng làm tín hiệu thiên lệch.
location_restriction

LocationRestriction

Không bắt buộc. Hạn chế kết quả ở một vị trí cụ thể.

Bạn chỉ nên đặt tối đa một trong hai thuộc tính location_bias hoặc location_restriction. Nếu bạn không đặt giá trị cho cả hai, thì kết quả sẽ bị thiên lệch theo địa chỉ IP, tức là địa chỉ IP sẽ được liên kết với một vị trí không chính xác và được dùng làm tín hiệu thiên lệch.
included_primary_types[]

string

Không bắt buộc. Đã thêm loại Địa điểm chính (ví dụ: "nhà_hàng" hoặc "trạm_xăng") trong Loại địa điểm (https://developers.google.com/maps/documentation/places/web-service/place-types), hoặc chỉ (regions) hoặc chỉ (cities). Một Địa điểm chỉ được trả về nếu loại chính của địa điểm đó có trong danh sách này. Bạn có thể chỉ định tối đa 5 giá trị. Nếu bạn không chỉ định loại nào, thì tất cả các loại Địa điểm sẽ được trả về.
included_region_codes[]

string

Không bắt buộc. Chỉ bao gồm kết quả ở các khu vực được chỉ định, được chỉ định dưới dạng tối đa 15 mã khu vực gồm hai ký tự theo quy ước của CLDR. Tập hợp trống sẽ không hạn chế kết quả. Nếu bạn đặt cả location_restriction và included_region_codes, thì kết quả sẽ nằm trong vùng giao nhau.
language_code

string

Không bắt buộc. Ngôn ngữ để trả về kết quả. Mặc định là en-US. Kết quả có thể được trình bày bằng nhiều ngôn ngữ nếu ngôn ngữ được sử dụng trong input khác với language_code hoặc nếu Địa điểm được trả về không có bản dịch từ ngôn ngữ địa phương sang language_code.
region_code

string

Không bắt buộc. Mã vùng, được chỉ định dưới dạng mã vùng gồm hai ký tự theo CLDR. Điều này ảnh hưởng đến cách định dạng địa chỉ, thứ hạng kết quả và có thể ảnh hưởng đến kết quả được trả về. Việc này không giới hạn kết quả ở khu vực đã chỉ định. Để hạn chế kết quả ở một khu vực, hãy sử dụng region_code_restriction.
origin

LatLng

Không bắt buộc. Điểm gốc để tính toán khoảng cách geodesic đến đích (được trả về dưới dạng distance_meters). Nếu bạn bỏ qua giá trị này, thì khoảng cách geodesic sẽ không được trả về.
input_offset

int32

Không bắt buộc. Độ dời ký tự Unicode dựa trên 0 của input cho biết vị trí con trỏ trong input. Vị trí con trỏ có thể ảnh hưởng đến nội dung dự đoán được trả về.

Nếu để trống, giá trị mặc định sẽ là độ dài của input.
include_query_predictions

bool

Không bắt buộc. Nếu đúng, phản hồi sẽ bao gồm cả thông tin dự đoán về Địa điểm và truy vấn. Nếu không, phản hồi sẽ chỉ trả về kết quả dự đoán về Địa điểm.
session_token

string

Không bắt buộc. Một chuỗi xác định một phiên Tự động hoàn thành cho mục đích thanh toán. Phải là một URL và tên tệp an toàn ở định dạng base64, có độ dài tối đa 36 ký tự ASCII. Nếu không, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.

Phiên bắt đầu khi người dùng bắt đầu nhập truy vấn và kết thúc khi họ chọn một địa điểm và thực hiện lệnh gọi đến Chi tiết địa điểm hoặc Xác thực địa chỉ. Mỗi phiên có thể có nhiều truy vấn, theo sau là một yêu cầu Chi tiết về địa điểm hoặc Xác thực địa chỉ. Thông tin xác thực dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án trên Google Cloud Console. Sau khi một phiên kết thúc, mã thông báo sẽ không còn hợp lệ nữa; ứng dụng của bạn phải tạo một mã thông báo mới cho mỗi phiên. Nếu bạn bỏ qua thông số session_token hoặc sử dụng lại mã thông báo phiên, thì phiên sẽ bị tính phí như thể không có mã thông báo phiên nào được cung cấp (mỗi yêu cầu được tính phí riêng).

Bạn nên làm theo các nguyên tắc sau:

  • Sử dụng mã thông báo phiên cho tất cả lệnh gọi Tự động hoàn thành địa điểm.
  • Tạo mã thông báo mới cho mỗi phiên. Bạn nên sử dụng UUID phiên bản 4.
  • Đảm bảo rằng thông tin xác thực dùng cho tất cả các yêu cầu Tự động hoàn thành địa điểm, Thông tin chi tiết về địa điểm và Xác thực địa chỉ trong một phiên đều thuộc cùng một dự án trên Cloud Console.
  • Hãy nhớ truyền một mã thông báo phiên duy nhất cho mỗi phiên mới. Việc sử dụng cùng một mã thông báo cho nhiều phiên sẽ khiến mỗi yêu cầu được tính phí riêng.
include_pure_service_area_businesses

bool

Không bắt buộc. Bao gồm cả những doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng nếu bạn đặt trường này thành true. Doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng là một doanh nghiệp trực tiếp cung cấp dịch vụ tận nơi hoặc giao hàng cho khách hàng, nhưng không phục vụ khách hàng tại địa chỉ của doanh nghiệp. Ví dụ: những doanh nghiệp cung cấp dịch vụ vệ sinh hoặc sửa ống nước. Những doanh nghiệp đó không có địa chỉ thực tế hoặc vị trí trên Google Maps. Đối với những doanh nghiệp này, Places sẽ không trả về các trường bao gồm location, plus_code và các trường khác liên quan đến vị trí.

LocationBias

Khu vực cần tìm kiếm. Kết quả có thể bị thiên lệch xung quanh khu vực đã chỉ định.

Trường

Trường hợp hợp nhất type.

type chỉ có thể là một trong những giá trị sau:
rectangle

Viewport

Khung nhìn được xác định bằng góc đông bắc và góc tây nam.
circle

Circle

Một hình tròn được xác định bằng tâm điểm và bán kính.

LocationRestriction

Khu vực cần tìm kiếm. Kết quả sẽ được giới hạn ở khu vực đã chỉ định.

Trường

Trường hợp hợp nhất type.

type chỉ có thể là một trong những giá trị sau:
rectangle

Viewport

Khung nhìn được xác định bằng góc đông bắc và góc tây nam.
circle

Circle

Một hình tròn được xác định bằng tâm điểm và bán kính.

AutocompletePlacesResponse

Tệp proto phản hồi cho AutocompletePlaces.

Trường
suggestions[]

Suggestion

Chứa danh sách các đề xuất, được sắp xếp theo thứ tự giảm dần về mức độ liên quan.

Đề xuất

Kết quả đề xuất của tính năng Tự động hoàn thành.

Trường

Trường hợp hợp nhất kind.

kind chỉ có thể là một trong những giá trị sau:
place_prediction

PlacePrediction

Thông tin dự đoán về một Địa điểm.
query_prediction

QueryPrediction

Kết quả dự đoán cho một truy vấn.

FormattableText

Văn bản đại diện cho một Địa điểm hoặc cụm từ tìm kiếm được gợi ý. Bạn có thể sử dụng văn bản như hiện có hoặc định dạng văn bản.

Trường
text

string

Văn bản có thể được sử dụng nguyên trạng hoặc được định dạng bằng matches.
matches[]

StringRange

Danh sách các dải chuỗi xác định vị trí yêu cầu đầu vào khớp trong text. Bạn có thể dùng các dải ô để định dạng các phần cụ thể của text. Chuỗi con có thể không khớp chính xác với input nếu việc so khớp được xác định theo các tiêu chí khác ngoài so khớp chuỗi (ví dụ: sửa lỗi chính tả hoặc phiên âm).

Các giá trị này là độ dời ký tự Unicode của text. Các dải ô được đảm bảo được sắp xếp theo thứ tự tăng dần của giá trị chênh lệch.

PlacePrediction

Kết quả dự đoán cho cụm từ gợi ý của tính năng Tự động hoàn thành địa điểm.

Trường
place

string

Tên tài nguyên của Địa điểm được đề xuất. Bạn có thể sử dụng tên này trong các API khác chấp nhận tên Địa điểm.
place_id

string

Giá trị nhận dạng duy nhất của Địa điểm được đề xuất. Bạn có thể sử dụng giá trị nhận dạng này trong các API khác chấp nhận Mã địa điểm.
text

FormattableText

Chứa tên mà con người có thể đọc được cho kết quả được trả về. Đối với kết quả về cơ sở lưu trú, đây thường là tên và địa chỉ của cơ sở lưu trú.

text được đề xuất cho những nhà phát triển muốn hiển thị một thành phần trên giao diện người dùng. Nhà phát triển muốn hiển thị hai thành phần giao diện người dùng riêng biệt nhưng có liên quan có thể muốn sử dụng structured_format. Đây là hai cách khác nhau để thể hiện thông tin dự đoán về Địa điểm. Người dùng không nên cố gắng phân tích cú pháp structured_format thành text hoặc ngược lại.

Văn bản này có thể khác với display_name do GetPlace trả về.

Có thể bằng nhiều ngôn ngữ nếu yêu cầu input và language_code bằng nhiều ngôn ngữ hoặc nếu Địa điểm không có bản dịch từ ngôn ngữ địa phương sang language_code.
structured_format

StructuredFormat

Thông tin chi tiết về nội dung dự đoán Địa điểm được chia thành văn bản chính chứa tên của Địa điểm và văn bản phụ chứa các đặc điểm khác giúp phân biệt (chẳng hạn như thành phố hoặc khu vực).

Bạn nên sử dụng structured_format cho những nhà phát triển muốn hiển thị hai thành phần trên giao diện người dùng riêng biệt nhưng có liên quan. Nhà phát triển muốn hiển thị một thành phần trên giao diện người dùng có thể sử dụng text. Đây là hai cách khác nhau để thể hiện thông tin dự đoán về Địa điểm. Người dùng không nên cố gắng phân tích cú pháp structured_format thành text hoặc ngược lại.
types[]

string

Danh sách các loại áp dụng cho Địa điểm này trong Bảng A hoặc Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types.

Loại là một cách phân loại Địa điểm. Những địa điểm có cùng loại sẽ có các đặc điểm tương tự nhau.
distance_meters

int32

Chiều dài của đường trắc địa tính bằng mét từ origin nếu origin được chỉ định. Một số thông tin dự đoán như tuyến đường có thể không điền vào trường này.

QueryPrediction

Kết quả dự đoán cho cụm từ gợi ý của tính năng Tự động hoàn thành cụm từ tìm kiếm.

Trường
text

FormattableText

Văn bản được dự đoán. Văn bản này không đại diện cho một Địa điểm, mà là một cụm từ tìm kiếm dạng văn bản có thể được sử dụng trong một điểm cuối tìm kiếm (ví dụ: Tìm kiếm bằng văn bản).

text được đề xuất cho những nhà phát triển muốn hiển thị một thành phần trên giao diện người dùng. Nhà phát triển muốn hiển thị hai thành phần giao diện người dùng riêng biệt nhưng có liên quan có thể muốn sử dụng structured_format. Đây là hai cách khác nhau để thể hiện nội dung dự đoán truy vấn. Người dùng không nên cố gắng phân tích cú pháp structured_format thành text hoặc ngược lại.

Có thể bằng nhiều ngôn ngữ nếu yêu cầu input và language_code bằng nhiều ngôn ngữ hoặc nếu một phần của cụm từ tìm kiếm không có bản dịch từ ngôn ngữ bản địa sang language_code.
structured_format

StructuredFormat

Bảng chi tiết về nội dung dự đoán cụm từ tìm kiếm thành văn bản chính chứa cụm từ tìm kiếm và văn bản phụ chứa các tính năng phân biệt khác (chẳng hạn như thành phố hoặc khu vực).

Bạn nên sử dụng structured_format cho những nhà phát triển muốn hiển thị hai thành phần trên giao diện người dùng riêng biệt nhưng có liên quan. Nhà phát triển muốn hiển thị một thành phần trên giao diện người dùng có thể sử dụng text. Đây là hai cách khác nhau để thể hiện nội dung dự đoán truy vấn. Người dùng không nên cố gắng phân tích cú pháp structured_format thành text hoặc ngược lại.

StringRange

Xác định một chuỗi con trong một văn bản nhất định.

Trường
start_offset

int32

Độ lệch dựa trên 0 của ký tự Unicode đầu tiên của chuỗi (bao gồm cả ký tự đó).
end_offset

int32

Độ dời dựa trên 0 của ký tự Unicode cuối cùng (không bao gồm).

StructuredFormat

Chứa thông tin chi tiết về một Địa điểm hoặc nội dung dự đoán cụm từ tìm kiếm thành văn bản chính và văn bản phụ.

Đối với kết quả dự đoán Địa điểm, văn bản chính chứa tên cụ thể của Địa điểm. Đối với nội dung dự đoán cụm từ tìm kiếm, văn bản chính sẽ chứa cụm từ tìm kiếm.

Văn bản phụ chứa các đặc điểm khác giúp phân biệt (chẳng hạn như thành phố hoặc khu vực) để xác định rõ hơn Địa điểm hoặc tinh chỉnh cụm từ tìm kiếm.

Trường
main_text

FormattableText

Biểu thị tên của Địa điểm hoặc cụm từ tìm kiếm.
secondary_text

FormattableText

Biểu thị các tính năng phân biệt khác (chẳng hạn như thành phố hoặc khu vực) để xác định rõ hơn Địa điểm hoặc tinh chỉnh truy vấn.

Hình tròn

Vòng tròn có LatLng làm tâm và bán kính.

Trường
center

LatLng

Bắt buộc. Căn giữa vĩ độ và kinh độ.

Phạm vi vĩ độ phải nằm trong khoảng [-90.0, 90.0]. Phạm vi của kinh độ phải nằm trong khoảng [-180.0, 180.0].
radius

double

Bắt buộc. Bán kính được đo bằng mét. Bán kính phải nằm trong khoảng [0,0, 50000].

ContentBlock

Một khối nội dung có thể được phân phát riêng lẻ.

Trường
topic

string

Chủ đề của nội dung, ví dụ: "tổng quan" hoặc "nhà hàng".
content

LocalizedText

Nội dung liên quan đến chủ đề.
references

References

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Nội dung tham chiếu liên quan đến khối nội dung này.

ContextualContent

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Nội dung phù hợp với ngữ cảnh của cụm từ tìm kiếm địa điểm.

Trường
reviews[]

Review

Danh sách bài đánh giá về địa điểm này, phù hợp với cụm từ tìm kiếm về địa điểm.
photos[]

Photo

Thông tin (bao gồm cả thông tin tham khảo) về ảnh của địa điểm này, phù hợp với cụm từ tìm kiếm địa điểm.
justifications[]

Justification

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Lý do cho việc đề xuất địa điểm đó.

Lý giải

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Lý do cho việc đề xuất địa điểm đó. Nội dung giải thích trả lời câu hỏi tại sao một địa điểm có thể khiến người dùng cuối quan tâm.

Trường

Trường hợp hợp nhất justification.

justification chỉ có thể là một trong những giá trị sau:
review_justification

ReviewJustification

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.
business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

BusinessAvailabilityAttributesJustification

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết. Lý do cho việc sử dụng thuộc tính BusinessAvailabilityAttributes. Đây là một số thuộc tính mà doanh nghiệp có thể cung cấp và có thể khiến người dùng cuối quan tâm.

Trường
takeout

bool

Liệu địa điểm đó có phục vụ đồ ăn mang đi không.
delivery

bool

Liệu địa điểm đó có cung cấp dịch vụ giao hàng tận nơi hay không.
dine_in

bool

Liệu địa điểm đó có phục vụ ăn uống tại chỗ hay không.

ReviewJustification

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Lý do cho bài đánh giá của người dùng. Phần này làm nổi bật một phần của bài đánh giá mà người dùng cuối sẽ quan tâm. Ví dụ: nếu cụm từ tìm kiếm là "pizza nướng bằng củi", thì nội dung lý giải cho bài đánh giá sẽ làm nổi bật văn bản có liên quan đến cụm từ tìm kiếm đó.

Trường
highlighted_text

HighlightedText
review

Review

Bài đánh giá mà văn bản được đánh dấu được tạo từ đó.

HighlightedText

Văn bản được làm nổi bật bằng căn chỉnh. Đây là một phần của chính bài đánh giá đó. Từ chính xác cần làm nổi bật được đánh dấu bằng HighlightedTextRange. Có thể có một số từ trong văn bản được làm nổi bật.

Trường
text

string
highlighted_text_ranges[]

HighlightedTextRange

Danh sách các dải ô của văn bản được đánh dấu.

HighlightedTextRange

Phạm vi văn bản được làm nổi bật.

Trường
start_index

int32
end_index

int32

EVChargeOptions

Thông tin về Trạm sạc xe điện được lưu trữ trong địa điểm. Thuật ngữ tuân theo https://afdc.energy.gov/fuels/electricity_infrastructure.html Mỗi cổng có thể sạc một xe cùng một lúc. Một cổng có một hoặc nhiều đầu nối. Một trạm có một hoặc nhiều cổng.

Trường
connector_count

int32

Số lượng đầu nối tại trạm này. Tuy nhiên, do một số cổng có thể có nhiều đầu nối nhưng chỉ có thể sạc một ô tô tại một thời điểm (ví dụ:), số lượng đầu nối có thể lớn hơn tổng số ô tô có thể sạc đồng thời.
connector_aggregation[]

ConnectorAggregation

Danh sách các tập hợp đầu nối sạc xe điện chứa các đầu nối cùng loại và cùng tốc độ sạc.

ConnectorAggregation

Thông tin sạc xe điện được nhóm theo [type, max_charge_rate_kw]. Cho thấy thông tin tổng hợp về việc sạc xe điện của các đầu nối có cùng loại và tốc độ sạc tối đa tính bằng kW.

Trường
type

EVConnectorType

Loại trình kết nối của dữ liệu tổng hợp này.
max_charge_rate_kw

double

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.
count

int32

Số lượng trình kết nối trong dữ liệu tổng hợp này.
availability_last_update_time

Timestamp

Dấu thời gian của lần cập nhật gần đây nhất đối với thông tin về tình trạng hoạt động của trình kết nối trong dữ liệu tổng hợp này.
available_count

int32

Số lượng trình kết nối trong dữ liệu tổng hợp này hiện có.
out_of_service_count

int32

Số lượng trình kết nối trong dữ liệu tổng hợp này hiện không hoạt động.

EVConnectorType

Hãy xem http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 để biết thêm thông tin/thông tin chi tiết về các loại đầu nối sạc xe điện.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Trình kết nối không xác định.
EV_CONNECTOR_TYPE_OTHER Các loại đầu nối khác.
EV_CONNECTOR_TYPE_J1772 Đầu nối J1772 loại 1.
EV_CONNECTOR_TYPE_TYPE_2 Đầu nối IEC 62196 loại 2. Thường được gọi là MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Đầu nối loại CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Hệ thống sạc kết hợp (AC và DC). Dựa trên SAE. Đầu nối J-1772 loại 1
EV_CONNECTOR_TYPE_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
EV_CONNECTOR_TYPE_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 đầu nối thực tế hơn và 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.
EV_CONNECTOR_TYPE_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.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Ổ cắm trên tường không xác định.
EV_CONNECTOR_TYPE_NACS Hệ thống sạc Bắc Mỹ (NACS), được chuẩn hoá theo SAE J3400.

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.

Trường
fuel_prices[]

FuelPrice

Giá nhiên liệu mới nhất được biết đến cho từng loại nhiên liệu mà trạm xăng này có. Mỗi loại nhiên liệu mà trạm xăng này có sẽ có một mục nhập. Thứ tự không quan trọng.

FuelPrice

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

Trường
type

FuelType

Loại nhiên liệu.
price

Money

Giá nhiên liệu.
update_time

Timestamp

Thời gian cập nhật giá nhiên liệu gần đây nhất.

FuelType

Loại nhiên liệu.

Enum
FUEL_TYPE_UNSPECIFIED Loại nhiên liệu không xác định.
DIESEL Dầu diesel.
DIESEL_PLUS Dầu diesel và nhiên liệu.
REGULAR_UNLEADED Xăng không chì thông thường.
MIDGRADE Loại trung.
PREMIUM Premium.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 Bản vá bảo mật 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 100 peso Chile.
LPG Khí dầu mỏ hoá lỏng.
E80 E 80.
E85 E 85.
E100 100 euro.
METHANE Khí mêtan.
BIO_DIESEL Dầu diesel sinh học.
TRUCK_DIESEL Dầu diesel cho xe tải.

GetPhotoMediaRequest

Yêu cầu tìm nạp ảnh của một địa điểm bằng tên tài nguyên ảnh.

Trường
name

string

Bắt buộc. Tên tài nguyên của nội dung nghe nhìn dạng ảnh ở định dạng: places/{place_id}/photos/{photo_reference}/media.

Tên tài nguyên của ảnh được trả về trong trường photos.name của đối tượng Địa điểm có định dạng places/{place_id}/photos/{photo_reference}. Bạn cần thêm /media vào cuối tài nguyên ảnh để lấy tên tài nguyên nội dung nghe nhìn ảnh.
max_width_px

int32

Không bắt buộc. Chỉ định chiều rộng tối đa mong muốn, tính bằng pixel, của hình ảnh. Nếu hình ảnh nhỏ hơn các giá trị đã chỉ định, hình ảnh gốc sẽ được trả về. Nếu lớn hơn ở một trong hai kích thước, hình ảnh sẽ được điều chỉnh theo tỷ lệ cho phù hợp với kích thước nhỏ hơn trong hai kích thước, bị giới hạn ở tỷ lệ khung hình ban đầu. Cả thuộc tính max_height_px và max_width_px đều chấp nhận một số nguyên từ 1 đến 4800, bao gồm cả số nguyên đó. Nếu giá trị không nằm trong phạm vi cho phép, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Bạn cần chỉ định ít nhất một trong hai thuộc tính max_height_px hoặc max_width_px. Nếu bạn không chỉ định max_height_px hoặc max_width_px, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
max_height_px

int32

Không bắt buộc. Chỉ định chiều cao tối đa mong muốn (tính bằng pixel) của hình ảnh. Nếu hình ảnh nhỏ hơn các giá trị đã chỉ định, hình ảnh gốc sẽ được trả về. Nếu lớn hơn ở một trong hai kích thước, hình ảnh sẽ được điều chỉnh theo tỷ lệ cho phù hợp với kích thước nhỏ hơn trong hai kích thước, bị giới hạn ở tỷ lệ khung hình ban đầu. Cả thuộc tính max_height_px và max_width_px đều chấp nhận một số nguyên từ 1 đến 4800, bao gồm cả số nguyên đó. Nếu giá trị không nằm trong phạm vi cho phép, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Bạn cần chỉ định ít nhất một trong hai thuộc tính max_height_px hoặc max_width_px. Nếu bạn không chỉ định max_height_px hoặc max_width_px, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
skip_http_redirect

bool

Không bắt buộc. Nếu được đặt, hãy bỏ qua hành vi chuyển hướng HTTP mặc định và hiển thị phản hồi ở định dạng văn bản (ví dụ: ở định dạng JSON cho trường hợp sử dụng HTTP). Nếu bạn không đặt thuộc tính này, hệ thống sẽ chuyển hướng HTTP để chuyển hướng lệnh gọi đến nội dung nghe nhìn hình ảnh. Tuỳ chọn này bị bỏ qua đối với các yêu cầu không phải HTTP.

GetPlaceRequest

Yêu cầu tìm nạp một Địa điểm dựa trên tên tài nguyên của địa điểm đó, tên này là một chuỗi ở định dạng places/{place_id}.

Trường
name

string

Bắt buộc. Tên tài nguyên của một địa điểm, ở định dạng places/{place_id}.
language_code

string

Không bắt buộc. Thông tin chi tiết về địa điểm sẽ hiển thị bằng ngôn ngữ ưu tiên (nếu có).

Danh sách ngôn ngữ hiện được hỗ trợ: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Không bắt buộc. Mã quốc gia/khu vực Unicode (CLDR) của vị trí nơi yêu cầu đến. Tham số này được dùng để hiển thị thông tin chi tiết về địa điểm, chẳng hạn như tên địa điểm theo khu vực (nếu có). Thông 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 không được hỗ trợ.
session_token

string

Không bắt buộc. Một chuỗi xác định một phiên Tự động hoàn thành cho mục đích thanh toán. Phải là một URL và tên tệp an toàn ở định dạng base64, có độ dài tối đa 36 ký tự ASCII. Nếu không, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.

Phiên bắt đầu khi người dùng bắt đầu nhập truy vấn và kết thúc khi họ chọn một địa điểm và thực hiện lệnh gọi đến Chi tiết địa điểm hoặc Xác thực địa chỉ. Mỗi phiên có thể có nhiều truy vấn, theo sau là một yêu cầu Chi tiết về địa điểm hoặc Xác thực địa chỉ. Thông tin xác thực dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án trên Google Cloud Console. Sau khi một phiên kết thúc, mã thông báo sẽ không còn hợp lệ nữa; ứng dụng của bạn phải tạo một mã thông báo mới cho mỗi phiên. Nếu bạn bỏ qua thông số session_token hoặc sử dụng lại mã thông báo phiên, thì phiên sẽ bị tính phí như thể không có mã thông báo phiên nào được cung cấp (mỗi yêu cầu được tính phí riêng).

Bạn nên làm theo các nguyên tắc sau:

  • Sử dụng mã thông báo phiên cho tất cả lệnh gọi Tự động hoàn thành địa điểm.
  • Tạo mã thông báo mới cho mỗi phiên. Bạn nên sử dụng UUID phiên bản 4.
  • Đảm bảo rằng thông tin xác thực dùng cho tất cả các yêu cầu Tự động hoàn thành địa điểm, Thông tin chi tiết về địa điểm và Xác thực địa chỉ trong một phiên đều thuộc cùng một dự án trên Cloud Console.
  • Hãy nhớ truyền một mã thông báo phiên duy nhất cho mỗi phiên mới. Việc sử dụng cùng một mã thông báo cho nhiều phiên sẽ khiến mỗi yêu cầu được tính phí riêng.

Ảnh

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

Trường
name

string

Giá trị nhận dạng. Một tệp tham chiếu đại diện cho ảnh địa điểm này. Bạn có thể dùng tệp này để tra cứu lại ảnh địa điểm này (còn gọi là tên "tài nguyên" API: places/{place_id}/photos/{photo}).
width_px

int32

Chiều rộng tối đa có sẵn, tính bằng pixel.
height_px

int32

Chiều cao tối đa có sẵn, tính bằng pixel.
author_attributions[]

AuthorAttribution

Tác giả của ảnh này.
flag_content_uri

string

Đường liên kết mà người dùng có thể gắn cờ vấn đề về ảnh.
google_maps_uri

string

Đường liên kết để hiển thị ảnh trên Google Maps.

PhotoMedia

Nội dung nghe nhìn dạng ảnh từ API Địa điểm.

Trường
name

string

Tên tài nguyên của nội dung nghe nhìn dạng ảnh ở định dạng: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

Một uri ngắn hạn có thể dùng để hiển thị ảnh.

Địa điểm

Tất cả thông tin đại diện cho một Địa điểm.

Trường
name

string

Tên tài nguyên của Địa điểm này, ở định dạng places/{place_id}. Có thể dùng để tra cứu Địa điểm.
id

string

Giá trị nhận dạng duy nhất của một địa điểm.
display_name

LocalizedText

Tên đã bản địa hoá của địa điểm, phù hợp với nội dung mô tả ngắn gọn và dễ đọc. Ví dụ: "Google Sydney", "Starbucks", "Pyrmont", v.v.
types[]

string

Một tập hợp thẻ loại cho kết quả này. Ví dụ: "chính trị" và "địa phương". Để biết danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types
primary_type

string

Loại chính của kết quả đã cho. Loại này phải là một trong các loại được hỗ trợ của API Địa điểm. Ví dụ: "nhà hàng", "quán cà phê", "sân bay", v.v. Một địa điểm chỉ có thể có một loại chính. Để biết danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types
primary_type_display_name

LocalizedText

Tên hiển thị của loại chính, được bản địa hoá theo ngôn ngữ yêu cầu (nếu có). Để biết danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types
national_phone_number

string

Số điện thoại của địa điểm, ở định dạng quốc gia và dễ đọc.
international_phone_number

string

Số điện thoại của địa điểm ở định dạng quốc tế, dễ đọc.
formatted_address

string

Địa chỉ đầy đủ, dễ đọc cho địa điểm này.
short_formatted_address

string

Địa chỉ ngắn, dễ đọc cho địa điểm này.
address_components[]

AddressComponent

Các thành phần lặp lại cho từng cấp độ địa phương. Lưu ý những thông tin sau về mảng address_components[]: – Mảng thành phần địa chỉ có thể chứa nhiều thành phần hơn so với formatted_address. – Mảng này không nhất thiết phải bao gồm tất cả các thực thể chính trị chứa địa chỉ, ngoài những thực thể có trong formatted_address. Để truy xuất tất cả các thực thể chính trị chứa một địa chỉ cụ thể, bạn nên sử dụng tính năng mã hoá địa lý đảo ngược, truyền vĩ độ/kinh độ của địa chỉ dưới dạng tham số cho yêu cầu. – Định dạng của phản hồi không được đảm bảo sẽ giữ nguyên giữa các yêu cầu. Cụ thể, số lượng address_components thay đổi tuỳ theo địa chỉ được yêu cầu và có thể thay đổi theo thời gian đối với cùng một địa chỉ. Một thành phần có thể thay đổi vị trí trong mảng. Loại thành phần có thể thay đổi. Một thành phần cụ thể có thể bị thiếu trong phản hồi sau này.
plus_code

PlusCode

Plus code của vĩ độ/kinh độ của vị trí địa điểm.
location

LatLng

Vị trí của địa điểm này.
viewport

Viewport

Khung nhìn phù hợp để hiển thị địa điểm trên bản đồ có kích thước trung bình. Bạn không nên sử dụng khung nhìn này làm ranh giới thực tế hoặc khu vực phục vụ của doanh nghiệp.
rating

double

Đ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.
google_maps_uri

string

URL cung cấp thêm thông tin về địa điểm này.
website_uri

string

Trang web có thẩm quyền về địa điểm này, ví dụ: trang chủ của doanh nghiệp. Xin lưu ý rằng đối với những địa điểm thuộc một chuỗi cửa hàng (ví dụ: cửa hàng IKEA), đây thường là trang web của từng cửa hàng chứ không phải của toàn bộ chuỗi cửa hàng.
reviews[]

Review

Danh sách bài đánh giá về địa điểm này, được sắp xếp theo mức độ liên quan. Hệ thống có thể trả về tối đa 5 bài đánh giá.
regular_opening_hours

OpeningHours

Giờ hoạt động thông thường. Xin lưu ý rằng nếu một địa điểm luôn mở cửa (24 giờ), thì trường close sẽ không được đặt. Ứng dụng có thể dựa vào trạng thái luôn mở (24 giờ) được biểu thị dưới dạng khoảng thời gian [open][google.maps.places.v1.Place.OpeningHours.Period.open] chứa [day][Point.day] có giá trị 0, [hour][Point.hour] có giá trị 0 và [minute][Point.minute] có giá trị 0.
photos[]

Photo

Thông tin (bao gồm cả thông tin tham khảo) về ảnh của địa điểm này. Bạn có thể trả lại tối đa 10 ảnh.
adr_format_address

string

Địa chỉ của địa điểm ở định dạng vi mô adr: http://microformats.org/wiki/adr.
business_status

BusinessStatus

Trạng thái kinh doanh của địa điểm.
price_level

PriceLevel

Mức giá của địa điểm.
attributions[]

Attribution

Một tập hợp nhà cung cấp dữ liệu phải hiển thị cùng với kết quả này.
icon_mask_base_uri

string

URL bị cắt bớt đến mặt nạ biểu tượng. Người dùng có thể truy cập vào nhiều loại biểu tượng bằng cách thêm hậu tố loại vào cuối (ví dụ: ".svg" hoặc ".png").
icon_background_color

string

Màu nền cho icon_mask ở định dạng hex, ví dụ: #909CE1.
current_opening_hours

OpeningHours

Giờ hoạt động trong 7 ngày tới (kể cả hôm nay). Khoảng thời gian này bắt đầu lúc nửa đêm vào ngày bạn gửi yêu cầu và kết thúc lúc 23:59 sáu ngày sau đó. Trường này bao gồm trường con special_days của tất cả giờ, được đặt cho những ngày có giờ đặc biệt.
current_secondary_opening_hours[]

OpeningHours

Chứa một mảng các mục nhập cho 7 ngày tiếp theo, bao gồm cả thông tin về giờ hoạt động phụ của doanh nghiệp. Giờ hoạt động phụ khác với giờ hoạt động chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ mua hàng ngay trên xe hoặc giờ giao hàng làm giờ hoạt động phụ. Trường này điền sẵn trường con type (loại). Trường này lấy từ danh sách các loại giờ mở cửa được xác định trước (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) dựa trên loại địa điểm. Trường này bao gồm trường con special_days của tất cả giờ, được đặt cho những ngày có giờ đặc biệt.
regular_secondary_opening_hours[]

OpeningHours

Chứa một mảng các mục nhập cho thông tin về giờ hoạt động phụ thông thường của một doanh nghiệp. Giờ hoạt động phụ khác với giờ hoạt động chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ mua hàng ngay trên xe hoặc giờ giao hàng làm giờ hoạt động phụ. Trường này điền sẵn trường con type (loại). Trường này lấy từ danh sách các loại giờ mở cửa được xác định trước (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) dựa trên loại địa điểm.
editorial_summary

LocalizedText

Chứa thông tin tóm tắt về địa điểm. Tóm tắt bao gồm nội dung tổng quan dạng văn bản và cũng bao gồm mã ngôn ngữ cho các nội dung này (nếu có). Văn bản tóm tắt phải được trình bày nguyên trạng và không được sửa đổi hoặc thay đổi.
payment_options

PaymentOptions

Các phương thức thanh toán mà địa điểm chấp nhận. Nếu không có dữ liệu về phương thức thanh toán, trường phương thức thanh toán sẽ không được đặt.
parking_options

ParkingOptions

Các lựa chọn đỗ xe do địa điểm cung cấp.
sub_destinations[]

SubDestination

Danh sách các đích đến phụ liên quan đến địa điểm.
fuel_options

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.
ev_charge_options

EVChargeOptions

Thông tin về các lựa chọn sạc xe điện.
generative_summary

GenerativeSummary

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

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

AreaSummary

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Bản tóm tắt do AI tạo về khu vực nơi địa điểm đó tọa lạc.
containing_places[]

ContainingPlace

Danh sách các địa điểm nơi địa điểm hiện tại tọa lạc.
address_descriptor

AddressDescriptor

Chỉ số mô tả địa chỉ của địa điểm. Thông tin mô tả địa chỉ bao gồm thông tin bổ sung giúp mô tả một vị trí bằng các địa danh và khu vực. Xem phạm vi cung cấp tính năng mô tả địa chỉ theo khu vực tại https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
price_range

PriceRange

Phạm vi giá liên kết với một Địa điểm.
utc_offset_minutes

int32

Số phút múi giờ của địa điểm này hiện chênh lệch so với UTC. Giá trị này được thể hiện bằng phút để hỗ trợ các múi giờ bị chênh lệch theo phần của giờ, ví dụ: X giờ và 15 phút.
time_zone

TimeZone

Múi giờ của Cơ sở dữ liệu múi giờ IANA. Ví dụ: "America/New_York".
user_rating_count

int32

Tổng số bài đánh giá (kèm theo hoặc không kèm theo nội dung) cho địa điểm này.
takeout

bool

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ mang đi hay không.
delivery

bool

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ giao hàng hay không.
dine_in

bool

Chỉ định xem doanh nghiệp có hỗ trợ chỗ ngồi trong nhà hay ngoài trời hay không.
curbside_pickup

bool

Chỉ định xem doanh nghiệp có hỗ trợ dịch vụ đến lấy hàng tại lề đường hay không.
reservable

bool

Chỉ định xem địa điểm có hỗ trợ đặt chỗ hay không.
serves_breakfast

bool

Chỉ định xem địa điểm đó có phục vụ bữa sáng hay không.
serves_lunch

bool

Chỉ định liệu địa điểm đó có phục vụ bữa trưa hay không.
serves_dinner

bool

Chỉ định xem địa điểm đó có phục vụ bữa tối hay không.
serves_beer

bool

Chỉ định xem địa điểm đó có phục vụ bia hay không.
serves_wine

bool

Chỉ định xem địa điểm đó có phục vụ rượu vang hay không.
serves_brunch

bool

Chỉ định xem địa điểm đó có phục vụ bữa sáng muộn hay không.
serves_vegetarian_food

bool

Chỉ định xem địa điểm có phục vụ đồ ăn chay hay không.
outdoor_seating

bool

Địa điểm này có chỗ ngồi ngoài trời.
live_music

bool

Địa điểm này có chương trình nhạc sống.
menu_for_children

bool

Địa điểm này có thực đơn dành cho trẻ em.
serves_cocktails

bool

Địa điểm phục vụ cocktail.
serves_dessert

bool

Địa điểm phục vụ món tráng miệng.
serves_coffee

bool

Địa điểm phục vụ cà phê.
good_for_children

bool

Địa điểm phù hợp với trẻ em.
allows_dogs

bool

Địa điểm cho phép mang theo chó.
restroom

bool

Địa điểm có nhà vệ sinh.
good_for_groups

bool

Địa điểm phù hợp với các nhóm.
good_for_watching_sports

bool

Địa điểm phù hợp để xem các trận đấu thể thao.
accessibility_options

AccessibilityOptions

Thông tin về các lựa chọn hỗ trợ tiếp cận mà một địa điểm cung cấp.
pure_service_area_business

bool

Cho biết liệu địa điểm đó có phải là doanh nghiệp chỉ hoạt động trong khu vực kinh doanh hay không. Doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng là một doanh nghiệp trực tiếp cung cấp dịch vụ tận nơi hoặc giao hàng cho khách hàng, nhưng không phục vụ khách hàng tại địa chỉ của doanh nghiệp. Ví dụ: những doanh nghiệp cung cấp dịch vụ vệ sinh hoặc sửa ống nước. Những doanh nghiệp đó có thể không có địa chỉ thực tế hoặc vị trí trên Google Maps.

AccessibilityOptions

Thông tin về các lựa chọn hỗ trợ tiếp cận mà một địa điểm cung cấp.

Trường
wheelchair_accessible_parking

bool

Địa điểm có chỗ đỗ xe cho xe lăn.
wheelchair_accessible_entrance

bool

Địa điểm có lối vào dành cho xe lăn.
wheelchair_accessible_restroom

bool

Địa điểm có nhà vệ sinh cho xe lăn.
wheelchair_accessible_seating

bool

Địa điểm có chỗ ngồi cho xe lăn.

AddressComponent

Các thành phần có cấu trúc tạo thành địa chỉ được định dạng, nếu có thông tin này.

Trường
long_text

string

Nội dung mô tả đầy đủ hoặc tên của thành phần địa chỉ. Ví dụ: thành phần địa chỉ cho quốc gia Úc có thể có long_name là "Úc".
short_text

string

Tên văn bản viết tắt cho thành phần địa chỉ, nếu có. Ví dụ: thành phần địa chỉ cho quốc gia Úc có thể có short_name là "AU".
types[]

string

Một mảng cho biết(các) loại thành phần địa chỉ.
language_code

string

Ngôn ngữ dùng để định dạng thành phần này, theo ký hiệu CLDR.

AreaSummary

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Bản tóm tắt do AI tạo về khu vực nơi địa điểm đó tọa lạc.

Trường
content_blocks[]

ContentBlock

Các khối nội dung tạo nên phần tóm tắt khu vực. Mỗi khối có một chủ đề riêng về khu vực đó.
flag_content_uri

string

Đường liên kết mà người dùng có thể gắn cờ vấn đề với bản tóm tắt.

Phân bổ

Thông tin về nhà cung cấp dữ liệu của địa điểm này.

Trường
provider

string

Tên của nhà cung cấp dữ liệu của Địa điểm.
provider_uri

string

URI đến nhà cung cấp dữ liệu của Địa điểm.

BusinessStatus

Trạng thái kinh doanh của địa điểm.

Enum
BUSINESS_STATUS_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
OPERATIONAL Cơ sở này đang hoạt động nhưng không nhất thiết phải mở cửa ngay.
CLOSED_TEMPORARILY Cơ sở này tạm thời đóng cửa.
CLOSED_PERMANENTLY Cơ sở này đã đóng cửa vĩnh viễn.

ContainingPlace

Thông tin về vị trí của địa điểm này.

Trường
name

string

Tên tài nguyên của địa điểm nơi địa điểm này tọa lạc.
id

string

Mã địa điểm của địa điểm nơi địa điểm này tọa lạc.

GenerativeSummary

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

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

Trường
overview

LocalizedText

Thông tin tổng quan về địa điểm.
overview_flag_content_uri

string

Đường liên kết mà người dùng có thể gắn cờ một vấn đề kèm theo thông tin tóm tắt tổng quan.
description

LocalizedText

Nội dung mô tả chi tiết về địa điểm.
description_flag_content_uri

string

Đường liên kết mà người dùng có thể gắn cờ một vấn đề kèm theo nội dung mô tả tóm tắt.
references

References

Các tệp đối chiếu được dùng để tạo nội dung mô tả tóm tắt.

OpeningHours

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

Trường
periods[]

Period

Khoảng thời gian địa điểm này mở cửa trong tuần. Các khoảng thời gian được sắp xếp theo thứ tự thời gian, bắt đầu từ Chủ Nhật theo múi giờ địa phương của địa điểm. Giá trị trống (nhưng không phải là giá trị không có) cho biết một địa điểm không bao giờ mở cửa, ví dụ: vì địa điểm đó tạm thời đóng cửa để tu sửa.
weekday_descriptions[]

string

Chuỗi đã bản địa hoá mô tả giờ mở cửa của địa điểm này, mỗi ngày trong tuần có một chuỗi. Sẽ trống nếu không xác định được giờ hoặc không thể chuyển đổi thành văn bản đã bản địa hoá. Ví dụ: "Chủ Nhật: 18:00–06:00"
secondary_hours_type

SecondaryHoursType

Chuỗi loại dùng để xác định loại giờ phụ.
special_days[]

SpecialDay

Thông tin có cấu trúc cho các ngày đặc biệt nằm trong khoảng thời gian mà giờ mở cửa được trả về. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ hoạt động của một địa điểm, ví dụ: ngày Giáng sinh. Đặt cho current_opening_hours và current_secondary_opening_hours nếu có giờ làm việc đặc biệt.
next_open_time

Timestamp

Thời điểm tiếp theo mà khoảng thời gian giờ mở cửa hiện tại bắt đầu, tối đa là 7 ngày trong tương lai. Trường này chỉ được điền nếu khoảng thời gian mở cửa không hoạt động tại thời điểm phân phát yêu cầu.
next_close_time

Timestamp

Thời điểm tiếp theo mà khoảng thời gian giờ mở cửa hiện tại kết thúc, tối đa là 7 ngày trong tương lai. Trường này chỉ được điền nếu khoảng thời gian mở cửa đang hoạt động tại thời điểm phân phát yêu cầu.
open_now

bool

Khoảng thời gian mở cửa hiện có hiệu lực hay không. Đối với giờ mở cửa thông thường và giờ mở cửa hiện tại, trường này cho biết liệu địa điểm có mở cửa hay không. Đối với giờ mở cửa phụ và giờ mở cửa phụ hiện tại, trường này cho biết liệu giờ mở cửa phụ của địa điểm này có đang hoạt động hay không.

Khoảng thời gian

Khoảng thời gian địa điểm vẫn ở trạng thái open_now.

Trường
open

Point

Thời gian địa điểm bắt đầu mở cửa.
close

Point

Thời điểm địa điểm bắt đầu đóng cửa.

Điểm

Điểm thay đổi trạng thái.

Trường
date

Date

Ngày theo múi giờ địa phương của địa điểm.
truncated

bool

Liệu điểm cuối này có bị cắt bớt hay không. Việc cắt bớt xảy ra khi giờ thực tế nằm ngoài khoảng thời gian mà chúng ta muốn trả về giờ, vì vậy, chúng ta sẽ cắt bớt giờ về các ranh giới này. Điều này đảm bảo rằng hệ thống sẽ trả về kết quả trong tối đa 24 * 7 giờ kể từ nửa đêm của ngày nhận yêu cầu.
day

int32

Ngày trong tuần, dưới dạng số nguyên trong phạm vi 0-6. 0 là Chủ Nhật, 1 là thứ Hai, v.v.
hour

int32

Giờ theo định dạng 24 giờ. Phạm vi từ 0 đến 23.
minute

int32

Phút. Phạm vi từ 0 đến 59.

SecondaryHoursType

Loại dùng để xác định loại giờ phụ.

Enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Giá trị mặc định khi bạn không chỉ định loại giờ phụ.
DRIVE_THROUGH Giờ hoạt động của dịch vụ mua hàng không cần xuống xe tại ngân hàng, nhà hàng hoặc hiệu thuốc.
HAPPY_HOUR Giờ vàng.
DELIVERY Giờ giao hàng.
TAKEOUT Giờ mua mang đi.
KITCHEN Giờ làm bếp.
BREAKFAST Giờ ăn sáng.
LUNCH Giờ ăn trưa.
DINNER Giờ ăn tối.
BRUNCH Giờ ăn sáng muộn.
PICKUP Giờ đến lấy hàng.
ACCESS Giờ truy cập vào các địa điểm lưu trữ.
SENIOR_HOURS Giờ đặc biệt dành cho người cao tuổi.
ONLINE_SERVICE_HOURS Giờ phục vụ trực tuyến.

SpecialDay

Thông tin có cấu trúc cho các ngày đặc biệt nằm trong khoảng thời gian mà giờ mở cửa được trả về. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ hoạt động của một địa điểm, ví dụ: ngày Giáng sinh.

Trường
date

Date

Ngày của ngày đặc biệt này.

ParkingOptions

Thông tin về các lựa chọn đỗ xe tại địa điểm đó. Một bãi đỗ xe có thể hỗ trợ nhiều lựa chọn cùng một lúc.

Trường
free_parking_lot

bool

Địa điểm này có bãi đỗ xe miễn phí.
paid_parking_lot

bool

Địa điểm này có bãi đỗ xe có tính phí.
free_street_parking

bool

Chỗ đỗ xe miễn phí trên đường.
paid_street_parking

bool

Địa điểm này có chỗ đỗ xe có tính phí trên đường.
valet_parking

bool

Địa điểm này có dịch vụ đỗ xe.
free_garage_parking

bool

Nơi này có gara đỗ xe miễn phí.
paid_garage_parking

bool

Địa điểm này có gara đỗ xe có tính phí.

PaymentOptions

Các phương thức thanh toán mà địa điểm chấp nhận.

Trường
accepts_credit_cards

bool

Địa điểm chấp nhận thanh toán bằng thẻ tín dụng.
accepts_debit_cards

bool

Địa điểm này chấp nhận thanh toán bằng thẻ ghi nợ.
accepts_cash_only

bool

Địa điểm này chỉ chấp nhận thanh toán bằng tiền mặt. Những địa điểm có thuộc tính này vẫn có thể chấp nhận các phương thức thanh toán khác.
accepts_nfc

bool

Địa điểm chấp nhận thanh toán qua NFC.

PlusCode

Plus code (http://plus.codes) là một tệp tham chiếu vị trí có hai định dạng: mã toàn cầu xác định hình chữ nhật 14mx14m (1/8000 độ) hoặc nhỏ hơn và mã phức hợp, thay thế tiền tố bằng vị trí tham chiếu.

Trường
global_code

string

Mã toàn cầu (đầy đủ) của địa điểm, chẳng hạn như "9FWM33GV+HQ", đại diện cho một khu vực có kích thước 1/8000 độ x 1/8000 độ (~14 x 14 mét).
compound_code

string

Mã hợp chất của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Na Uy", chứa hậu tố của mã chung và thay thế tiền tố bằng tên được định dạng của một thực thể tham chiếu.

SubDestination

Tên tài nguyên và mã của các đích đến phụ liên quan đến địa điểm. Ví dụ: các ga là các đích đến khác nhau của một sân bay.

Trường
name

string

Tên tài nguyên của đích đến phụ.
id

string

Mã địa điểm của đích đến phụ.

Hình nhiều đường

Hình nhiều đường của tuyến đường. Chỉ hỗ trợ đường đa tuyến được mã hoá, có thể được truyền dưới dạng chuỗi và bao gồm cả tính năng nén với mức độ hao tổn tối thiểu. Đây là đầu ra mặc định của Routes API.

Trường
Trường hợp hợp nhất polyline_type. Đóng gói loại đường đa tuyến. Đầu ra API tuyến đường mặc định là encoded_polyline. polyline_type chỉ có thể là một trong những giá trị sau:
encoded_polyline

string

Một đường đa tuyến được mã hoá, do Routes API trả về theo mặc định. Xem các công cụ mã hoá và giải mã.

PriceLevel

Mức giá của địa điểm.

Enum
PRICE_LEVEL_UNSPECIFIED Mức giá của địa điểm chưa được chỉ định hoặc không xác định.
PRICE_LEVEL_FREE Địa điểm cung cấp dịch vụ miễn phí.
PRICE_LEVEL_INEXPENSIVE Địa điểm cung cấp các dịch vụ giá rẻ.
PRICE_LEVEL_MODERATE Địa điểm cung cấp các dịch vụ có mức giá vừa phải.
PRICE_LEVEL_EXPENSIVE Địa điểm này cung cấp các dịch vụ đắt đỏ.
PRICE_LEVEL_VERY_EXPENSIVE Địa điểm này cung cấp các dịch vụ rất đắt đỏ.

PriceRange

Phạm vi giá liên kết với một Địa điểm. Bạn có thể không đặt end_price, cho biết một dải ô không có giới hạn trên (ví dụ: "Trên 100 đô la").

Trường
start_price

Money

Mức giá thấp nhất trong phạm vi giá (bao gồm). Giá phải bằng hoặc cao hơn số tiền này.
end_price

Money

Mức giá cao nhất của phạm vi giá (không bao gồm). Giá phải thấp hơn số tiền này.

Tài liệu tham khảo

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Nội dung tham chiếu liên quan đến nội dung tạo sinh.

Trường
reviews[]

Review

Bài đánh giá đóng vai trò là tài liệu tham khảo.
places[]

string

Danh sách tên tài nguyên của các địa điểm được tham chiếu. Bạn có thể sử dụng tên này trong các API khác chấp nhận tên tài nguyên Địa điểm.

Xem xét

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

Trường
name

string

Một tệp tham chiếu đại diện cho bài đánh giá địa điểm này. Bạn có thể dùng tệp này để tra cứu lại bài đánh giá địa điểm này (còn gọi là tên "tài nguyên" của API: places/{place_id}/reviews/{review}).
relative_publish_time_description

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 ở dạng phù hợp với ngôn ngữ và quốc gia.
text

LocalizedText

Văn bản đã bản địa hoá của bài đánh giá.
original_text

LocalizedText

Văn bản bài đánh giá bằng ngôn ngữ gốc.
rating

double

Một số từ 1.0 đến 5.0, còn gọi là số lượng sao.
author_attribution

AuthorAttribution

Tác giả của bài đánh giá này.
publish_time

Timestamp

Dấu thời gian của bài đánh giá.
flag_content_uri

string

Đường liên kết mà người dùng có thể gắn cờ vấn đề về bài đánh giá.
google_maps_uri

string

Đường liên kết đến bài đánh giá trên Google Maps.

RouteModifiers

Đóng gói một tập hợp các điều kiện không bắt buộc để đáp ứng khi tính toán các tuyến đường.

Trường
avoid_tolls

bool

Không bắt buộc. Khi được đặt thành true, tính năng này sẽ tránh các đường có thu phí khi hợp lý, ưu tiên các tuyến không chứa đường có thu phí. Chỉ áp dụng cho DRIVE và TWO_WHEELER TravelMode.
avoid_highways

bool

Không bắt buộc. Khi được đặt thành true, chế độ này sẽ tránh đường cao tốc khi hợp lý, ưu tiên các tuyến không chứa đường cao tốc. Chỉ áp dụng cho DRIVE và TWO_WHEELER TravelMode.
avoid_ferries

bool

Không bắt buộc. Khi được đặt thành true, tính năng này sẽ tránh phà khi hợp lý, ưu tiên các tuyến không chứa phà. Chỉ áp dụng cho DRIVE và TWO_WHEELER TravelMode.
avoid_indoor

bool

Không bắt buộc. Khi được đặt thành đúng, tính năng này sẽ tránh điều hướng trong nhà khi hợp lý, ưu tiên các tuyến không chứa tính năng điều hướng trong nhà. Chỉ áp dụng cho WALK TravelMode.

RoutingParameters

Các tham số để định cấu hình tính toán định tuyến đến các địa điểm trong phản hồi, cả dọc theo một tuyến đường (nơi thứ hạng kết quả sẽ bị ảnh hưởng) và để tính thời gian di chuyển trên kết quả.

Trường
origin

LatLng

Không bắt buộc. Điểm gốc định tuyến rõ ràng ghi đè điểm gốc được xác định trong đường đa tuyến. Theo mặc định, gốc đường đa tuyến sẽ được sử dụng.
travel_mode

TravelMode

Không bắt buộc. Phương tiện đi lại.
route_modifiers

RouteModifiers

Không bắt buộc. Các đối tượng sửa đổi tuyến đường.
routing_preference

RoutingPreference

Không bắt buộc. Chỉ định cách tính toán bản tóm tắt định tuyến. Máy chủ sẽ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến. Lựa chọn ưu tiên định tuyến có tính đến tình trạng giao thông chỉ có sẵn cho DRIVE hoặc TWO_WHEELER travelMode.

RoutingPreference

Một tập hợp các giá trị chỉ định các yếu tố cần xem xét khi tính toán tuyến đường.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Chưa chỉ định lựa chọn ưu tiên định tuyến. Giá trị mặc định là TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Tính toán các tuyến đường mà không xem xét tình trạng giao thông thực tế. Phù hợp khi điều kiện giao thông không quan trọng hoặc không áp dụng. Việc sử dụng giá trị này sẽ tạo ra độ trễ thấp nhất. Lưu ý: Đối với TravelMode DRIVE và TWO_WHEELER, tuyến đường và thời lượng được chọn dựa trên mạng lưới đường và điều kiện giao thông trung bình không phụ thuộc vào thời gian, chứ không phải điều kiện đường hiện tại. Do đó, các tuyến đường có thể bao gồm những con đường tạm thời bị đóng. Kết quả cho một yêu cầu cụ thể có thể thay đổi theo thời gian do những thay đổi trong mạng lưới đường bộ, tình trạng giao thông trung bình mới cập nhật và bản chất phân phối của dịch vụ. Kết quả cũng có thể khác nhau giữa các tuyến gần tương đương bất cứ lúc nào hoặc theo tần suất.
TRAFFIC_AWARE Tính toán các tuyến đường có tính đến tình trạng giao thông trực tiếp. Ngược lại với TRAFFIC_AWARE_OPTIMAL, một số biện pháp tối ưu hoá được áp dụng để giảm đáng kể độ trễ.
TRAFFIC_AWARE_OPTIMAL Tính toán các tuyến đường có tính đến tình trạng giao thông trực tiếp mà không áp dụng hầu hết các tính năng tối ưu hoá hiệu suất. Việc sử dụng giá trị này sẽ tạo ra độ trễ cao nhất.

RoutingSummary

Thời lượng và khoảng cách từ điểm xuất phát của tuyến đường đến một địa điểm trong phản hồi, và chặng thứ hai từ địa điểm đó đến đích đến (nếu được yêu cầu). Lưu ý: Việc thêm routingSummaries vào mặt nạ trường mà không thêm tham số routingParameters.origin hoặc tham số searchAlongRouteParameters.polyline.encodedPolyline vào yêu cầu sẽ gây ra lỗi.

Trường
legs[]

Leg

Các chặng của chuyến đi.

Khi bạn tính thời gian và quãng đường di chuyển từ một điểm xuất phát đã đặt, legs sẽ chứa một chặng duy nhất chứa thời gian và quãng đường từ điểm xuất phát đến điểm đến. Khi bạn tìm kiếm dọc theo tuyến đường, legs sẽ chứa hai chặng: một chặng từ điểm xuất phát đến địa điểm và một chặng từ địa điểm đến điểm đến.
directions_uri

string

Đường liên kết để hiển thị thông tin chỉ đường trên Google Maps bằng các điểm trung gian trong bản tóm tắt tuyến đường đã cho. Đường dẫn do đường liên kết này tạo ra không được đảm bảo giống với đường dẫn dùng để tạo bản tóm tắt định tuyến. Đường liên kết này sử dụng thông tin được cung cấp trong yêu cầu, từ các trường bao gồm routingParameters và searchAlongRouteParameters (nếu có) để tạo đường liên kết đến chỉ đường.

Chân

Chuyến bay là một phần của hành trình từ địa điểm này đến địa điểm khác.

Trường
duration

Duration

Thời gian cần thiết để hoàn thành chặng này của chuyến đi.
distance_meters

int32

Khoảng cách của chặng này trong chuyến đi.

SearchNearbyRequest

Yêu cầu proto cho tính năng Tìm kiếm lân cận.

Trường
language_code

string

Thông tin chi tiết về địa điểm sẽ hiển thị bằng ngôn ngữ ưu tiên (nếu có). Nếu mã ngôn ngữ không được chỉ định hoặc không được nhận dạng, hệ thống có thể trả về thông tin chi tiết về vị trí bằng bất kỳ ngôn ngữ nào, ưu tiên tiếng Anh nếu có thông tin chi tiết như vậy.

Danh sách ngôn ngữ hiện được hỗ trợ: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Mã quốc gia/khu vực Unicode (CLDR) của vị trí nơi yêu cầu đến. Tham số này được dùng để hiển thị thông tin chi tiết về địa điểm, chẳng hạn như tên địa điểm theo khu vực (nếu có). Thông 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 không được hỗ trợ.
included_types[]

string

Loại địa điểm được đưa vào (ví dụ: "nhà_hàng" hoặc "trạm_xăng") từ https://developers.google.com/maps/documentation/places/web-service/place-types.

Bạn có thể chỉ định tối đa 50 loại trong Bảng A.

Nếu có bất kỳ loại nào xung đột, tức là một loại xuất hiện trong cả included_types và excluded_types, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Nếu bạn chỉ định một loại Địa điểm có nhiều quy định hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các quy định hạn chế đó mới được trả về. Ví dụ: nếu chúng ta có {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, thì những địa điểm được trả về sẽ cung cấp các dịch vụ liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
excluded_types[]

string

Loại Địa điểm bị loại trừ (ví dụ: "nhà_hàng" hoặc "trạm_xăng") trên https://developers.google.com/maps/documentation/places/web-service/place-types.

Bạn có thể chỉ định tối đa 50 loại trong Bảng A.

Nếu ứng dụng cung cấp cả included_types (ví dụ: nhà hàng) và excluded_types (ví dụ: quán cà phê), thì phản hồi phải bao gồm những địa điểm là nhà hàng nhưng không phải quán cà phê. Phản hồi bao gồm những địa điểm khớp với ít nhất một trong các included_types và không khớp với bất kỳ excluded_types nào.

Nếu có bất kỳ loại nào xung đột, tức là một loại xuất hiện trong cả included_types và excluded_types, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Nếu bạn chỉ định một loại Địa điểm có nhiều quy định hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các quy định hạn chế đó mới được trả về. Ví dụ: nếu chúng ta có {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, thì những địa điểm được trả về sẽ cung cấp các dịch vụ liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
included_primary_types[]

string

Đã thêm loại Địa điểm chính (ví dụ: "nhà_hàng" hoặc "trạm_xăng") từ https://developers.google.com/maps/documentation/places/web-service/place-types. Một địa điểm chỉ có thể có một loại chính trong bảng loại được hỗ trợ được liên kết với địa điểm đó.

Bạn có thể chỉ định tối đa 50 loại trong Bảng A.

Nếu có bất kỳ loại chính nào xung đột, tức là một loại xuất hiện trong cả included_primary_types và excluded_primary_types, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Nếu bạn chỉ định một loại Địa điểm có nhiều quy định hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các quy định hạn chế đó mới được trả về. Ví dụ: nếu chúng ta có {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, thì những địa điểm được trả về sẽ cung cấp các dịch vụ liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
excluded_primary_types[]

string

Loại Địa điểm chính bị loại trừ (ví dụ: "nhà_hàng" hoặc "trạm_xăng") từ https://developers.google.com/maps/documentation/places/web-service/place-types.

Bạn có thể chỉ định tối đa 50 loại trong Bảng A.

Nếu có bất kỳ loại chính nào xung đột, tức là một loại xuất hiện trong cả included_primary_types và excluded_primary_types, thì lỗi INVALID_ARGUMENT sẽ được trả về.

Nếu bạn chỉ định một loại Địa điểm có nhiều quy định hạn chế về loại, thì chỉ những địa điểm đáp ứng tất cả các quy định hạn chế đó mới được trả về. Ví dụ: nếu chúng ta có {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, thì những địa điểm được trả về sẽ cung cấp các dịch vụ liên quan đến "nhà hàng" nhưng không hoạt động chủ yếu dưới dạng "nhà hàng".
max_result_count

int32

Số kết quả tối đa cần trả về. Giá trị này phải nằm trong khoảng từ 1 đến 20 (mặc định), bao gồm cả hai giá trị này. Nếu bạn không đặt số này, thì số này sẽ quay lại giới hạn trên. Nếu số được đặt thành âm hoặc vượt quá giới hạn trên, hàm sẽ trả về lỗi INVALID_ARGUMENT.
location_restriction

LocationRestriction

Bắt buộc. Khu vực cần tìm kiếm.
rank_preference

RankPreference

Cách xếp hạng kết quả trong câu trả lời.
routing_parameters

RoutingParameters

Không bắt buộc. Các tham số ảnh hưởng đến việc định tuyến đến kết quả tìm kiếm.

LocationRestriction

Khu vực cần tìm kiếm.

Trường

Trường hợp hợp nhất type.

type chỉ có thể là một trong những giá trị sau:
circle

Circle

Một hình tròn được xác định bằng tâm điểm và bán kính.

RankPreference

Cách xếp hạng kết quả trong câu trả lời.

Enum
RANK_PREFERENCE_UNSPECIFIED Chưa đặt giá trị RankPreference. Sẽ sử dụng thứ hạng theo MỨC ĐỘ PHỔ BIẾN theo mặc định.
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.

SearchNearbyResponse

Tệp proto phản hồi cho tính năng Tìm kiếm lân cận.

Trường
places[]

Place

Danh sách các địa điểm đáp ứng yêu cầu của người dùng, chẳng hạn như loại địa điểm, số lượng địa điểm và quy định hạn chế về vị trí cụ thể.
routing_summaries[]

RoutingSummary

Danh sách tóm tắt định tuyến, trong đó mỗi mục nhập liên kết đến vị trí tương ứng trong cùng một chỉ mục trong trường places. Nếu không có thông tin tóm tắt về tuyến đường cho một trong các địa điểm, thì thông tin tóm tắt đó sẽ chứa một mục trống. Danh sách này phải có số mục nhập bằng với danh sách địa điểm nếu được yêu cầu.

SearchTextRequest

Yêu cầu proto cho SearchText.

Trường
text_query

string

Bắt buộc. Cụm từ tìm kiếm dạng văn bản.
language_code

string

Thông tin chi tiết về địa điểm sẽ hiển thị bằng ngôn ngữ ưu tiên (nếu có). Nếu mã ngôn ngữ không được chỉ định hoặc không được nhận dạng, hệ thống có thể trả về thông tin chi tiết về vị trí bằng bất kỳ ngôn ngữ nào, ưu tiên tiếng Anh nếu có thông tin chi tiết như vậy.

Danh sách ngôn ngữ hiện được hỗ trợ: https://developers.google.com/maps/faq#languagesupport.
region_code

string

Mã quốc gia/khu vực Unicode (CLDR) của vị trí nơi yêu cầu đến. Tham số này được dùng để hiển thị thông tin chi tiết về địa điểm, chẳng hạn như tên địa điểm theo khu vực (nếu có). Thông 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 không được hỗ trợ.
rank_preference

RankPreference

Cách xếp hạng kết quả trong câu trả lời.
included_type

string

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 đưa vào.
open_now

bool

Dùng để giới hạn kết quả tìm kiếm ở những địa điểm hiện đang mở cửa. Giá trị mặc định là "false".
min_rating

double

Lọc ra những kết quả có điểm xếp hạng trung bình của người dùng thấp hơn giới hạn này. Giá trị hợp lệ phải là số thực từ 0 đến 5 (bao gồm cả hai giá trị này) với tốc độ 0,5, tức là [0, 0,5, 1,0, ... , 5,0]. Mức phân loại đầu vào sẽ được làm tròn lên đến 0,5 gần nhất(giới hạn 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,0.
max_result_count
(deprecated)

int32

Không dùng nữa: Hãy sử dụng page_size.

Số kết quả tối đa trên mỗi trang có thể được trả về. Nếu số lượng kết quả có sẵn lớn hơn max_result_count, thì hệ thống sẽ trả về một next_page_token có thể được truyền đến page_token để lấy trang kết quả tiếp theo trong các yêu cầu tiếp theo. Nếu bạn cung cấp giá trị 0 hoặc không cung cấp giá trị nào, thì giá trị mặc định là 20 sẽ được sử dụng. Giá trị tối đa là 20; các giá trị trên 20 sẽ được chuyển đổi thành 20. Giá trị âm sẽ trả về lỗi INVALID_ARGUMENT.

Nếu bạn chỉ định cả max_result_count và page_size, thì max_result_count sẽ bị bỏ qua.
page_size

int32

Không bắt buộc. Số kết quả tối đa trên mỗi trang có thể được trả về. Nếu số lượng kết quả có sẵn lớn hơn page_size, thì hệ thống sẽ trả về một next_page_token có thể được truyền đến page_token để lấy trang kết quả tiếp theo trong các yêu cầu tiếp theo. Nếu bạn cung cấp giá trị 0 hoặc không cung cấp giá trị nào, thì giá trị mặc định là 20 sẽ được sử dụng. Giá trị tối đa là 20; các giá trị trên 20 sẽ được đặt thành 20. Giá trị âm sẽ trả về lỗi INVALID_ARGUMENT.

Nếu bạn chỉ định cả max_result_count và page_size, thì max_result_count sẽ bị bỏ qua.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi TextSearch trước đó. Cung cấp giá trị này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác ngoài page_token, page_size và max_result_count được cung cấp cho TextSearch phải khớp với lệnh gọi ban đầu đã cung cấp mã thông báo trang. Nếu không, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
price_levels[]

PriceLevel

Dùng để giới hạn phạm vi tìm kiếm ở những địa điểm được đánh dấu là ở một số mức giá nhất định. Người dùng có thể chọn bất kỳ tổ hợp cấp giá nào. Chọn tất cả các cấp giá theo mặc định.
strict_type_filtering

bool

Dùng để đặt tính năng lọc loại nghiêm ngặt cho included_type. Nếu bạn đặt giá trị này thành true, thì chỉ những kết quả thuộc cùng một loại mới được trả về. Giá trị mặc định là false.
location_bias

LocationBias

Khu vực cần tìm kiếm. Vị trí này đóng vai trò là độ lệch, tức là kết quả xung quanh vị trí đã cho có thể được trả về. Không thể đặt cùng với location_restriction.
location_restriction

LocationRestriction

Khu vực cần tìm kiếm. Vị trí này đóng vai trò là một quy tắc hạn chế, nghĩa 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 location_bias.
ev_options

EVOptions

Không bắt buộc. Đặt các tuỳ chọn xe điện có thể tìm kiếm của yêu cầu tìm kiếm địa điểm.
routing_parameters

RoutingParameters

Không bắt buộc. Các tham số bổ sung để định tuyến đến kết quả.
search_along_route_parameters

SearchAlongRouteParameters

Không bắt buộc. Proto tham số bổ sung để tìm kiếm dọc theo một tuyến đường.
include_pure_service_area_businesses

bool

Không bắt buộc. Bao gồm cả những doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng nếu bạn đặt trường này thành true. Doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng là một doanh nghiệp trực tiếp cung cấp dịch vụ tận nơi hoặc giao hàng cho khách hàng, nhưng không phục vụ khách hàng tại địa chỉ của doanh nghiệp. Ví dụ: những doanh nghiệp cung cấp dịch vụ vệ sinh hoặc sửa ống nước. Những doanh nghiệp đó không có địa chỉ thực tế hoặc vị trí trên Google Maps. Đối với những doanh nghiệp này, Places sẽ không trả về các trường bao gồm location, plus_code và các trường khác liên quan đến vị trí.

EVOptions

Các lựa chọn về xe điện có thể tìm kiếm của một yêu cầu tìm kiếm địa điểm.

Trường
minimum_charging_rate_kw

double

Không bắt buộc. Tốc độ sạc tối thiểu bắt buộc tính bằng kilowatt. Những địa điểm có mức giá sạc thấp hơn mức giá đã chỉ định sẽ bị lọc ra.
connector_types[]

EVConnectorType

Không bắt buộc. Danh sách các loại đầu nối xe điện ưu tiên. Những đị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.

LocationBias

Khu vực cần tìm kiếm. Vị trí này đóng vai trò là độ lệch, tức là kết quả xung quanh vị trí đã cho có thể được trả về.

Trường

Trường hợp hợp nhất type.

type chỉ có thể là một trong những giá trị sau:
rectangle

Viewport

Hộp hình chữ nhật được xác định bởi góc đông bắc và tây nam. rectangle.high() phải là điểm đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm tây nam của khung nhìn hình chữ nhật. rectangle.low().latitude() không được lớn hơn rectangle.high().latitude(). Điều này sẽ dẫn đến một dải vĩ độ trống. Khung nhìn hình chữ nhật không được rộng hơn 180 độ.
circle

Circle

Một hình tròn được xác định bằng tâm điểm và bán kính.

LocationRestriction

Khu vực cần tìm kiếm. Vị trí này đóng vai trò là một quy tắc hạn chế, nghĩa là hệ thống sẽ không trả về kết quả bên ngoài vị trí đã cho.

Trường

Trường hợp hợp nhất type.

type chỉ có thể là một trong những giá trị sau:
rectangle

Viewport

Hộp hình chữ nhật được xác định bởi góc đông bắc và tây nam. rectangle.high() phải là điểm đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm tây nam của khung nhìn hình chữ nhật. rectangle.low().latitude() không được lớn hơn rectangle.high().latitude(). Điều này sẽ dẫn đến một dải vĩ độ trống. Khung nhìn hình chữ nhật không được rộng hơn 180 độ.

RankPreference

Cách xếp hạng kết quả trong câu trả lời.

Enum
RANK_PREFERENCE_UNSPECIFIED Đối với cụm từ tìm kiếm theo danh mục như "Nhà hàng ở Thành phố New York", TƯƠNG ĐƯƠNG là tiêu chí mặc định. Đối với các cụm từ tìm kiếm không theo danh mục như "Mountain View, CA", bạn nên để rankPreference ở trạng thái chưa đặt.
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. Thứ tự sắp xếp do ngăn xếp xếp hạng thông thường xác định.

SearchAlongRouteParameters

Chỉ định một đa tuyến tính toán trước từ Routes API (API Tuyến đường) xác định tuyến đường cần tìm kiếm. Tìm kiếm dọc theo một tuyến đường cũng tương tự như sử dụng tuỳ chọn yêu cầu locationBias hoặc locationRestriction để thiên vị kết quả tìm kiếm. Tuy nhiên, mặc dù các tuỳ chọn locationBias và locationRestriction cho phép bạn chỉ định một khu vực để thiên vị kết quả tìm kiếm, nhưng tuỳ chọn này cho phép bạn thiên vị kết quả dọc theo tuyến đường đi.

Kết quả không được đảm bảo sẽ nằm dọc theo tuyến đường được cung cấp, mà được xếp hạng trong khu vực tìm kiếm do đường đa tuyến xác định và tuỳ ý theo locationBias hoặc locationRestriction dựa trên thời gian đi đường vòng tối thiểu từ điểm xuất phát đến điểm đến. Kết quả có thể nằm dọc theo một tuyến đường thay thế, đặc biệt là nếu đường đa tuyến được cung cấp không xác định tuyến đường tối ưu từ điểm xuất phát đến điểm đến.

Trường
polyline

Polyline

Bắt buộc. Hình nhiều đường của tuyến đường.

SearchTextResponse

Tệp proto phản hồi cho SearchText.

Trường
places[]

Place

Danh sách địa điểm đáp ứng tiêu chí tìm kiếm bằng văn bản của người dùng.
routing_summaries[]

RoutingSummary

Danh sách tóm tắt định tuyến, trong đó mỗi mục nhập liên kết đến vị trí tương ứng trong cùng một chỉ mục trong trường places. Nếu không có thông tin tóm tắt về tuyến đường cho một trong các địa điểm, thì thông tin tóm tắt đó sẽ chứa một mục trống. Danh sách này sẽ có nhiều mục nhập như danh sách địa điểm nếu được yêu cầu.
contextual_contents[]

ContextualContent

Thử nghiệm: Hãy xem https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm thông tin chi tiết.

Danh sách nội dung theo ngữ cảnh, trong đó mỗi mục liên kết với địa điểm tương ứng trong cùng một chỉ mục trong trường địa điểm. Nội dung liên quan đến text_query trong yêu cầu được ưu tiên. Nếu không có nội dung theo bối cảnh cho một trong các địa điểm, thì hệ thống sẽ trả về nội dung không theo bối cảnh. Thẻ này sẽ chỉ trống khi không có nội dung nào cho địa điểm này. Danh sách này sẽ có nhiều mục nhập như danh sách địa điểm nếu được yêu cầu.
next_page_token

string

Một mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua hoặc để trống trường này, thì sẽ không có trang tiếp theo.
search_uri

string

Đường liên kết cho phép người dùng tìm kiếm bằng chính cụm từ tìm kiếm dạng văn bản được chỉ định trong yêu cầu trên Google Maps.

TravelMode

Các lựa chọn về phương tiện đi lại. Các tuỳ chọn này liên kết với những gì Routes API cung cấp.

Enum
TRAVEL_MODE_UNSPECIFIED Chưa chỉ định phương tiện đi lại. Giá trị mặc định là DRIVE.
DRIVE Đi bằng ô tô.
BICYCLE Đi xe đạp. Không được hỗ trợ với search_along_route_parameters.
WALK Đi bộ. Không được hỗ trợ với search_along_route_parameters.
TWO_WHEELER Tất cả các loại xe hai bánh chạy bằng động cơ, chẳng hạn như xe tay ga và xe máy. Xin lưu ý rằng phương thức này khác với phương thức di chuyển BICYCLE bao gồm cả phương tiện di chuyển bằng sức người. Không được hỗ trợ với search_along_route_parameters. Chỉ được hỗ trợ ở những quốc gia được liệt kê tại phần Quốc gia và khu vực được hỗ trợ cho xe hai bánh.