Package google.maps.geocode.v4alpha

Chỉ mục

DestinationService

Dịch vụ truy xuất đích đến.

Điểm đến cung cấp bối cảnh phân cấp về một địa điểm, cho phép bạn, chẳng hạn như tìm các toà nhà chung cư trong một khu chung cư lớn hơn và ngược lại. API này cũng cung cấp các điểm điều hướng phù hợp với các trường hợp sử dụng như đi chung xe hoặc giao hàng.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Phương thức này thực hiện việc tra cứu đích đến và trả về danh sách đích đến.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

GeocodeService

Dịch vụ thực hiện việc mã hoá địa lý.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Phương thức này thực hiện mã hoá địa lý địa chỉ, tức là liên kết một địa chỉ với một LatLng. Trường này cũng cung cấp thông tin có cấu trúc về địa chỉ.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Phương thức này thực hiện mã hoá địa lý vị trí, tức là liên kết một LatLng với một địa chỉ. Trường này cũng cung cấp thông tin có cấu trúc về địa chỉ.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Phương thức này thực hiện tra cứu mã địa lý bằng Mã địa điểm.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Đích đến

Một đích đến. Thông tin này bao gồm địa điểm chính, các địa điểm liên quan, lối vào và điểm đi theo chỉ dẫn.

Trường
primary

PlaceView

Địa điểm chính được xác định bằng primary_query trong yêu cầu.
containing_places[]

PlaceView

Những địa điểm ít chính xác hơn chứa địa điểm chính. Ví dụ: khu chung cư có toà nhà này.
sub_destinations[]

PlaceView

Điểm đến phụ chính xác hơn của địa điểm chính. Ví dụ: các căn hộ trong một toà nhà.

Lưu ý: So với SubDestination do Places API trả về, danh sách điểm đến phụ này đầy đủ hơn và mỗi điểm đến phụ chứa nhiều thông tin hơn.
landmarks[]

Landmark

Địa danh có thể dùng để thông báo vị trí của điểm đến hoặc giúp người dùng đến nơi.
entrances[]

Entrance

Lối vào cho điểm đến này.
navigation_points[]

NavigationPoint

Điểm điều hướng cho đích đến này.
parking_options

Destination.ParkingOptions

Các lựa chọn đỗ xe cho điểm đến này.
arrival_summary

Destination.ArrivalSummary

Bản tóm tắt do AI tạo về trải nghiệm khi đến điểm đến.

ArrivalSummary

Bản tóm tắt do AI tạo về trải nghiệm khi đến điểm đến.

Trường
text

LocalizedText

Tóm tắt về trải nghiệm khi đến điểm đến.
flag_content_url

string

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

LocalizedText

Chỉ có đầu ra. Chứa văn bản công bố thông tin cho thông tin tóm tắt về chuyến bay đến.

ParkingOptions

Thông tin về các lựa chọn đỗ xe tại điểm đến.

Trường
availability

Destination.ParkingOptions.Availability

Tình trạng chỗ đỗ xe tại điểm đến này.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

Bãi đỗ xe của điểm đến này.
onsite_parking

bool

Điểm đến có bãi đỗ xe tại chỗ.
free_parking_lot

bool

Có bãi đỗ xe miễn phí.
paid_parking_lot

bool

Có bãi đỗ xe có tính phí.
free_street_parking

bool

Có chỗ đỗ xe miễn phí trên đường.
paid_street_parking

bool

Có chỗ đỗ xe trên đường có tính phí.
valet_parking

bool

Có dịch vụ đỗ xe.
free_garage_parking

bool

Có gara đỗ xe miễn phí.
paid_garage_parking

bool

Có gara đỗ xe có tính phí.

Phạm vi cung cấp

Thước đo tổng hợp về mức độ khó khăn khi tìm chỗ đỗ xe khi đến địa điểm này.

Các giá trị mới có thể được thêm vào trong tương lai.

Enum
AVAILABILITY_UNSPECIFIED Không có thông tin về tình trạng chỗ đỗ xe trống.
PLENTY Có nhiều chỗ đỗ xe.
SOMEWHAT_DIFFICULT Hơi khó tìm chỗ đỗ xe.
DIFFICULT Rất khó tìm chỗ đỗ xe.

