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ừ yêu cầu Autocomplete và GetPhotoMedia) đều yêu cầu một 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ề các 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 một tệp ảnh đa phương tiện bằng 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 đó. Đâ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 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 bằ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 xếp hạng gồm các địa danh lân cận và các khu vực chứa chính xác cũng như mối quan hệ của các khu vực này với vị trí mục tiêu.

Trường
landmarks[]

Landmark

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

Area

Danh sách xếp hạng các khu vực chứa hoặc lân cận. Những khu vực dễ nhận biết và chính xác nhất sẽ được xếp hạng đầu tiên.

Khu vực

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

Khu vực bao gồm tiểu khu, khu dân cư và khu vực rộng 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 phạm vi chứa.
WITHIN Vị trí mục tiêu nằm trong khu vực, gần với trung tâm.
OUTSKIRTS Vị trí mục tiêu nằm trong vùng khu vực, gần với rìa.
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ệ giữa địa danh với vị trí mục tiêu.

Địa điểm nổi bật là những địa điểm dễ nhận biết mà bạn 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 các thẻ loại cho địa danh này. Để xem danh sách đầy đủ các giá trị có thể có, hãy truy cập vào 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à địa danh.
straight_line_distance_meters

float

Khoảng cách theo đường thẳng (tính bằng mét) giữa tâm của mục tiêu và tâm của địa điểm. Trong một số trường hợp, giá trị này có thể lớn 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 bộ từ mục tiêu đến địa danh (nếu có). Giá trị này không tính đến phương thức 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à địa danh.

Enum
NEAR Đây là mối quan hệ mặc định khi không có mối quan hệ nào cụ thể hơn bên dưới được áp dụng.
WITHIN Địa điểm có hình học không gian và mục tiêu nằm trong phạm vi của địa điểm đó.
BESIDE Mục tiêu nằm ngay bên cạnh địa điểm nổi tiếng.
ACROSS_THE_ROAD Mục tiêu nằm ngay đối diện với địa danh ở phía bên kia đường.
DOWN_THE_ROAD Trên cùng tuyến đường với địa danh 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 danh 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 phố của địa danh.

AuthorAttribution

Thông tin về tác giả của dữ liệu do người dùng tạo. Được 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ả Photo hoặc Review.
photo_uri

string

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

AutocompletePlacesRequest

Proto yêu cầu cho AutocompletePlaces.

Trường
input

string

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

LocationBias

Không bắt buộc. Thiên vị kết quả 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 cả hai, kết quả sẽ bị ảnh hưởng bởi đị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 ảnh hưởng.
location_restriction

LocationRestriction

Không bắt buộc. Giới hạn 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 cả hai, kết quả sẽ bị ảnh hưởng bởi đị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 ảnh hưởng.
included_primary_types[]

string

