Package google.maps.places.v1

Chỉ mục

Địa điểm

Định nghĩa dịch vụ cho Places API. Lưu ý: mọi yêu cầu (ngoại trừ các yêu cầu Tự động hoàn thành) đều phải có một mặt nạ trường (field mask) được đặt bên ngoài proto yêu cầu (không được giả định là all/*). Bạn có thể đặt mặt nạ cho trường (field mask) qua tiêu đề HTTP X-Goog-FieldMask. Hãy xem bài viết: 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.
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Nhận nội dung nghe nhìn dạng ảnh có chuỗi tham chiếu ảnh.
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

Lấy 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 đó, là một chuỗi ở định dạng places/{place_id}.
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Tìm địa điểm gần các địa điểm.
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Tìm kiếm địa điểm dựa trên truy vấn văn bản.

AuthorAttribution

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

Trường
display_name

string

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

string

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

string

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

AutocompletePlacesRequest

Yêu cầu proto cho tính năng tự động hoàn thành địa điểm.

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. Bù trừ kết quả tới một vị trí được chỉ định.

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

LocationRestriction

Không bắt buộc. Hạn chế kết quả trong một vị trí được chỉ định.

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

string

Không bắt buộc. Bao gồm loại Địa điểm chính (ví dụ: "nhà hàng" hoặc "gas_station") từ https://developers.google.com/maps/documentation/places/web-service/place-types. Địa điểm chỉ được trả về nếu loại chính của địa điểm đó được đưa vào danh sách này. Bạn có thể chỉ định tối đa 5 giá trị. Nếu không có loại nào được chỉ định, 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ả trong các khu vực được chỉ định, được chỉ định ở mức tối đa 15 mã vùng hai ký tự CLDR. Việc để trống nhóm sẽ không hạn chế các kết quả. Nếu bạn đặt cả location_restriction và included_region_codes, kết quả sẽ nằm trong khu vực giao nhau.
language_code

string

Không bắt buộc. Ngôn ngữ mà kết quả trả về. Giá trị mặc định là en-US. Kết quả có thể 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ự CLDR. Điều này ảnh hưởng đến định dạng địa chỉ, thứ hạng của kết quả và có thể ảnh hưởng đến những kết quả được trả về. Điều này không hạn chế kết quả trong khu vực được chỉ định. Để chỉ hiển thị kết quả theo một khu vực, hãy dùng region_code_restriction.
origin

LatLng

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

int32

Không bắt buộc. Độ lệch 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 những truy vấn dự đoán được trả về.

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

bool

Không bắt buộc. Nếu đúng, câu trả lời sẽ bao gồm cả các gợi ý về địa điểm và truy vấn. Nếu không, câu trả lời sẽ chỉ trả về các gợi ý về Địa điểm.
session_token

string

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

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 cuộc 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 Thông tin chi tiết về địa điểm hoặc Yêu cầu xác thực địa chỉ. Thông tin đăng nhập được dùng cho từng 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 này không còn hợp lệ nữa. Ứng dụng phải tạo một mã thông báo mới cho mỗi phiên. Nếu tham số session_token bị bỏ qua hoặc nếu bạn sử dụng lại mã thông báo phiên, thì phiên hoạt động 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ã phiên cho tất cả các lệnh gọi Tự động hoàn thành địa điểm.
  • Tạo một mã thông báo mới cho mỗi phiên. Bạn nên sử dụng mã nhận dạng duy nhất (UUID) phiên bản 4.
  • Đảm bảo rằng thông tin đăng nhập được dùng cho tất cả yêu cầu Tự động hoàn thành về địa điểm, Chi tiết địa điểm và Xác thực địa chỉ trong một phiên đều thuộc cùng một dự á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.

LocationBias

Khu vực sẽ tìm kiếm. Kết quả có thể không chính xác xung quanh khu vực được chỉ định.

Trường

Trường hợp type.

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

Viewport

Một khung nhìn được xác định bởi một góc ở phía Đông Bắc và một góc Tây Nam.
circle

Circle

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

LocationRestriction

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

Trường

Trường hợp type.

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

Viewport

Một khung nhìn được xác định bởi một góc ở phía Đông Bắc và một góc Tây Nam.
circle

Circle

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

AutocompletePlacesResponse

Proto phản hồi cho AutofillPlace.

Trường
suggestions[]

Suggestion

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

Đề xuất

Kết quả đề xuất Tự động hoàn thành.

Trường

Trường hợp kind.

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

PlacePrediction

Dự đoán cho một Địa điểm.
query_prediction

QueryPrediction

Dự đoán cho một truy vấn.

FormattableText

Văn bản biểu thị thông tin dự đoán về Địa điểm hoặc cụm từ tìm kiếm. Văn bản có thể được sử dụng nguyên trạng hoặc định dạng.

Trường
text

string

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

StringRange

Danh sách các dả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 kết quả trùng khớp được xác định bằng các tiêu chí khác ngoài việc so khớp chuỗi (ví dụ: sửa lỗi chính tả hoặc chuyển tự).

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

PlacePrediction

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

Trường
place

string

Tên tài nguyên của Địa điểm được đề xuất. Tên này có thể được sử dụng 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. Số nhận dạng này có thể được sử dụng trong các API khác chấp nhận ID địa điểm.
text

FormattableText

Chứa tên mà con người có thể đọc được của kết quả được trả về. Đối với kết quả thành lập, đây thường là tên và địa chỉ doanh nghiệp.

text được đề xuất cho các 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ác nhà phát triển muốn hiển thị 2 thành phần giao diện người dùng riêng biệt nhưng có liên quan đến giao diện người dùng có thể muốn sử dụng structured_format. Hai cách để thể hiện thông tin dự đoán về địa điểm là hai cách khác nhau. 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ể hỗ trợ nhiều ngôn ngữ nếu yêu cầu input và language_code bằng các ngôn ngữ khác nhau 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

Bảng chi tiết dự đoán Địa điểm thành văn bản chính có chứa tên của Địa điểm và văn bản phụ chứa các đối tượng phân biệt bổ sung (chẳng hạn như một thành phố hoặc khu vực).

structured_format được đề xuất cho các nhà phát triển muốn hiển thị 2 thành phần giao diện người dùng riêng biệt nhưng có liên quan với nhau. Các 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ể nên sử dụng text. Hai cách để thể hiện thông tin dự đoán về địa điểm là hai cách khác nhau. 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 phù hợp với Địa điểm này trong Bảng A hoặc Bảng B trong https://developers.google.com/maps/documentation/places/web-service/place-types.

Một loại là phân loại một Địa điểm. Các địa điểm có loại chung sẽ có các đặc điểm tương tự.
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ố dự đoán như tuyến đường có thể không được điền vào trường này.

QueryPrediction

Kết quả dự đoán cho cụm từ dự đoán Tự động hoàn thành truy vấn.

Trường
text

FormattableText

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

text được đề xuất cho các 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ác nhà phát triển muốn hiển thị 2 thành phần giao diện người dùng riêng biệt nhưng có liên quan đến giao diện người dùng có thể muốn sử dụng structured_format. Đây là 2 cách thể hiện thông tin dự đoán của cụm từ tìm kiế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.

Có thể hỗ trợ nhiều ngôn ngữ nếu yêu cầu input và language_code bằng các ngôn ngữ khác nhau hoặc nếu một phần của truy vấn không có bản dịch từ ngôn ngữ địa phương sang language_code.
structured_format

StructuredFormat

Bảng chi tiết 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 đối tượng riêng biệt khác (chẳng hạn như một thành phố hoặc vùng).

structured_format được đề xuất cho các nhà phát triển muốn hiển thị 2 thành phần giao diện người dùng riêng biệt nhưng có liên quan với nhau. Các 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ể nên sử dụng text. Đây là 2 cách thể hiện thông tin dự đoán của cụm từ tìm kiế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.

StringRange

Xác định 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).
end_offset

int32

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

StructuredFormat

Chứa bảng chi tiết dự đoán địa điểm hoặc truy vấn thành văn bản chính và văn bản phụ.

Đối với các dự đoán về Địa điểm, văn bản chính có chứa tên cụ thể của Địa điểm đó. Đối với các truy vấn dự đoán, văn bản chính sẽ chứa truy vấn đó.

Văn bản phụ chứa các đối tượng địa lý khác biệt bổ sung (chẳng hạn như một thành phố hoặc vùng) để xác định thêm Địa điểm hoặc tinh chỉnh truy vấn.

Trường
main_text

FormattableText

Đại diện cho tên của Địa điểm hoặc truy vấn.
secondary_text

FormattableText

Đại diện cho các đối tượng địa lý khác nhau (chẳng hạn như một thành phố hoặc khu vực) để xác định thêm Địa điểm hoặc tinh chỉnh truy vấn.

Hình tròn

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

Trường
center

LatLng

Bắt buộc. Vĩ độ và kinh độ ở giữa.

Phạm vi vĩ độ phải nằm trong khoảng [-90.0, 90.0]. Phạm vi 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 phạm vi [0.0, 50000.0].

ContentBlock

Một khối nội dung có thể 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 truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Tệp đối chiếu liên quan đến khối nội dung này.

ContextualContent

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Nội dung theo ngữ cảnh đối với cụm từ tìm kiếm về địa điểm.

Trường
reviews[]

Review

Danh sách các bài đánh giá về địa điểm này, ngoại trừ cụm từ tìm kiếm về địa điểm.
photos[]

Photo

Thông tin (bao gồm cả nội dung tham khảo) về ảnh của địa điểm này, liên quan đến cụm từ tìm kiếm về địa điểm.
justifications[]

Justification

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Lý do cho địa điểm.

Lý giải

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Lý do cho địa điểm. Lý do giải đáp cho câu hỏi tại sao một địa điểm có thể thu hút người dùng cuối.

Trường

Trường hợp justification.

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

ReviewJustification

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.
business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

BusinessAvailabilityAttributesJustification

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết. Lý do của Business tứcAttributes. Biểu đồ này cho thấy một số đặc điểm của doanh nghiệp có thể thu hút người dùng cuối.

Trường
takeout

bool

Nếu một địa điểm cung cấp đồ ăn mang đi.
delivery

bool

Nếu một địa điểm có cung cấp dịch vụ giao hàng.
dine_in

bool

Nếu một địa điểm cung cấp dịch vụ ăn uống.

ReviewJustification

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Lý do của bài đánh giá của người dùng. Thao tác này sẽ làm nổi bật một phần trong bài đánh giá của người dùng mà người dùng cuối sẽ quan tâm. Ví dụ: nếu cụm từ tìm kiếm là "bánh pizza củi", thì lý do đánh giá sẽ tô sáng phần 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á dùng để tạo văn bản được đánh dấu.

HighlightedText

Văn bản được làm nổi bật bên cạnh phần giải thích. Đây là một phần trong quá trình đánh giá. Từ chính xác cần làm nổi bật được đánh dấu bằng HighlightedTextRange. Văn bản có thể có một số từ đang được đánh dấu.

Trường
text

string
highlighted_text_ranges[]

HighlightedTextRange

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

HighlightedTextRange

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

Trường
start_index

int32
end_index

int32

EVChargeOptions

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

Trường
connector_count

int32

Số lượng giắc cắm tại trạm này. Tuy nhiên, vì một số cổng có thể có nhiều giắc cắm nhưng chỉ có thể sạc mỗi lần một ô tô (ví dụ: số lượng giắc cắm 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ổng hợp giắc cắm sạc xe điện có chứa các giắc cắm cùng loại và cùng tốc độ sạc.

ConnectorAggregation

Thông tin về trạm sạc xe điện được nhóm theo [loại, max_charge_rate_kw]. Cho thấy cách tổng hợp phí xe điện của các giắc cắm 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 phương thức 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 trình kết nối trong dữ liệu tổng hợp.
count

int32

Số 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 khi thông tin về khả năng sử dụng trình kết nối trong bảng tổng hợp này được cập nhật lần gần đây nhất.
available_count

int32

Số lượng trình kết nối hiện có trong dữ liệu tổng hợp này.
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 truy cập vào http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 để biết thêm thông tin/ngữ cảnh về các loại giắc cắm sạc xe điện.

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Trình kết nối chưa được chỉ định.
EV_CONNECTOR_TYPE_OTHER Các loại trình kết nối khác.
EV_CONNECTOR_TYPE_J1772 J1772 đầu nối 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 Trình kết 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 Loại 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Hệ thống sạc kết hợp (AC và DC). Dựa trên giắc cắm Mennekes Type-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 nơi khác trên thế giới (ví dụ: CCS Kết hợp 2 (CCS2) hoặc GB/T). Giá trị này ít đại diện cho loại giắc cắm thực tế hơn và thể hiện khả năng sạc xe ô tô thương hiệu Tesla tại trạm sạc thuộc sở hữu của Tesla.
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.

FuelOptions

Thông tin mới nhất về các lựa chọn nhiên liệu tại 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 đã biết gần đây nhất cho mỗi loại nhiên liệu mà trạm này có. Có một mục nhập cho mỗi loại nhiên liệu mà trạm này có. Thứ tự không quan trọng.

FuelPrice

Thông tin về giá nhiên liệu cho một loại cụ thể.

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 chưa xác định.
DIESEL Nhiên liệu diesel.
REGULAR_UNLEADED Thông thường không dẫn.
MIDGRADE Loại trung.
PREMIUM Đặc biệt.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 Số SP 100.
LPG Khí dầu mỏ hoá lỏng (LPG).
E80 E 80.
E85 E 85.
METHANE Khí mêtan.
BIO_DIESEL Dầu diesel sinh học.
TRUCK_DIESEL Xe tải diesel.

GetPhotoMediaRequest

Yêu cầu tìm nạp ảnh về một địa điểm bằng cách sử dụng tên tài nguyên ảnh.

Trường
name

string

Bắt buộc. Tên tài nguyên của một 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 một ả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 nối /media vào cuối tài nguyên ảnh để lấy tên tài nguyên nội dung nghe nhìn.
max_width_px

int32

Không bắt buộc. Chỉ định chiều rộng tối đa mong muốn của hình ảnh, tính bằng pixel. Nếu hình ảnh nhỏ hơn giá trị đã chỉ định, hệ thống sẽ trả về hình ảnh gốc. Nếu hình ảnh lớn hơn ở cả hai chiều, thì 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 chiều, bị giới hạn ở tỷ lệ khung hình gốc. Cả thuộc tính max_height_px và max_width_px đều chấp nhận số nguyên từ 1 đến 4800. Nếu giá trị không nằm trong phạm vi cho phép, hệ thống sẽ trả về lỗi INVALID_ACCOUNT.

Cần chỉ định ít nhất một trong số max_height_px hoặc max_width_px. Nếu bạn không chỉ định max_height_px và max_width_px thì lỗi INVALID_ đã được trả về.
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 giá trị đã chỉ định, hệ thống sẽ trả về hình ảnh gốc. Nếu hình ảnh lớn hơn ở cả hai chiều, thì 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 chiều, bị giới hạn ở tỷ lệ khung hình gốc. Cả thuộc tính max_height_px và max_width_px đều chấp nhận số nguyên từ 1 đến 4800. Nếu giá trị không nằm trong phạm vi cho phép, hệ thống sẽ trả về lỗi INVALID_ACCOUNT.

Cần chỉ định ít nhất một trong số max_height_px hoặc max_width_px. Nếu bạn không chỉ định max_height_px và max_width_px thì lỗi INVALID_ đã được trả về.
skip_http_redirect

bool

Không bắt buộc. Nếu bạn đặt chính sách này, 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 chính sách này, một lệnh chuyển hướng HTTP sẽ được tạo để chuyển hướng lệnh gọi đến phương tiện truyền thông hình ảnh. Tùy 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 đó, 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ẽ được hiển thị bằng ngôn ngữ ưu tiên (nếu có).

Danh sách các 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í xuất phát yêu cầu. Tham số này 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 cụ thể, nếu có. Tham 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 truy cập vào 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 phiên Tự động hoàn thành cho mục đích thanh toán. Phải là chuỗi base64 an toàn cho URL và tên tệp, có độ dài tối đa là 36 ký tự ASCII. Nếu không, hệ thống sẽ trả về lỗi INVALID_ qu.

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 cuộc 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 Thông tin chi tiết về địa điểm hoặc Yêu cầu xác thực địa chỉ. Thông tin đăng nhập được dùng cho từng 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 này không còn hợp lệ nữa. Ứng dụng phải tạo một mã thông báo mới cho mỗi phiên. Nếu tham số session_token bị bỏ qua hoặc nếu bạn sử dụng lại mã thông báo phiên, thì phiên hoạt động 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ã phiên cho tất cả các lệnh gọi Tự động hoàn thành địa điểm.
  • Tạo một mã thông báo mới cho mỗi phiên. Bạn nên sử dụng mã nhận dạng duy nhất (UUID) phiên bản 4.
  • Đảm bảo rằng thông tin đăng nhập được dùng cho tất cả yêu cầu Tự động hoàn thành về địa điểm, Chi tiết địa điểm và Xác thực địa chỉ trong một phiên đều thuộc cùng một dự á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. Tệp đối chiếu đại diện cho hình ảnh địa điểm này có thể dùng để tra cứu lại ảnh địa điểm này (còn được 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 hiện có, tính bằng pixel.
height_px

int32

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

AuthorAttribution

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

PhotoMedia

Nội dung nghe nhìn dạng ảnh từ Places API.

Trường
name

string

Tên tài nguyên của một 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 để kết xuất ả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ể được sử 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 được bản địa hoá của địa điểm, phù hợp với một bản mô tả ngắn mà con người có thể đọc được. Ví dụ: "Google Sydney", " mượt mà", "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". Để xem 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ợ Places API. 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 duy nhất. Để xem 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á sang ngôn ngữ yêu cầu (nếu có). Để xem 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 mà con người có thể đọc được của địa điểm, ở định dạng quốc gia.
international_phone_number

string

Số điện thoại mà con người có thể đọc được của địa điểm, ở định dạng quốc tế.
formatted_address

string

Địa chỉ đầy đủ, con người có thể đọc được cho địa điểm này.
short_formatted_address

string

Địa chỉ ngắn, mà con người có thể đọc được cho địa điểm này.
address_components[]

AddressComponent

Các thành phần được lặp lại cho từng cấp tổ dân phố. Lưu ý các thông tin thực tế sau về mảng địa chỉ [address]: – Mảng địa chỉ có thể chứa nhiều thành phần hơn so với địa chỉ được định dạng. - Mảng này không nhất thiết bao gồm tất cả các pháp nhân chính trị có chứa địa chỉ, ngoài những pháp nhân có trong format_address. Để truy xuất tất cả các pháp nhân chính trị có chứa một địa chỉ cụ thể, bạn phải sử dụng mã hóa địa lý ngược, chuyển vĩ độ/kinh độ của địa chỉ dưới dạng tham số tới yêu cầu. – Định dạng của phản hồi không được đảm bảo giống nhau giữa các yêu cầu. Cụ thể, số lượng địa chỉ_thành phần thay đổi dựa trên đị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 của 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 đó.
plus_code

PlusCode

Mã cộng của vị trí địa điểm vĩ độ/kinh độ.
location

LatLng

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

Viewport

Chế độ xem thích hợp để hiển thị địa điểm trên bản đồ có kích thước trung bình.
rating

double

Điểm 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.
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 của địa điểm này, ví dụ: trang chủ của một doanh nghiệp. Xin lưu ý rằng đối với những địa điểm thuộc một chuỗi (ví dụ: cửa hàng IKEA), đây thường là trang web của từng cửa hàng riêng lẻ, chứ không phải toàn bộ chuỗi.
reviews[]

Review

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

OpeningHours

Giờ làm việc thông thường.
photos[]

Photo

Thông tin (bao gồm cả tài liệu tham khảo) về hình ả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 ở vi định dạng quảng cáo: http://microformats.org/wiki/adr.
business_status

BusinessStatus

Trạng thái doanh nghiệp 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 được 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 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ờ làm việc trong 7 ngày tiếp theo (bao gồm cả hôm nay). Khoảng thời gian này bắt đầu lúc nửa đêm ngày yêu cầu và kết thúc lúc 23:59 tối sáu ngày sau đó. Trường này bao gồm trường con Special_days cho tất cả các giờ, được đặt cho những ngày có giờ đặc biệt.
current_secondary_opening_hours[]

OpeningHours

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

OpeningHours

Chứa một loạt các mục nhập thông tin về giờ phụ thông thường của một doanh nghiệp. Giờ phụ khác với giờ chính của doanh nghiệp. Ví dụ: nhà hàng có thể chỉ định giờ mua hàng trên xe hoặc giờ giao hàng làm giờ phụ. Trường này điền sẵn trường con loại. Trường này lấy từ danh sách các loại giờ mở cửa định sẵn (chẳng hạn như DRIVE_PASS, PickUP hoặc nhớOUT) 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. Bản tóm tắt bao gồm thông tin tổng quan dạng văn bản và cũng bao gồm mã ngôn ngữ cho những 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 thể sửa đổi hoặc thay đổi.
payment_options

PaymentOptions

Các lựa chọn thanh toán mà địa điểm chấp nhận. Nếu không có dữ liệu về lựa chọn thanh toán, trường tuỳ chọn thanh toán sẽ bị huỷ thiết lập.
parking_options

ParkingOptions

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

SubDestination

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

FuelOptions

Thông tin mới nhất về các lựa chọn nhiên liệu tại 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.
generative_summary

GenerativeSummary

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm 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 truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Bản tóm tắt do AI tạo về khu vực có đị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 với giờ UTC. Giá trị này được biểu thị bằng phút để hỗ trợ các múi giờ được bù theo phân số của một giờ, ví dụ: X giờ và 15 phút.
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ợ tính năng trích xuất hay không.
delivery

bool

Chỉ rõ liệu doanh nghiệp có hỗ trợ giao hàng hay không.
dine_in

bool

Chỉ định liệu doanh nghiệp có hỗ trợ các loại chỗ ngồi trong nhà hoặc ngoài trời hay không.
curbside_pickup

bool

Chỉ định xem doanh nghiệp có hỗ trợ nhận hàng ở lề đường hay không.
reservable

bool

Chỉ rõ đị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 ăn 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 này 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 có chỗ ngồi ngoài trời.
live_music

bool

Địa điểm có nhạc sống.
menu_for_children

bool

Địa điểm 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 cho trẻ em.
allows_dogs

bool

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

bool

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

bool

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

bool

Địa điểm này thích hợp để xem thể thao.
accessibility_options

AccessibilityOptions

Thông tin về các phương án hỗ trợ người khuyết tật mà một địa điểm cung cấp.

AccessibilityOptions

Thông tin về các phương án hỗ trợ người khuyết tật 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

Các địa điểm có lối vào 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ỉ đã đị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ó tên 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ụ: một thành phần địa chỉ cho quốc gia của Úc có thể có tên ngắn là "AU".
types[]

string

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

string

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

AreaSummary

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

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

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 đó.

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 nhà cung cấp dữ liệu cho Địa điểm.
provider_uri

string

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

BusinessStatus

Trạng thái doanh nghiệp 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 và chưa nhất thiết phải mở cửa.
CLOSED_TEMPORARILY Cơ sở này đang tạm thời đóng cửa.
CLOSED_PERMANENTLY Cơ sở này đã đóng cửa vĩnh viễn.

GenerativeSummary

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm 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.
description

LocalizedText

Mô tả chi tiết về địa điểm.
references

References

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ờ làm việc của địa điểm.

Trường
periods[]

Period

Các khoảng thời gian mà địa điểm này mở cửa trong tuần. Các khoảng thời gian được sắp xếp theo trình tự thời gian, bắt đầu từ Chủ Nhật theo múi giờ địa phương – địa điểm. Giá trị trống (nhưng không vắng mặt) 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 để nâng cấp.
weekday_descriptions[]

string

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

SecondaryHoursType

Một 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 những ngày đặc biệt nằm trong khoảng thời gian áp dụng cho giờ mở cửa đã trả lại. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ làm việc của một địa điểm, ví dụ: ngày Giáng sinh. Đặt giá trị current_opening_hours và current_secondary_opening_hours nếu có giờ đặc biệt.
open_now

bool

Địa điểm này có đang mở cửa không? Luôn hiển thị trừ phi chúng tôi thiếu dữ liệu thời gian trong ngày hoặc múi giờ cho những giờ mở cửa này.

Khoảng thời gian

Một khoảng thời gian mà địa điểm này vẫn ở trạng thái open_now.

Trường
open

Point

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

Point

Thời gian 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. Rút ngắn xảy ra khi giờ thực tế nằm ngoài thời gian mà chúng ta sẵn sàng trả về các giờ, vì vậy chúng ta cắt ngắn giờ về các ranh giới này. Điều này đảm bảo rằng hệ thống sẽ trả về tối đa 24 * 7 giờ kể từ nửa đêm của ngày yêu cầu được trả về.
day

int32

Một 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ờ có 2 chữ số. Phạm vi từ 00 đến 23.
minute

int32

Phút có 2 chữ số. Phạm vi từ 00 đế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 loại giờ phụ không được chỉ định.
DRIVE_THROUGH Giờ mua hàng trên xe đối với các 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ờ bán đồ ăn 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 đối với 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 những ngày đặc biệt nằm trong khoảng thời gian áp dụng cho giờ mở cửa đã trả lại. Ngày đặc biệt là những ngày có thể ảnh hưởng đến giờ làm việc 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 cho đị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 có bãi đỗ xe miễn phí.
paid_parking_lot

bool

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

bool

Địa điểm có chỗ đỗ xe miễn phí trên đường.
paid_street_parking

bool

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

bool

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

bool

Địa điểm có chỗ đỗ xe miễn phí.
paid_garage_parking

bool

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

PaymentOptions

Các lựa chọn 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 chấp nhận thẻ ghi nợ làm thanh toán.
accepts_cash_only

bool

Địa điểm chỉ chấp nhận thanh toán bằng tiền mặt. Các địa điểm có thuộc tính này có thể vẫn 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

Mã cộng (http://plus.codes) là một mã tham chiếu vị trí có hai định dạng: mã chung xác định một hình chữ nhật có kích thước 14 m x 14 m (1/8000 độ) hoặc nhỏ hơn và mã phức hợp, thay thế tiền tố bằng một 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 tỷ lệ 1/8000 x 1/8000 độ khu vực (~14 x 14 mét).
compound_code

string

Mã phức hợp 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 đã định dạng của một thực thể tham chiếu.

SubDestination

Đặt tên tài nguyên và mã nhận dạng của các điểm đến phụ liên quan đến địa điểm. Ví dụ: các nhà ga khác nhau là các điểm đế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 điểm đến phụ.

PriceLevel

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

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

Tài liệu tham khảo

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Đề cập đến nội dung tạo sinh có liên quan đến nội dung đó.

Trường
reviews[]

Review

Bài đánh giá đóng vai trò là tệp đối chiếu.
places[]

string

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

Bài đánh giá

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

Trường
name

string

Tệp đối chiếu đại diện cho bài đánh giá về địa điểm này, có thể dùng để tra cứu lại bài đánh giá về địa điểm này (còn được gọi là tên "tài nguyên" 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 xem xét so với thời gian hiện tại theo một biểu mẫu 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 đánh giá bằng ngôn ngữ gốc.
rating

double

Một số từ 1,0 đến 5,0, còn được gọi là số sao.
author_attribution

AuthorAttribution

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

Timestamp

Dấu thời gian cho bài đánh giá.

SearchNearbyRequest

Yêu cầu proto cho Tìm kiếm lân cận.

Trường
language_code

string

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

Danh sách các 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í xuất phát yêu cầu. Tham số này 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 cụ thể, nếu có. Tham 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 truy cập vào 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 bao gồm (ví dụ: "nhà hàng" hoặc "gas_station") từ https://developers.google.com/maps/documentation/places/web-service/place-types.

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

Nếu có bất kỳ loại xung đột nào, tức là một loại xuất hiện trong cả include_types và excluded_types, thì hệ thống sẽ trả về lỗi INVALID_ qu.

Nếu một loại Địa điểm được chỉ định cùng với nhiều hạn chế về loại, chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {included_types = ["advertiser"], excluded_primary_types = ["Nhà hàng"]}, thì những địa điểm được trả về 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 "gas_station") khỏi https://developers.google.com/maps/documentation/places/web-service/place-types.

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

Nếu khách hàng cung cấp cả include_types (ví dụ: nhà hàng) và excluded_types (ví dụ: quán cà phê), thì câu trả lời phải bao gồm các địa điểm là nhà hàng chứ không phải là quán cà phê. Câu trả lời bao gồm những địa điểm khớp với ít nhất một trong các loại_bao_gồm và không có loại nào thuộc loại bị loại trừ.

Nếu có bất kỳ loại xung đột nào, tức là một loại xuất hiện trong cả include_types và excluded_types, thì hệ thống sẽ trả về lỗi INVALID_ qu.

Nếu một loại Địa điểm được chỉ định cùng với nhiều hạn chế về loại, chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {included_types = ["advertiser"], excluded_primary_types = ["Nhà hàng"]}, thì những địa điểm được trả về 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

Bao gồm Loại địa điểm chính (ví dụ: "nhà hàng" hoặc "gas_station") 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 duy nhất trong bảng loại được hỗ trợ liên kết với địa điểm đó.

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

Nếu có bất kỳ loại chính nào xung đột với nhau, tức là một loại xuất hiện trong cả include_primary_types và excluded_primary_types, thì hệ thống sẽ trả về lỗi INVALID_ qu.

Nếu một loại Địa điểm được chỉ định cùng với nhiều hạn chế về loại, chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {included_types = ["advertiser"], excluded_primary_types = ["Nhà hàng"]}, thì những địa điểm được trả về 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 "gas_station") khỏi https://developers.google.com/maps/documentation/places/web-service/place-types.

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

Nếu có bất kỳ loại chính nào xung đột với nhau, tức là một loại xuất hiện trong cả include_primary_types và excluded_primary_types, thì hệ thống sẽ trả về lỗi INVALID_ qu.

Nếu một loại Địa điểm được chỉ định cùng với nhiều hạn chế về loại, chỉ những địa điểm đáp ứng tất cả các hạn chế mới được trả về. Ví dụ: nếu chúng tôi có {included_types = ["advertiser"], excluded_primary_types = ["Nhà hàng"]}, thì những địa điểm được trả về 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). Nếu bạn không đặt số, thì nó sẽ quay về giới hạn trên. Nếu số được đặt thành số âm hoặc vượt quá giới hạn trên, hệ thống sẽ trả về lỗi INVALID_ mở.
location_restriction

LocationRestriction

Bắt buộc. Khu vực sẽ tìm kiếm.
rank_preference

RankPreference

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

LocationRestriction

Khu vực sẽ tìm kiếm.

Trường

Trường hợp type.

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

Circle

Một đường tròn được xác định bởi điểm giữa 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 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

Proto phản hồi cho Tìm kiếm lân cận.

Trường
places[]

Place

Danh sách các địa điểm đáp ứng các 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ế cụ thể về vị trí.

SearchTextRequest

Yêu cầu proto cho SearchText.

Trường
text_query

string

Bắt buộc. Truy vấn văn bản cho tìm kiếm bằng văn bản.
language_code

string

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

Danh sách các 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í xuất phát yêu cầu. Tham số này 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 cụ thể, nếu có. Tham 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 truy cập vào 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 đi kèm.
open_now

bool

Dùng để hạn chế tìm kiếm trong các địa điểm hiện đang mở. Giá trị mặc định là "false".
min_rating

double

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

int32

Không dùng nữa: Thay vào đó, hãy dùng page_size.

Số lượng kết quả tối đa trên mỗi trang có thể trả về. Nếu số lượng kết quả có sẵn lớn hơn max_result_count, thì next_page_token sẽ được trả về và có thể truyền cho 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 0 hoặc không cung cấp giá trị thì giá trị mặc định là 20. Giá trị tối đa là 20; những giá trị trên 20 sẽ bị buộc thành 20. Giá trị âm sẽ trả về lỗi INVALID_ qu.

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ố lượng kết quả tối đa trên mỗi trang có thể trả về. Nếu số lượng kết quả có sẵn lớn hơn page_size, thì next_page_token sẽ được trả về và có thể truyền cho 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 0 hoặc không cung cấp giá trị thì giá trị mặc định là 20. Giá trị tối đa là 20; giá trị trên 20 sẽ được đặt thành 20. Giá trị âm sẽ trả về lỗi INVALID_ qu.

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 URL này để truy xuất trang tiếp theo.

Khi phân trang, mọi tham số ngoại trừ 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_ qu.
price_levels[]

PriceLevel

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

bool

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

LocationBias

Khu vực sẽ tìm kiếm. Vị trí này đóng vai trò là một thiên có nghĩa là các 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 sẽ tìm kiếm. Vị trí này đóng vai trò là một quy định hạn chế có nghĩa là sẽ không trả về các kết quả bên ngoài vị trí nhất định. Không thể đặt cùng với location_bias.
ev_options

EVOptions

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

EVOptions

Các lựa chọn 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. Một địa điểm có tốc độ sạc thấp hơn tốc độ đã 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 được ưa thích. Vị trí không hỗ trợ bất kỳ loại trình kết nối nào được liệt kê sẽ bị lọc ra.

LocationBias

Khu vực sẽ tìm kiếm. Vị trí này đóng vai trò là một thiên có nghĩa là các kết quả xung quanh vị trí đã cho có thể được trả về.

Trường

Trường hợp type.

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

Viewport

Một hộp hình chữ nhật được xác định theo góc đông bắc và tây nam. rectangle.high() phải là điểm phía đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm phía 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(). Thao tác này sẽ dẫn đến một phạm vi vĩ độ trống. Khung nhìn hình chữ nhật không được rộng hơn 180 độ.
circle

Circle

Một đường tròn được xác định bởi điểm giữa và bán kính.

LocationRestriction

Khu vực sẽ tìm kiếm. Vị trí này đóng vai trò là một quy định hạn chế có nghĩa là sẽ không trả về các kết quả bên ngoài vị trí nhất định.

Trường

Trường hợp type.

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

Viewport

Một hộp hình chữ nhật được xác định theo góc đông bắc và tây nam. rectangle.high() phải là điểm phía đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm phía 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(). Thao tác này sẽ dẫn đến một phạm vi 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, chẳng hạn như "Nhà hàng ở thành phố New York", RELEVANCE là giá trị mặc định. Đối với các cụm từ tìm kiếm không phân loại, chẳng hạn như " Mountain View, CA", bạn nên không đặt RankPreferences.
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 được xác định theo thứ tự xếp hạng thông thường.

SearchTextResponse

Proto phản hồi cho SearchText.

Trường
places[]

Place

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

ContextualContent

Thử nghiệm: Hãy truy cập vào https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative để biết thêm chi tiết.

Danh sách nội dung theo ngữ cảnh mà mỗi mục nhập 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. Ưu tiên nội dung có liên quan đến text_query trong yêu cầu. Nếu nội dung theo ngữ cảnh không có sẵn cho một trong các địa điểm, nội dung đó sẽ trả về nội dung không theo ngữ cảnh. Trường này sẽ chỉ trống khi không có nội dung về địa điểm này. Danh sách này phải có nhiều mục nhập như danh sách các địa điểm nếu được yêu cầu.
next_page_token

string

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 trường này bị bỏ qua hoặc trống thì không có trang tiếp theo.