ParkingFacility

Một lựa chọn đỗ xe riêng biệt (ví dụ: một gara đỗ xe hoặc bãi đỗ xe cụ thể) liên kết với điểm đến. Thông báo này cung cấp thông tin chi tiết về một bãi đỗ xe cụ thể, trong khi thông báo ParkingOptions chính cung cấp thông tin tóm tắt tổng hợp về tất cả bãi đỗ xe hiện có.

Trường
place

PlaceView

Thông tin đại diện cho địa điểm của bãi đỗ xe cụ thể này.
onsite

bool

Bãi đỗ xe này có nằm trong khuôn viên của điểm đến chính hay không. Nếu bạn không đặt trường này, thì trạng thái tại chỗ sẽ không xác định.
popular

bool

Bãi đỗ xe này có phải là lựa chọn phổ biến cho khách đến điểm đến chính hay không. Nếu bạn không đặt trường này, thì trạng thái mức độ phổ biến sẽ không xác định.
straight_line_distance_meters

double

Khoảng cách theo đường thẳng (tính bằng mét) từ điểm đến chính đến bãi đỗ xe này.

Lối vào

Lối vào là một cặp toạ độ vĩ độ/kinh độ duy nhất xác định vị trí của điểm vào và điểm ra của một địa điểm.

Trường
display_name

LocalizedText

Tên dễ đọc, ví dụ: "Cổng B", "Lối vào phía Nam", "Lối vào Đại lộ số 5".
location

LatLng

Vị trí của lối vào.
tags[]

Entrance.Tag

Danh sách các thẻ mô tả lối vào.
place

string

Cấu trúc mà lối vào này thực sự nằm trên đó, ở định dạng places/{place_id}.
street_view_thumbnail

StreetViewThumbnail

Hình thu nhỏ của Chế độ xem đường phố cho thấy lối vào. Bạn có thể yêu cầu hình ảnh từ API Chế độ xem đường phố tĩnh. Hãy xem https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation

ImageAnnotation

Chú thích về lối vào trên street_view_thumbnail được trả về ở trên.

Thẻ

Đặc điểm mô tả lối vào.

Enum
TAG_UNSPECIFIED Không được sử dụng.
PREFERRED

Lối vào có thể là lối đi thực tế đến địa điểm chính trong điểm đến được trả về. Một địa điểm có thể có nhiều lối vào ưu tiên. Nếu một lối vào không có thẻ này, thì có nghĩa là lối vào đó nằm trên cùng một toà nhà với địa điểm chính, nhưng không nhất thiết phải dẫn vào địa điểm đó.

Ví dụ: nếu địa điểm chính là một nhà hàng trong trung tâm mua sắm, thì lối vào "ƯU TIÊN" sẽ là lối vào có khả năng dẫn đến chính nhà hàng đó, còn các lối vào khác được trả về sẽ là các lối vào khác của toà nhà, chẳng hạn như lối vào các nhà hàng khác trong trung tâm mua sắm.

Nếu địa điểm chính là một toà nhà, thì lối vào PREFERRED sẽ là lối vào dẫn đến phần "chính" của toà nhà. Ví dụ: trong một trung tâm mua sắm, lối vào PREFERRED sẽ là lối vào cho phép đi vào khu vực sảnh chính, nhưng nếu một lối vào chỉ cho phép đi vào một cửa hàng ở bên hông toà nhà, thì đó sẽ không phải là lối vào PREFERRED.

Lưu ý: lối vào PREFERRED có thể không dẫn đến địa điểm chính và lối vào không phải PREFERRED có thể dẫn đến địa điểm chính.

GeocodeAddressRequest

Thông báo yêu cầu cho GeocodeService.GeocodeAddress.

Trường
location_bias

GeocodeAddressRequest.LocationBias

Không bắt buộc. 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à các kết quả xung quanh vị trí đã cho sẽ được ưu tiên.
language_code

string

Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
region_code

string

Không bắt buộc. Mã vùng. Mã khu vực, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Tham số này ảnh hưởng đến kết quả dựa trên luật hiện hành. Tham số này cũng sẽ ảnh hưởng đến kết quả của dịch vụ, nhưng không hạn chế hoàn toàn.
Trường nhóm address_input. Địa chỉ cần mã hoá địa lý. address_input chỉ có thể là một trong những trạng thái sau:
address_query