Không bắt buộc. Loại Địa điểm chính được đưa vào (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 tối đa 15 mã khu vực gồm 2 ký tự theo quy ước của CLDR. Một 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ữ mà bạn muốn nhận kết quả. 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 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 CLDR gồm 2 ký tự. Điều này ảnh hưởng đến định dạng địa chỉ, thứ hạng kết quả và có thể ảnh hưởng đến những kết quả được trả về. Thao tác này không giới hạn kết quả ở khu vực đượ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 xuất phát để tính khoảng cách trắc địa đến đích đến (trả về dưới dạng distance_meters). Nếu bạn bỏ qua giá trị này, 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 mốc 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 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ả Địa điểm và cụm từ tìm kiếm dự đoán. Nếu không, phản hồi sẽ chỉ trả về các cụm từ 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à một chuỗi base64 an toàn cho tên tệp và URL, có độ dài tối đa 36 ký tự ASCII. Nếu không, lỗi INVALID_ARGUMENT sẽ được trả về.

Phiên bắt đầu khi người dùng bắt đầu nhập một cụm từ tìm kiếm và kết thúc khi họ chọn một địa điểm và thực hiện lệnh gọi đến Place Details hoặc Address Validation. 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 đăng nhập đượ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ệ; ứ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 tham số session_token hoặc nếu bạn sử dụng lại mã thông báo phiên, thì phiên sẽ bị tính phí như thể bạn không cung cấp mã thông báo phiên (mỗi yêu cầu sẽ được tính phí riêng).

Bạn nên tuân thủ các nguyên tắc sau:

  • Sử dụng mã thông báo phiên cho tất cả các lệnh gọi Place Autocomplete.
  • Tạo một 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 đăng nhập được dùng cho tất cả các yêu cầu Place Autocomplete, Place Details và Address Validation 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. Nếu bạn dùng cùng một mã thông báo cho nhiều phiên, thì mỗi yêu cầu sẽ được tính phí riêng.
include_pure_service_area_businesses

bool

Không bắt buộc. Bao gồm các doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng nếu trường được đặt thành true. Doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng là 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ỉ 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. 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í cho những doanh nghiệp này.

LocationBias

Khu vực cần tìm kiếm. Kết quả có thể thiên về khu vực được chỉ định.

Trường

Trường nhóm type.

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

Viewport

Một khung hiển thị được xác định bằng một góc đông bắc và một góc tây nam.
circle

Circle

Một hình tròn được xác định bằng tâ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 trong khu vực được chỉ định.

Trường

Trường nhóm type.

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

Viewport

Một khung hiển thị được xác định bằng một góc đông bắc và một góc tây nam.
circle

Circle

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

AutocompletePlacesResponse

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 nhóm kind.

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

PlacePrediction

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

QueryPrediction

Thông tin dự đoán cho một cụm từ tìm kiếm.

FormattableText

Văn bản đại diện cho một Địa điểm hoặc cụm từ dự đoán cho truy vấn. Bạn có thể sử dụng văn bản nguyên trạng 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

Một danh sách các dải ô chuỗi xác định vị trí mà yêu cầu đầu vào khớp trong text. Bạn có thể dùng các dải ô này để định dạng các phần cụ thể của text. Các chuỗi con có thể không khớp chính xác với input nếu tiêu chí khớp không phải là tiêu chí khớp chuỗi (ví dụ: sửa lỗi chính tả hoặc chuyển tự).

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

PlacePrediction

Kết quả dự đoán cho một 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ể 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 riêng biệt của Địa điểm được đề xuất. Bạn có thể 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ở, đây thường là tên và địa chỉ của doanh nghiệp.

text là thành phần được đề xuất cho những nhà phát triển muốn hiển thị một phần tử duy nhất trên giao diện người dùng. Những nhà phát triển muốn hiển thị 2 thành phần riêng biệt nhưng có liên quan trên giao diện người dùng có thể muốn sử dụng structured_format. Đây là hai cách khác nhau để biểu thị một kết quả dự đoán Đị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 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

Thông tin dự đoán về Đị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 bổ sung giúp phân biệt (chẳng hạn như thành phố hoặc khu vực).

structured_format được đề xuất cho những nhà phát triển muốn hiển thị 2 thành phần riêng biệt nhưng có liên quan trên giao diện người dùng. Những nhà phát triển muốn hiển thị một phần tử duy nhất trên giao diện người dùng có thể muốn sử dụng text. Đây là hai cách khác nhau để biểu thị một kết quả dự đoán Đị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 danh mục của Địa điểm. Những địa điểm có cùng loại sẽ có những đặ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 bạn chỉ định origin. Một số thông tin dự đoán (chẳng hạn như tuyến đường) có thể không xuất hiện trong trường này.

QueryPrediction

Kết quả dự đoán cho một 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 bằng văn bản có thể 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 là thành phần được đề xuất cho những nhà phát triển muốn hiển thị một phần tử duy nhất trên giao diện người dùng. Những nhà phát triển muốn hiển thị 2 thành phần riêng biệt nhưng có liên quan trên giao diện người dùng có thể muốn sử dụng structured_format. Đây là hai cách khác nhau để biểu thị một cụm từ tìm kiếm dự đoá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ể sử dụng nhiều ngôn ngữ nếu yêu cầu input và language_code có ngôn ngữ khác nhau 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ữ địa phương sang language_code.
structured_format

StructuredFormat

Phân tích 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 bổ sung giúp phân biệt (chẳng hạn như thành phố hoặc khu vực).

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

Trường
start_offset

int32

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

int32

Độ lệch dựa trên 0 của ký tự Unicode cuối cùng (loại trừ).

StructuredFormat

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

Đối với tính năng đề xuất Địa điểm, văn bản chính chứa tên cụ thể của Địa điểm. Đối với tính năng dự đoán cụm từ tìm kiếm, văn bản chính chứa cụm từ tìm kiếm.

Văn bản phụ chứa các đặc điểm bổ sung để phân biệt (chẳng hạn như thành phố hoặc khu vực) nhằm xác định thêm Đị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 đặc điểm bổ sung giúp phân biệt (chẳng hạn như 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

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

Trường
center

LatLng

Bắt buộc. Vĩ độ và kinh độ của tâm.

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 tính bằng mét. Bán kính phải nằm trong khoảng [0.0, 50000.0].

ContentBlock

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

Trường
content

LocalizedText

Nội dung liên quan đến chủ đề.
referenced_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ể 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.

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 theo ngữ cảnh đối với truy vấn về địa điểm.

Trường
reviews[]

Review

Danh sách bài đánh giá về địa điểm này, theo ngữ cảnh của truy vấn 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, theo ngữ cảnh của cụm từ tìm kiếm về đị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 đị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 địa điểm. Lý do giải đáp câu hỏi về lý do một địa điểm có thể thu hút người dùng cuối.

Trường

Trường nhóm justification.

justification chỉ có thể là một trong những trạng thái 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 của BusinessAvailabilityAttributes. Điều này cho thấy một số thuộc tính mà doanh nghiệp có thể thu hút người dùng cuối.

Trường
takeout

bool

Nếu địa điểm có dịch vụ mang đi.
delivery

bool

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

bool

Nếu một địa điểm có phục vụ ăn uống tại chỗ.

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 đoạ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à "pizza củi", thì phần giải thích bài đánh giá sẽ làm nổi bật văn bản 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 ra.

HighlightedText

Văn bản được làm nổi bật bằng cách căn chỉnh. Đây là một phần của 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 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ữ trong Địa điểm. Thuật ngữ tuân theo https://afdc.energy.gov/fuels/electricity_infrastructure.html Mỗi cổng sạc 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 sạc.

Trường
connector_count

int32

Số lượng đầu cắm tại trạm sạc 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ột ô tô tại một thời điểm (ví dụ: số lượng giắc cắm có thể lớn hơn tổng số ô tô có thể sạc cùng lúc).
connector_aggregation[]

ConnectorAggregation

Danh sách các cụm đầ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 biết thông tin tổng hợp về các đầu sạc xe điện 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ép tổng hợp này.
max_charge_rate_kw

double

Tốc độ sạc tối đa tĩnh tính (tính bằng kW) của mỗi giắc cắm trong nhóm.
count

int32

Số lượng đầu nối trong tổ hợp này.
availability_last_update_time

Timestamp

Dấu thời gian khi thông tin về trạng thái sẵn có của trình kết nối trong thông tin 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 tổ hợp này.
out_of_service_count

int32

Số lượng giắc cắm trong cụm này hiện không sử dụng được.

EVConnectorType

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

Enum
EV_CONNECTOR_TYPE_UNSPECIFIED Giắc cắm không xác định.
EV_CONNECTOR_TYPE_OTHER Các loại giắc cắm khác.
EV_CONNECTOR_TYPE_J1772 Đầu cắm loại 1 J1772.
EV_CONNECTOR_TYPE_TYPE_2 Giắc cắm loại 2 theo tiêu chuẩn IEC 62196. Thường được gọi là MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Đầu cắm 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 Type-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 đầu cắm 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 ở những nơi khác trên thế giới (ví dụ: CCS Combo 2 (CCS2) hoặc GB/T). Giá trị này ít đại diện cho một loại giắc cắm thực tế hơn và đại diện nhiều hơn cho khả năng sạc xe của thương hiệu Tesla tại một 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 tiêu chuẩn hoá thành 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 đã biết gần đây nhất 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 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á của nhiên liệu.
update_time

Timestamp

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

FuelType

Các loại nhiên liệu.

Enum
FUEL_TYPE_UNSPECIFIED Loại nhiên liệu chưa được chỉ đị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 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG Khí dầu mỏ hoá lỏng.
E80 E 80.
E85 E 85.
E100 E 100.
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 một ảnh trong tệp đa phương tiện ở định dạng: places/{place_id}/photos/{photo_reference}/media.

Tên tài nguyên của một bức ảnh được trả về trong trường photos.name của đối tượng Place 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 của ảnh.
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 các giá trị được chỉ định, hình ảnh gốc sẽ được trả về. Nếu hình ảnh lớn hơn ở một trong hai chiều, thì hình ảnh đó sẽ được điều chỉnh tỷ lệ cho phù hợp với chiều nhỏ hơn trong hai chiều, trong phạm vi 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ả 1 và 4800). 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 và max_width_px, thì 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 của hình ảnh, tính bằng pixel. Nếu hình ảnh nhỏ hơn các giá trị được chỉ định, hình ảnh gốc sẽ được trả về. Nếu hình ảnh lớn hơn ở một trong hai chiều, thì hình ảnh đó sẽ được điều chỉnh tỷ lệ cho phù hợp với chiều nhỏ hơn trong hai chiều, trong phạm vi 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ả 1 và 4800). 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 và max_width_px, thì 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 chính sách này, một lệnh chuyển hướng HTTP sẽ được phát hành để chuyển hướng lệnh gọi đến nội dung nghe nhìn của hình ảnh. Tuỳ chọn này sẽ bị bỏ qua đối với các yêu cầu không phải là 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 tài nguyên 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 các ngôn ngữ được hỗ trợ hiện tại: 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 được đưa ra. 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ó). 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 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 phiên Tự động hoàn thành cho mục đích thanh toán. Phải là một chuỗi base64 an toàn cho tên tệp và URL, có độ dài tối đa 36 ký tự ASCII. Nếu không, lỗi INVALID_ARGUMENT sẽ được trả về.

Phiên bắt đầu khi người dùng bắt đầu nhập một cụm từ tìm kiếm và kết thúc khi họ chọn một địa điểm và thực hiện lệnh gọi đến Place Details hoặc Address Validation. 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 đăng nhập đượ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ệ; ứ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 tham số session_token hoặc nếu bạn sử dụng lại mã thông báo phiên, thì phiên sẽ bị tính phí như thể bạn không cung cấp mã thông báo phiên (mỗi yêu cầu sẽ được tính phí riêng).

Bạn nên tuân thủ các nguyên tắc sau:

  • Sử dụng mã thông báo phiên cho tất cả các lệnh gọi Place Autocomplete.
  • Tạo một 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 đăng nhập được dùng cho tất cả các yêu cầu Place Autocomplete, Place Details và Address Validation 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. Nếu bạn dùng cùng một mã thông báo cho nhiều phiên, thì mỗi yêu cầu sẽ đượ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 thông tin tham chiếu đại diện cho ảnh địa điểm này. Bạn có thể dùng thông tin 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ó thể sử dụng, tính bằng pixel.
height_px

int32

Chiều cao tối đa có thể sử dụng, tính bằng pixel.
author_attributions[]

AuthorAttribution

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

string

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

string

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

PhotoMedia

Ảnh từ Places API.

Trường
name

string

Tên tài nguyên của một ảnh trong tệp đa phương tiện ở định dạng: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