string

Địa chỉ không có cấu trúc để mã hoá địa lý.
address

PostalAddress

Địa chỉ có cấu trúc để mã hoá địa lý theo định dạng địa chỉ bưu chính.

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à các kết quả xung quanh vị trí đã cho sẽ được ưu tiên.

Trường
Trường nhóm type. Các loại thiên vị vị trí. 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 đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm tây nam của khung nhìn hình chữ nhật. rectangle.low().latitude() không được lớn hơn rectangle.high().latitude(). Việc này sẽ dẫn đến phạm vi vĩ độ trống. Khung nhìn hình chữ nhật không được rộng hơn 180 độ.

GeocodeAddressResponse

Tin nhắn phản hồi cho GeocodeService.GeocodeAddress.

Trường
results[]

GeocodeResult

Kết quả mã hoá địa lý.

GeocodeLocationRequest

Thông báo yêu cầu cho GeocodeService.GeocodeLocation.

Trường
language_code

string

Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
region_code

string

Không bắt buộc. Mã vùng. Mã khu vực, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Tham số này ảnh hưởng đến kết quả dựa trên luật hiện hành.
types[]

string

Không bắt buộc. Một tập hợp các thẻ loại để giới hạn kết quả. Những kết quả không có bất kỳ loại nào được chỉ định sẽ bị xoá.

Để 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.
granularity[]

GeocodeResult.Granularity

Không bắt buộc. Bộ lọc gồm một hoặc nhiều enum về mức độ chi tiết của vị trí.
Trường nhóm location_input. Vị trí cần mã hoá địa lý. location_input chỉ có thể là một trong những trạng thái sau:
location_query

string

Vị trí ở định dạng chuỗi "lat,lng". Ví dụ: "64.7611872,-18.4705364".
location

LatLng

Vị trí ở định dạng có cấu trúc.

GeocodeLocationResponse

Tin nhắn phản hồi cho GeocodeService.GeocodeLocation.

Trường
results[]

GeocodeResult

Kết quả mã hoá địa lý.
plus_code

PlusCode

Plus Code của vị trí trong yêu cầu.

GeocodePlaceRequest

Thông báo yêu cầu cho GeocodeService.GeocodePlace.

Trường
place

string

Bắt buộc. Giá trị nhận dạng địa điểm để mã hoá địa lý theo định dạng places/{place}.
language_code

string

Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
region_code

string

Không bắt buộc. Mã vùng. Mã khu vực, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Tham số này ảnh hưởng đến kết quả dựa trên luật hiện hành.

GeocodeResult

Kết quả mã hoá địa lý chứa thông tin địa lý về một địa điểm.

Trường
place

string

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

string

Giá trị nhận dạng riêng biệt của một địa điểm.
location

LatLng

Vĩ độ và kinh độ của địa chỉ này.
granularity

GeocodeResult.Granularity

Độ chi tiết của vị trí.
viewport

Viewport

Khung nhìn phù hợp để hiển thị kết quả mã hoá địa lý.
bounds

Viewport

Hộp giới hạn cho địa chỉ.
formatted_address

string

Địa chỉ được định dạng trên một dòng.
postal_address

PostalAddress

Địa chỉ ở định dạng địa chỉ bưu chính.
address_components[]

GeocodeResult.AddressComponent

Các thành phần lặp lại cho từng cấp địa phương.
postal_code_localities[]

LocalizedText

Danh sách đầy đủ các địa phương có trong mã bưu chính.

Trường này chỉ được điền sẵn khi kết quả thuộc loại "postal_code".
types[]

string

Một tập hợp các thẻ loại cho kết quả này. Ví dụ: "political" và "administrative_area".

Để 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.
plus_code

PlusCode

Plus Code của vị trí trong mã địa lý này.

AddressComponent

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

Trường
long_text

string

Nội dung mô tả 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ó tên dài là "Úc".
short_text

string

Tên viết tắt của thành phần địa chỉ (nếu có). Ví dụ: một thành phần địa chỉ cho quốc gia Úc có thể có tên ngắn là "AU".
types[]