Một uri tồn tại trong thời gian ngắ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, theo định dạng places/{place_id}. Có thể dùng để tra cứu Địa điểm.
id

string

Giá trị nhận dạng riêng biệ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 làm nội dung mô tả ngắn mà con người có thể đọc được. Ví dụ: "Google Sydney", "Starbucks", "Pyrmont", v.v.
types[]

string

Một nhóm thẻ loại cho kết quả này. Ví dụ: "political" và "locality". Để 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 những loại được Places API hỗ trợ. 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. Loại chính có thể bị thiếu nếu loại chính của địa điểm không phải là loại được hỗ trợ. Khi có loại chính, loại đó luôn là một trong các loại trong trường 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ó). Để 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. Loại chính có thể bị thiếu nếu loại chính của địa điểm không phải là loại được hỗ trợ.
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 dễ đọc của địa điểm, ở định dạng quốc tế.
formatted_address

string

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

string

Địa chỉ ngắn gọn, dễ đọc của địa điểm này.
postal_address

PostalAddress

Địa chỉ ở định dạng địa chỉ bưu chính.
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 điểm sau đây 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 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ị có 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ị có chứa một địa chỉ cụ thể, bạn nên sử dụng tính năng mã hoá địa lý ngược, truyền vĩ độ/kinh độ của địa chỉ làm 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 sẽ 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 đó.
plus_code

PlusCode

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

LatLng

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

Viewport

Một khung hiển thị 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 hiển thị này làm ranh giới thực tế hoặc khu vực kinh doanh 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

Một 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 cho đị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 sẽ là trang web của từng cửa hàng, chứ không phải của toàn bộ chuỗi.
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. Các ứng dụng có thể dựa vào trạng thái luôn mở cửa (24 giờ) được biểu thị dưới dạng khoảng thời gian open chứa day có giá trị 0, hour có giá trị 0 và minute có giá trị 0.
time_zone

TimeZone

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

Photo

Thông tin (bao gồm cả thông tin tham khảo) về ảnh của địa điểm này. Hệ thống có thể trả về tối đa 10 bức ả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 nhóm nhà cung cấp dữ liệu phải xuất hiện cùng với kết quả này.
icon_mask_base_uri

string

URL bị cắt ngắn đến một mặt nạ biểu tượng. Người dùng có thể truy cập vào các loại biểu tượng khác nhau 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 từ nửa đêm vào ngày 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 phụ special_days của tất cả các giờ, được đặt cho những ngày có giờ hoạt động đặc biệt.
current_secondary_opening_hours[]

OpeningHours

Chứa một mảng các mục cho 7 ngày tiếp theo, bao gồm cả thông tin về giờ hoạt động phụ 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à giờ hoạt động phụ. Trường này sẽ điền sẵn vào trường phụ loại, lấy dữ liệu từ danh sách được xác định trước về các loại giờ hoạt động (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) dựa trên các loại địa điểm. Trường này bao gồm trường phụ special_days của tất cả các giờ, được đặt cho những ngày có giờ hoạt động đặc biệt.
regular_secondary_opening_hours[]

OpeningHours

Chứa một mảng các mục nhập thông tin về giờ hoạt động phụ thường xuyên 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à giờ hoạt động phụ. Trường này sẽ điền sẵn vào trường phụ loại, lấy dữ liệu từ danh sách được xác định trước về các loại giờ hoạt động (chẳng hạn như DRIVE_THROUGH, PICKUP hoặc TAKEOUT) dựa trên các loại địa điểm.
editorial_summary

LocalizedText

Chứa bản tóm tắt về địa điểm. Bản tóm tắt bao gồm thông tin tổng quan bằng văn bản và mã ngôn ngữ (nếu có). Bạn phải trình bày văn bản tóm tắt 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ề lựa chọn thanh toán, trường lựa chọn 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 điểm đế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

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

ContainingPlace

Danh sách các địa điểm mà địa điểm hiện tại nằm trong đó.
address_descriptor

AddressDescriptor

Thông tin mô tả địa chỉ của địa điểm. Nội dung mô tả địa chỉ bao gồm thông tin bổ sung giúp mô tả một vị trí bằng cách sử dụng địa danh và khu vực. Xem phạm vi theo khu vực của bộ mô tả địa chỉ 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.
review_summary

ReviewSummary

Bản tóm tắt do AI tạo về địa điểm dựa trên bài đánh giá của người dùng.
ev_charge_amenity_summary

EvChargeAmenitySummary

Thông tin tóm tắt về các tiện nghi gần trạm sạc xe điện.
neighborhood_summary

NeighborhoodSummary

Tóm tắt các địa điểm yêu thích ở gần nơi đó.
consumer_alert

ConsumerAlert

Thông báo cảnh báo người tiêu dùng cho địa điểm khi chúng tôi phát hiện thấy hoạt động đánh giá đáng ngờ về một doanh nghiệp hoặc khi một doanh nghiệp vi phạm chính sách của chúng tôi.
utc_offset_minutes

int32

Số phút mà múi giờ của địa điểm này hiện đang lệch so với giờ UTC. Giá trị này được biểu thị bằng phút để hỗ trợ các múi giờ có độ lệch bằng một phần 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

Cho biết liệu doanh nghiệp có hỗ trợ dịch vụ mang đi hay không.
delivery

bool

Cho biết liệu doanh nghiệp có hỗ trợ dịch vụ giao hàng hay không.
dine_in

bool

Cho biết liệu doanh nghiệp có hỗ trợ lựa chọn 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ụ lấy hàng tại lề đường hay không.
reservable

bool

Cho biết địa điểm có hỗ trợ đặt chỗ hay không.
serves_breakfast

bool

Cho biết địa điểm có phục vụ bữa sáng hay không.
serves_lunch

bool

Cho biết địa điểm có phục vụ bữa trưa hay không.
serves_dinner

bool

Cho biết địa điểm có phục vụ bữa tối hay không.
serves_beer

bool

Cho biết đị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

Cho biết địa điểm có phục vụ bữa sáng muộn hay không.
serves_vegetarian_food

bool

Cho biết đị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ó 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 này có phục vụ cocktail.
serves_dessert

bool

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

bool

Địa điểm này có 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 có thể tiếp đón các nhóm.
good_for_watching_sports

bool

Địa điểm này phù hợp để xem 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ỉ cung cấp dịch vụ tại 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à 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ỉ 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 này 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 nên địa chỉ được định dạng, nếu có thông tin này.

Trường
long_text

string

Nội dung mô tả hoặc tên đầy đủ của thành phần địa chỉ. Ví dụ: một 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 của 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 các thành phần này, theo ký hiệu CLDR.

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 Đị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 hoạt động của doanh nghiệp tại địa điểm.

Enum
BUSINESS_STATUS_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
OPERATIONAL Cơ sở này đang hoạt động, nhưng không nhất thiết là đang 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.

ConsumerAlert

Thông báo cảnh báo người tiêu dùng cho địa điểm khi chúng tôi phát hiện thấy hoạt động đánh giá đáng ngờ về một doanh nghiệp hoặc khi một doanh nghiệp vi phạm chính sách của chúng tôi.

Trường
overview

string

Thông tin tổng quan về thông báo cảnh báo cho người dùng.
details

Details

Thông tin chi tiết về thông báo cảnh báo cho người tiêu dùng.ƒ
language_code

string

Mã ngôn ngữ của thông báo cảnh báo dành cho người tiêu dùng. Đây là mã ngôn ngữ BCP 47.

Thông tin chi tiết

Thông tin chi tiết về thông báo cảnh báo cho người tiêu dùng.

Trường
title

string

Tiêu đề sẽ xuất hiện cùng với nội dung mô tả.
description

string

Nội dung mô tả về thông báo cảnh báo cho người tiêu dùng.

ContainingPlace

Thông tin về địa điểm mà địa điểm này nằm trong đó.

Trường
name

string

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

string

Mã địa điểm của địa điểm chứa địa điểm này.

EvChargeAmenitySummary

Thông tin tóm tắt về các tiện nghi gần trạm sạc xe điện. Điều này chỉ áp dụng cho những địa điểm có loại electric_vehicle_charging_station. Trường overview chắc chắn sẽ được cung cấp, trong khi các trường khác là không bắt buộc.

Trường
overview

ContentBlock

Tổng quan về các tiện nghi có sẵn. Chúng tôi đảm bảo sẽ cung cấp thông tin này.
coffee

ContentBlock

Tóm tắt các lựa chọn về quán cà phê ở gần.
restaurant

ContentBlock

Tóm tắt về các nhà hàng gần đó.
store

ContentBlock

Thông tin tóm tắt về các cửa hàng gần đây.
flag_content_uri

string

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

LocalizedText

Thông báo về AI "Tóm tắt bằng Gemini" (và các phiên bản bằng ngôn ngữ khác). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.

GenerativeSummary

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 đề với bản tóm tắt tổng quan.
disclosure_text

LocalizedText

Thông báo về AI "Tóm tắt bằng Gemini" (và các phiên bản bằng ngôn ngữ khác). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.

NeighborhoodSummary

Tóm tắt các địa điểm yêu thích ở gần nơi đó.

Trường
overview

ContentBlock

Bản tóm tắt tổng quan về khu vực lân cận.
description

ContentBlock

Nội dung mô tả chi tiết về khu vực lân cận.
flag_content_uri

string

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

LocalizedText

Thông báo về AI "Tóm tắt bằng Gemini" (và các phiên bản bằng ngôn ngữ khác). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.

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, 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ụ: do địa điểm đó tạm thời đóng cửa để cải tạo.

Ngày bắt đầu của periods KHÔNG cố định và không được giả định là Chủ Nhật. API xác định ngày bắt đầu dựa trên nhiều yếu tố. Ví dụ: đối với một doanh nghiệp hoạt động 24/7, khoảng thời gian đầu tiên có thể bắt đầu vào ngày gửi yêu cầu. Đối với những doanh nghiệp khác, đó có thể là ngày đầu tiên trong tuần mà họ mở cửa.

LƯU Ý: Thứ tự của mảng periods không phụ thuộc vào thứ tự của mảng weekday_descriptions. Đừng cho rằng các chiến dịch sẽ bắt đầu vào cùng một ngày.
weekday_descriptions[]

string