string

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

Các giá trị này được lấy từ bảng Loại địa chỉ và loại thành phần địa chỉ mà Places API sử dụng: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

Độ chi tiết

Độ chi tiết của vị trí.

Enum
GRANULARITY_UNSPECIFIED Không được dùng.
ROOFTOP Vị trí không nội suy của một thửa đất thực tế tương ứng với địa chỉ trùng khớp.
RANGE_INTERPOLATED Được nội suy từ một dải số nhà. Ví dụ: nếu chúng tôi biết rằng một đoạn của Amphitheatre Pkwy chứa các số từ 1600 đến 1699, thì số 1650 có thể được đặt ở giữa các điểm cuối của đoạn đó.
GEOMETRIC_CENTER Tâm hình học của một đối tượng mà chúng tôi có dữ liệu đa giác.
APPROXIMATE Mọi thứ khác.

ImageAnnotation

Chú thích trên hình thu nhỏ của hình ảnh, chẳng hạn như một đa giác phác thảo lối vào.

Trường
coordinates[]

ImageAnnotation.Coordinate

Danh sách toạ độ tạo thành một đa giác trên hình ảnh. Toạ độ được sắp xếp ngược chiều kim đồng hồ.

Toạ độ

Toạ độ pixel của một điểm trên hình ảnh. Gốc toạ độ (0,0) là góc trên cùng bên trái của pixel trên cùng bên trái của hình ảnh, với trục x hướng sang phải và trục y hướng xuống dưới.

Trường
x_px

float

Toạ độ X.
y_px

float

Toạ độ Y.

Địa danh

Địa danh được dùng để cho biết vị trí của điểm đến hoặc giúp người dùng đến được điểm đến.

Trường
relational_description

LocalizedText

Nội dung mô tả mà con người có thể đọc được về mối liên hệ giữa điểm đến và địa danh. Ví dụ: "Gần Toà nhà Empire State" hoặc "Đối diện Nhà Trắng".
tags[]

Landmark.Tag

Thẻ mô tả cách sử dụng địa danh trong bối cảnh của điểm đến.
straight_line_distance_meters

double

Chỉ có đầu ra. Khoảng cách theo đường thẳng từ địa danh này đến điểm đến (tính bằng mét).
travel_distance_meters

double

Chỉ có đầu ra. Khoảng cách đi bộ từ địa danh này đến điểm đến (tính bằng mét).
Trường nhóm landmark. Địa danh. landmark chỉ có thể là một trong những trạng thái sau:
place

PlaceView

Địa điểm đại diện cho địa danh này.

Thẻ

Danh sách tất cả các thẻ có thể có mô tả cách sử dụng địa danh trong bối cảnh của một điểm đến.

Nếu một địa chỉ có cả thẻ ADDRESS và ARRIVAL, thì tức là địa danh đó vừa nổi bật tại địa phương vừa gần điểm đến.

Enum
TAG_UNSPECIFIED Không được sử dụng.
ADDRESS Một địa điểm nổi bật tại địa phương có thể dùng để xác định vị trí khái quát của điểm đến. Thường là trong phạm vi vài trăm mét tính từ điểm đến. Các địa danh này tương tự như địa danh được trả về bằng tính năng Thông tin mô tả địa chỉ của Geocoding API: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Một địa điểm có thể giúp bạn đến được điểm đến. Hữu ích cho việc chỉ đường khi bạn đã đến gần điểm đến. Ví dụ: địa danh này có thể là một địa điểm nằm đối diện với điểm đến. Địa danh có thẻ này thường gần điểm đến hơn so với địa danh có thẻ ADDRESS.

Điểm chỉ dẫn là một vị trí bên cạnh đường mà tại đó, quá trình chỉ dẫn có thể kết thúc.

Trường
navigation_point_token

string

Chỉ có đầu ra. Mã thông báo có thể dùng để xác định điểm điều hướng này.
display_name

LocalizedText

Tên hiển thị của điểm điều hướng này. Ví dụ: "Đại lộ 5" hoặc "Cổng B".
location

LatLng