Các chuỗi đã bản địa hoá mô tả giờ mở cửa của địa điểm này, mỗi chuỗi cho một ngày trong tuần.

LƯU Ý: Thứ tự của các ngày và ngày bắt đầu tuần được xác định theo ngôn ngữ và khu vực. Thứ tự của mảng periods không phụ thuộc vào thứ tự của mảng weekday_descriptions. Đừng cho rằng các chiến dịch sẽ bắt đầu vào cùng một ngày.

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 – 6:00"
secondary_hours_type

SecondaryHoursType

Một chuỗi loại dùng để xác định loại giờ hoạt động 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 mà giờ mở cửa được trả về bao gồm. 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ờ mở cửa đặc biệt.
next_open_time

Timestamp

Lần tiếp theo khoảng thời gian giờ mở cửa hiện tại bắt đầu, tối đa là 7 ngày sau. Trường này chỉ được điền sẵ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

Lần tiếp theo khoảng thời gian mở cửa hiện tại kết thúc là trong vòng 7 ngày tới. Trường này chỉ được điền sẵ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 có đang hoạt động 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 đị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 giờ 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 mà địa điểm duy trì 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 gian đị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

Đ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 tôi sẵn sàng trả về, vì vậy, chúng tôi sẽ cắt bớt giờ về các ranh giới này. Điều này đảm bảo rằng tối đa 24 * 7 giờ kể từ nửa đêm của ngày có yêu cầu sẽ được trả về.
day

int32

Một ngày trong tuần, dưới dạng số nguyên trong phạm vi từ 0 đến 6. 0 là Chủ Nhật, 1 là Thứ Hai, v.v.
hour

int32

Giờ ở định dạng 24 giờ. Dao động từ 0 đến 23.
minute

int32

Phút. Dao động từ 0 đến 59.

SecondaryHoursType

Một loại dùng để xác định loại giờ hoạt động 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ờ mở cửa của dịch vụ lái xe qua cho 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 bữa sáng muộn.
PICKUP Giờ đến lấy hàng.
ACCESS Giờ mở cửa của 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 mà giờ mở cửa được trả về bao gồm. 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 diễn ra 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

Nơi này 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

Nơi này có 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

Nơi 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

Nơi 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 thẻ tín dụng làm phương thức thanh toán.
accepts_debit_cards

bool

Địa điểm chấp nhận thẻ ghi nợ để thanh toá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à thông tin tham chiếu về vị trí có 2 định dạng: mã toàn cầu 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ã kết 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", biểu thị một khu vực có kích thước 1/8000 x 1/8000 độ (~14 x 14 mét).
compound_code

string

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

ReviewSummary

Bản tóm tắt do AI tạo về địa điểm dựa trên bài đánh giá của người dùng.

Trường
text

LocalizedText

Tóm tắt bài đánh giá của người dùng.
flag_content_uri

string

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

LocalizedText

Thông báo về AI "Tóm tắt bằng Gemini" (và các phiên bản bằng ngôn ngữ khác). Nếu có, thông tin này sẽ có bằng ngôn ngữ được chỉ định trong yêu cầu.
reviews_uri

string

Một đường liên kết để xem các bài đánh giá về địa điểm này trên Google Maps.

SubDestination

Địa điểm phụ là những địa điểm cụ thể liên quan đến một địa điểm chính. Những địa điểm này cung cấp đích đến cụ thể hơn cho những người dùng đang tìm kiếm trong một địa điểm rộng lớn hoặc phức tạp, chẳng hạn như sân bay, công viên quốc gia, trường đại học hoặc sân vận động. Ví dụ: các điểm đến phụ tại một sân bay có thể bao gồm các nhà ga và bãi đỗ xe liên quan. Các điểm đến phụ trả về mã địa điểm và tên tài nguyên địa điểm. Bạn có thể sử dụng mã địa điểm và tên tài nguyên địa điểm trong các yêu cầu Chi tiết về địa điểm (Mới) tiếp theo để tìm nạp thông tin chi tiết phong phú hơn, bao gồm cả tên hiển thị và vị trí của điểm đến phụ.

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

Hình nhiều đường

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

Trường
Trường nhóm polyline_type. Đóng gói loại đường nhiều đoạn. Đầu ra của Routes API mặc định là encoded_polyline. polyline_type chỉ có thể là một trong những trạng thái sau:
encoded_polyline

string

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

PriceLevel

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

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

PriceRange

Phạm vi giá liên kết với một Địa điểm. Bạn có thể huỷ đặt end_price. Điều này cho biết một dải ô không có giới hạn trên (ví dụ: "Lớn hơn 1.000.000 VND").

Trường
start_price

Money

Mức giá thấp nhất của 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 dải giá (không bao gồm). Giá phải thấp hơn số tiền này.

Xem xét

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

Trường
name

string

Một thông tin tham chiếu đại diện cho bài đánh giá này về địa điểm. Bạn có thể dùng thông tin này để tra cứu lại bài đánh giá này về địa điểm (còn 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 đánh giá so với thời gian hiện tại theo một cách 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 đượ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 của bài đánh giá.
flag_content_uri

string

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

string

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

Date

Ngày tác giả đến thăm địa điểm. Dữ liệu này được rút gọn thành tháng.

RouteModifiers

Đóng gói một nhóm các điều kiện không bắt buộc cần đá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, hệ thống sẽ tránh đường thu phí nếu có thể, ưu tiên những tuyến đường không có đường 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, hệ thống sẽ tránh đường cao tốc nếu có thể, ưu tiên những tuyến đường không có đườ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, hệ thống sẽ tránh phà nếu có thể, ưu tiên những tuyến đường không có 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 true, chế độ này sẽ tránh điều hướng trong nhà nếu có thể, ưu tiên những tuyến đường không có chỉ dẫn đường đi trong nhà. Chỉ áp dụng cho WALK TravelMode.

RoutingParameters

Các tham số để định cấu hình các phép tính định tuyến cho các vị trí 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. Một nguồn định tuyến rõ ràng sẽ ghi đè nguồn được xác định trong đường nhiều đoạn. Theo mặc định, hệ thống sẽ sử dụng điểm gốc của đường nhiều đoạn.
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 thông tin tóm tắt về việc định tuyến. Máy chủ cố gắng sử dụng lựa chọn ưu tiên về định tuyến đã chọn để tính toán tuyến đường. Lựa chọn ưu tiên về tuyến đường có tính đến tình trạng giao thông chỉ có trong gói DRIVE hoặc TWO_WHEELER travelMode.

RoutingPreference

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

Enum
ROUTING_PREFERENCE_UNSPECIFIED Chưa chỉ định lựa chọn ưu tiên về định tuyến. Mặc định là TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Tính toán tuyến đường mà không xem xét tình trạng giao thông thực tế. Phù hợp khi tình trạng 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 gian được chọn dựa trên mạng lưới đường bộ 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 bộ hiện tại. Do đó, các tuyến đường có thể bao gồm những con đường đang bị đóng tạm thời. Kết quả cho một yêu cầu nhất định có thể thay đổi theo thời gian do những thay đổi trong mạng lưới đường bộ, điều kiện giao thông trung bình mới nhất và bản chất phân tán của dịch vụ. Kết quả cũng có thể thay đổi giữa các tuyến đường gần tương đương vào bất kỳ thời điểm hoặc tần suất nào.
TRAFFIC_AWARE Tính toán các tuyến đường có tính đến tình hình giao thông thực tế. Ngược lại với TRAFFIC_AWARE_OPTIMAL, một số chế độ 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 thực tế mà không áp dụng hầu hết các hoạt độ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

Khoảng thời gian và khoảng cách từ điểm bắt đầu định tuyến đến một địa điểm trong phản hồi, và đoạn đường thứ hai từ địa điểm đó đến điểm đế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 bao gồm tham số routingParameters.origin hoặc tham số searchAlongRouteParameters.polyline.encodedPolyline trong 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 toán thời gian và khoảng cách di chuyển từ một điểm khởi hành cố định, legs sẽ chứa một chặng duy nhất có thời gian và khoảng cách từ điểm khởi hành đến điểm đến. Khi bạn tìm kiếm dọc theo tuyến đường, legs sẽ có 2 chặng: một chặng từ điểm khởi hành đế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 để chỉ đường trên Google Maps bằng cách sử dụng các điểm tham chiếu trong bản tóm tắt định tuyến đã cho. Đường đi do đường liên kết này tạo ra không được đảm bảo giống với đường đi 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 như routingParameters và searchAlongRouteParameters (nếu có) để tạo đường liên kết chỉ đường.

Chân

Chặng là một phần của hành trình từ một vị trí đến một vị trí 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, thì thông tin chi tiết về địa điểm bằng ngôn ngữ bất kỳ có thể được trả về, ưu tiên tiếng Anh nếu có thông tin chi tiết như vậy.

Danh sách các ngôn ngữ được hỗ trợ hiện tại: 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 được đưa ra. 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ó). 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 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 hạn chế về loại, thì 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 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 với vai trò là "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") trong 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 hạn chế về loại, thì 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 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 với vai trò là "nhà hàng".
included_primary_types[]

string

Loại Địa điểm chính đượ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. Một địa điểm chỉ có thể có một loại chính trong bảng các 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 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 hạn chế về loại, thì 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 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 với vai trò là "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") trong 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 hạn chế về loại, thì 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 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 với vai trò là "nhà hàng".
max_result_count

int32

Số lượng 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 chưa đặt số, thì số đó sẽ quay lại giới hạn trên. Nếu bạn đặt số thành giá trị âm hoặc vượt quá giới hạn trên, thì lỗi INVALID_ARGUMENT sẽ được trả về.
location_restriction

LocationRestriction

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

RankPreference

Cách kết quả được xếp hạng 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 nhóm type.

type chỉ có thể là một trong những trạng thái 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 kết quả được xếp hạng trong câu trả lời.

Enum
RANK_PREFERENCE_UNSPECIFIED Chưa đặt giá trị RankPreference. Theo mặc định, sẽ sử dụng thứ hạng theo MỨC ĐỘ PHỔ BIẾN.
DISTANCE Xếp hạng kết quả theo khoảng cách.
POPULARITY Sắp xếp kết quả theo mức độ phổ biến.

SearchNearbyResponse

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à hạn chế về vị trí cụ thể.
routing_summaries[]

RoutingSummary