Một điểm bên cạnh đoạn đường mà tại đó quá trình chỉ đường sẽ kết thúc. Điểm này được cố ý đặt lệch một chút so với đường tâm của đường để đánh dấu rõ ràng bên đường nơi địa điểm đó toạ lạc.
travel_modes[]

NavigationPoint.TravelMode

Các phương tiện di chuyển phù hợp với điểm đi theo chỉ dẫn này.
usages[]

NavigationPoint.Usage

Liệt kê usages được điểm điều hướng này hỗ trợ. Nếu trống, điều này không nhất thiết có nghĩa là việc sử dụng bị hạn chế theo bất kỳ cách nào. Bạn có thể sử dụng tất cả các điểm điều hướng để điều hướng chung.
street_view_thumbnail

StreetViewThumbnail

Hình thu nhỏ của Chế độ xem đường phố cho thấy điểm chỉ đường (nếu có). Bạn có thể yêu cầu hình ảnh từ API Chế độ xem đường phố tĩnh. Hãy xem https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation

ImageAnnotation

Chú thích về lối vào liên kết với điểm điều hướng này trên street_view_thumbnail được trả về ở trên (nếu có).
altitude_meters

float

Độ cao của điểm điều hướng tính bằng mét so với hình elip WGS-84.

TravelMode

Các phương tiện di chuyển phù hợp với điểm đi theo chỉ dẫn này.

Enum
TRAVEL_MODE_UNSPECIFIED Không được sử dụng.
DRIVE Phù hợp để lái xe.
WALK Phù hợp để đi bộ.

Cách sử dụng

Các mục đích sử dụng được điểm điều hướng này hỗ trợ. Các giá trị mới có thể được thêm vào trong tương lai.

Enum
USAGE_UNSPECIFIED Không được sử dụng.
UNKNOWN Cho biết loại hình sử dụng không xác định.
DROPOFF Phù hợp để trả khách. Ví dụ: điểm trả khách của dịch vụ đi chung xe.
PICKUP Phù hợp để đón hành khách. Ví dụ: địa điểm đón khách đi chung xe.
PARKING Phù hợp để đỗ xe. Ví dụ: trong bãi đỗ xe.

PlaceView

Đại diện cho một khung hiển thị của Địa điểm trong Places API. Dữ liệu này cũng cung cấp thêm thông tin dành riêng cho các điểm đến, chẳng hạn như loại cấu trúc và đa giác hiển thị.

Trong một số trường hợp, PlaceView có cùng mã địa điểm có thể khác với thông tin mà API Địa điểm trả về cho các trường types và display_name.

Trường
place

string

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

string

Giá trị nhận dạng riêng biệt của một địa điểm.
display_name

LocalizedText

Nội dung mô tả địa điểm mà con người có thể đọc được. Ví dụ: "Cổng B", "McDonalds"
primary_type

string

Loại địa điểm chính của địa điểm này. Hãy xem https://developers.google.com/maps/documentation/places/web-service/place-types để biết danh sách các giá trị có thể có.

Lưu ý: Trường này không phải lúc nào cũng được điền sẵn. Hãy chuẩn bị sử dụng trường types trong những trường hợp như vậy.
types[]

string

Tất cả các loại địa điểm liên kết với địa điểm này. Hãy xem https://developers.google.com/maps/documentation/places/web-service/place-types để biết danh sách các giá trị có thể có.
formatted_address

string

Địa chỉ một dòng.
postal_address

PostalAddress

Địa chỉ có cấu trúc.
structure_type

PlaceView.StructureType

Loại cấu trúc tương ứng với địa điểm này.
location

LatLng

Vị trí của địa điểm này. Đối với những địa điểm có đa giác hiển thị, đây có thể là một điểm phù hợp để đặt điểm đánh dấu trên bản đồ.
display_polygon

Struct

Đường viền đa giác của địa điểm ở định dạng GeoJSON, sử dụng định dạng RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Lưu ý: Định dạng RFC 7946 hỗ trợ MultiPolygons, vì vậy, một đối tượng display_polygon có thể đại diện cho nhiều đa giác.
address_components[]

PlaceView.AddressComponent

Các thành phần lặp lại cho từng cấp địa phương.

AddressComponent

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

Trường
long_text

string

Nội dung mô tả 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ó tên dài là "Úc".
short_text

string