Danh sách tóm tắt về việc định tuyến, 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 places. Nếu không có thông tin tóm tắt về đường đi cho một trong các địa điểm, thì thông tin đó sẽ chứa một mục trống. Danh sách này phải có số mục 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 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ẽ 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, thì thông tin chi tiết về địa điểm bằng ngôn ngữ bất kỳ có thể được trả về, ưu tiên tiếng Anh nếu có thông tin chi tiết như vậy.

Danh sách các ngôn ngữ được hỗ trợ hiện tại: 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 được đưa ra. 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ó). 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 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 kết quả được xếp hạng 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 phạm vi 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 (tính toàn bộ) với bước là 0,5, tức là [0, 0,5, 1,0, ..., 5,0] (tính toàn bộ). Điểm phân loại đầu vào sẽ được làm tròn lên đến 0,5 gần nhất(làm tròn lê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: Thay vào đó, hãy sử dụng page_size.

Số lượng kết quả tối đa có thể trả về trên mỗi trang. 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ể được truyền đến page_token để nhận 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ì hệ thống sẽ sử dụng giá trị mặc định là 20. Giá trị tối đa là 20; các giá trị lớn hơn 20 sẽ được chuyển đổi thành 20. Các 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ố lượng kết quả tối đa có thể trả về trên mỗi trang. 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ể được truyền đến page_token để nhận 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ì hệ thống sẽ sử dụng giá trị mặc định là 20. Giá trị tối đa là 20; các giá trị trên 20 sẽ được đặt thành 20. Các 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 thông tin này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác vớ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, lỗi INVALID_ARGUMENT sẽ được trả về.
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à có mức giá nhất định. Người dùng có thể chọn kết hợp các mức giá bất kỳ. Theo mặc định, tất cả các mức giá đều được chọn.
strict_type_filtering

bool

Dùng để đặt chế độ lọc theo loại nghiêm ngặt cho included_type. Nếu bạn đặt thành true, thì chỉ kết quả thuộc cùng một loại mới được trả về. 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à một thiên kiến, 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 hạn chế, tức là kết quả bên ngoài vị trí đã cho sẽ không được trả về. Không thể đặt cùng với location_bias.
ev_options

EVOptions

Không bắt buộc. Đặt các lựa chọn về 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ác doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng nếu trường được đặt thành true. Doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng là 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ỉ 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. 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í cho những doanh nghiệp này.

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 cần thiết (tính bằng kilowatt). Những địa điểm có mức sạc thấp hơn mức đã chỉ định sẽ bị lọc ra.
connector_types[]

EVConnectorType

Không bắt buộc. Danh sách các loại giắc cắm xe điện mà bạn muốn. Những địa điểm không hỗ trợ bất kỳ loại giắc cắm 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à một thiên kiến, tức là kết quả xung quanh vị trí đã cho có thể được trả về.

Trường

Trường nhóm 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 bằng 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(). Việc 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 hạn chế, tức là kết quả bên ngoài vị trí đã cho sẽ không được trả về.

Trường

Trường nhóm 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 bằng 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(). Việc 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 kết quả được xếp hạng trong câu trả lời.

Enum
RANK_PREFERENCE_UNSPECIFIED Đối với một cụm từ tìm kiếm theo danh mục, chẳng hạn như "Nhà hàng ở Thành phố New York", MỨC ĐỘ PHÙ HỢP 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, chẳng hạn như "Mountain View, CA", bạn nên giữ nguyên rankPreference.
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 đường nhiều đoạn được tính toán trước từ Routes API xác định tuyến đường cần tìm kiếm. Tìm kiếm dọc theo một tuyến đường tương tự như việc sử dụng lựa chọn yêu cầu locationBias hoặc locationRestriction để điều chỉnh kết quả tìm kiếm. Tuy nhiên, trong khi các lựa chọn locationBias và locationRestriction cho phép bạn chỉ định một khu vực để điều chỉnh kết quả tìm kiếm, thì lựa chọn này cho phép bạn điều chỉnh kết quả dọc theo một tuyến đường.

Kết quả không đả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ỳ chọn là do 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 trên một tuyến đường thay thế, đặc biệt nếu đường nhiều đoạn được cung cấp không xác định được tuyến đường tối ưu từ điểm khởi hành đến điểm đến.

Trường
polyline

Polyline

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

SearchTextResponse

Proto phản hồi cho SearchText.

Trường
places[]

Place

Danh sách những đị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 về việc định tuyến, 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 places. Nếu không có thông tin tóm tắt về đường đi cho một trong các địa điểm, thì thông tin đó sẽ chứa một mục trống. Danh sách này sẽ có số mục bằng với số địa điểm trong danh sách 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.

Một danh sách nội dung theo bối 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 nội dung theo bối cảnh không có sẵn cho một trong các vị trí, thì nội dung không theo bối cảnh sẽ được trả về. Nội dung này sẽ chỉ trống khi nội dung không có sẵn cho vị trí này. Danh sách này sẽ có số mục bằng với số địa điểm trong danh sách 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 cùng một cụm từ tìm kiếm dạng văn bản như được chỉ định trong yêu cầu trên Google Maps.

TravelMode

Các lựa chọn về phương tiện di chuyển. Các lựa chọn này tương ứng với những gì Routes API cung cấp.

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