Tên viết tắt của thành phần địa chỉ (nếu có). Ví dụ: một thành phần địa chỉ cho quốc gia Úc có thể có tên ngắn là "AU".
types[]

string

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

Các giá trị này được lấy từ bảng Loại địa chỉ và loại thành phần địa chỉ mà Places API sử dụng: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

StructureType

Loại cấu trúc mà địa điểm này đại diện.

Enum
STRUCTURE_TYPE_UNSPECIFIED Không được sử dụng.
POINT Vị trí điểm.
SECTION Một phần phụ của toà nhà.
BUILDING Một toà nhà.
GROUNDS Một khu vực rộng lớn thường có nhiều toà nhà, chẳng hạn như khuôn viên trường đại học, khu chung cư hoặc trung tâm mua sắm.

PlusCode

Plus Code (http://plus.codes) là một thông tin tham chiếu vị trí có hai định dạng: mã toàn cầu xác định một hình chữ nhật 14m x 14m (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", đại diện cho một khu vực có kích thước 1/8000 x 1/8000 độ (~14 x 14 mét).
compound_code

string

Mã kết hợp của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Norway", 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.

SearchDestinationsRequest

Thông báo yêu cầu cho DestinationService.SearchDestinations.

Trường
travel_modes[]

NavigationPoint.TravelMode

Không bắt buộc. Các phương tiện di chuyển để lọc điểm đi theo chỉ dẫn. Điều này ảnh hưởng đến trường navigation_points được trả về trong phản hồi. Nếu bạn để trống, hệ thống sẽ trả về điểm đi theo chỉ dẫn của tất cả phương tiện đi lại.
language_code

string

Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
region_code

string

Không bắt buộc. Mã vùng. Mã khu vực, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Tham số này ảnh hưởng đến kết quả dựa trên luật hiện hành. Tham số này cũng ảnh hưởng đến kết quả của dịch vụ nhưng không hạn chế hoàn toàn.

Trường nhóm primary_query. Truy vấn cho đích đến chính. Đây có thể là một địa điểm, một địa chỉ được chỉ định đầy đủ hoặc một vị trí LatLng. Một số địa điểm và địa chỉ có ít thông tin sẽ không thể trở thành điểm đến.

Các đích đến được xây dựng dựa trên truy vấn chính đã chỉ định.

Lưu ý: Chỉ hỗ trợ những địa điểm và địa chỉ có thể có điểm đến để đi theo chỉ dẫn. Ví dụ: một địa điểm đại diện cho một ngôi nhà hoặc khu chung cư có thể được dùng làm truy vấn chính, nhưng những địa điểm đại diện cho một địa phương hoặc khu vực hành chính thì không thể dùng làm truy vấn chính. primary_query chỉ có thể là một trong những trạng thái sau:
place

string

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

SearchDestinationsRequest.AddressQuery

Địa chỉ đường phố.
location_query

SearchDestinationsRequest.LocationQuery

Vị trí chính xác.

AddressQuery

Địa chỉ đường phố mà bạn muốn tìm kiếm. Hãy chỉ định địa chỉ theo định dạng mà dịch vụ bưu chính quốc gia của quốc gia liên quan sử dụng.

Trường
Trường nhóm kind. Cụm từ tìm kiếm địa chỉ. kind chỉ có thể là một trong những trạng thái sau:
address

PostalAddress

Địa chỉ đường phố theo định dạng địa chỉ bưu chính.
address_query

string

Địa chỉ đường phố được định dạng dưới dạng một dòng.

LocationQuery

Một cụm từ tìm kiếm vị trí để xác định một điểm đến chính ở gần.

Lưu ý: nếu truy vấn vị trí nằm trong một toà nhà có chứa các cơ sở phụ, thì có thể địa điểm chính được trả về là một cơ sở phụ. Trong những trường hợp này, trường containing_places sẽ bao gồm toà nhà.

Trường
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Không bắt buộc. Bộ lọc để áp dụng cho các ứng viên đích.
Trường nhóm kind. Cụm từ tìm kiếm về vị trí. kind chỉ có thể là một trong những trạng thái sau:
location

LatLng

Vị trí chính xác theo vĩ độ và kinh độ.

PlaceFilter

Bộ lọc để áp dụng cho các ứng viên đích.

Trường
structure_type

PlaceView.StructureType

Không bắt buộc. Nếu được chỉ định, tất cả các điểm đến đều được đảm bảo có một địa điểm chính thuộc loại cấu trúc này. Điều này có thể dẫn đến việc lọc ra một số điểm đến hoặc làm thô/tinh chỉnh các điểm đến được trả về.

Ví dụ: nếu bạn chỉ định GROUNDS, thì tất cả điểm đến được trả về sẽ có một địa điểm chính thuộc loại cấu trúc GROUNDS. Điều này có thể dẫn đến việc lọc ra một số điểm đến không thuộc khuôn viên hoặc làm giảm độ chính xác của điểm đến được trả về ở cấp khuôn viên.

Một cách sử dụng khác của trường này là để dễ dàng trích xuất đa giác hiển thị toà nhà. Ví dụ: nếu bạn chỉ định BUILDING, thì đa giác hiển thị của địa điểm chính sẽ là của toà nhà tại vị trí được chỉ định.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

Không bắt buộc. Nếu được chỉ định, chỉ trả về những đích đến đáp ứng tiêu chí về khả năng nhắm mục tiêu tương ứng.

Khả năng nhắm mục tiêu

Xác định các lựa chọn để lọc khả năng nhắm mục tiêu. Các giá trị mới có thể được thêm vào trong tương lai.

Enum
ADDRESSABILITY_UNSPECIFIED Khi không được chỉ định, dịch vụ sẽ chọn một giá trị mặc định hợp lý.
ANY Khả năng nhắm mục tiêu không phải là một tiêu chí lọc. Các đích đến được trả về bất kể khả năng xác định địa chỉ của chúng.
PRIMARY Tất cả điểm đến được trả về sẽ có một địa điểm chính kèm theo địa chỉ hoặc tên đường.
WEAK Tất cả điểm đến được trả về sẽ có một địa điểm chính hoặc một điểm đến phụ có địa chỉ hoặc tên đường.

SearchDestinationsResponse

Thông báo phản hồi cho DestinationService.SearchDestinations.

Trường
destinations[]

Destination

Danh sách đích đến.

Dịch vụ này sẽ trả về một kết quả nếu có thể xác định rõ ràng một đích đến chính từ truy vấn chính. Nếu không, dịch vụ có thể trả về nhiều kết quả để phân định hoặc không trả về kết quả nào.

StreetViewThumbnail

Các tham số để biểu thị hình thu nhỏ của Chế độ xem đường phố của Google. Bạn có thể sử dụng các tham số này để yêu cầu hình ảnh trong chế độ xem đường phố từ API tĩnh của Chế độ xem đường phố. Hãy xem https://developers.google.com/maps/documentation/streetview/request-streetview.

Trường
pano

string

Mã nhận dạng ảnh toàn cảnh cụ thể.
width_px

int32

Chiều rộng của hình thu nhỏ đầu ra, tính bằng pixel. Lưu ý: Khi yêu cầu chú thích cùng với hình thu nhỏ, bạn phải sử dụng các giá trị chiều cao và chiều rộng này trong yêu cầu API Chế độ xem đường phố để đảm bảo toạ độ chú thích khớp chính xác với hình ảnh.
height_px

int32

Chiều cao của hình thu nhỏ đầu ra, tính bằng pixel. Lưu ý: Khi yêu cầu chú thích cùng với hình thu nhỏ, bạn phải sử dụng các giá trị chiều cao và chiều rộng này trong yêu cầu API Chế độ xem đường phố để đảm bảo toạ độ chú thích khớp chính xác với hình ảnh.
heading_degree

float

Hướng ngang của camera tính bằng độ. Phạm vi [0, 360). 0 cho biết hướng Bắc và 90 cho biết hướng Đông.
pitch_degree

float

Hướng dọc của camera, tính bằng độ. Phạm vi [-90, 90]. 0 là đường chân trời, +90 là thẳng lên, -90 là thẳng xuống.
fov_degree

float

Trường nhìn ngang tính bằng độ. Phạm vi (0, 180]. Điều khiển mức thu phóng. FOV càng nhỏ thì mức thu phóng càng lớn.