Package google.maps.geocode.v4alpha

Chỉ mục

DestinationService

Một dịch vụ để truy xuất các đích đến.

Đích đến cung cấp bối cảnh phân cấp về một địa điểm, cho phép bạn 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 một thao tác tra cứu đích đến và trả về danh sách các đí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

GeocodeService

Một 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ột mã địa lý địa chỉ, ánh xạ một địa chỉ đến LatLng. Ngoài ra, API này còn 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ột mã hoá địa lý vị trí, giúp liên kết một LatLng với một địa chỉ. Ngoài ra, API này còn 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 một thao tác 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 điểm đến. Điều 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ều hướng.

Trường
primary

PlaceView

Địa điểm chính do primary_query xác định trong yêu cầu.

containing_places[]

PlaceView

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

sub_destinations[]

PlaceView

Các địa điểm 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 các đ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 để cho biết vị trí của đích đến hoặc giúp bạn đến nơi.

entrances[]

Entrance

Lối vào của địa điểm này.

navigation_points[]

NavigationPoint

Các điểm điều hướng cho đích đến này.

arrival_summary

Destination.ArrivalSummary

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

ArrivalSummary

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

Trường
text

LocalizedText

Nội dung tóm tắt về trải nghiệm khi đến nơi tại điểm đến.

flag_content_url

string

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

disclosure_text

LocalizedText

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

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 cho một địa điểm.

Trường
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 nằm trên đó, ở định dạng places/{place_id}.

Thẻ

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

Enum
TAG_UNSPECIFIED Không được dùng.
PREFERRED

Lối vào này có thể giúp bạn đến được địa điểm chính trong đích đế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, tức là lối vào đó nằm trong cùng toà nhà với địa điểm chính, nhưng không nhất thiết phải có lối vào địa điểm đó.

Ví dụ: nếu địa điểm chính là một nhà hàng trong khu mua sắm, thì các lối vào "ƯU TIÊN" sẽ là những lối vào có khả năng dẫn vào chính nhà hàng đó, trong khi các lối vào khác được trả về sẽ là những 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 khu mua sắm.

Nếu địa điểm chính là một toà nhà, thì PREFERRED lối vào sẽ là những lối dẫn vào phần "chính" của toà nhà. Ví dụ: trong một trung tâm mua sắm, các lối vào PREFERRED sẽ là những lối vào cho phép bạn đi vào khu vực sảnh chính, nhưng nếu một lối vào chỉ cho phép bạn đ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 có biểu tượng PREFERRED có thể không dẫn đến địa điểm chính, còn lối vào không có biểu tượng 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à kết quả xung quanh vị trí đã cho có thể được trả về.

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 là giá trị gồm 2 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 (nhưng không hạn chế hoàn toàn) đến kết quả của dịch vụ.

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ý ở đị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à kết quả xung quanh vị trí đã cho có thể được trả về.

Trường
Trường nhóm type. Các loại thiên kiế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 ở 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 độ.

GeocodeAddressResponse

Thông báo 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 là giá trị gồm 2 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 nhóm thẻ loại để hạn chế kết quả. Những kết quả không có 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

Thông báo 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 địa điểm/{địa điểm}.

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 là giá trị gồm 2 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

Giá trị nhận dạng địa điểm đủ điều kiện cho kết quả này. Theo định dạng "//places.googleapis.com/places/{placeID}". Hãy xem https://developers.google.com/maps/documentation/places/web-service/place-id để biết thêm thông tin chi tiết.

place_id

string

Mã địa điểm cho kết quả này.

location

LatLng

LatLng của địa chỉ này.

granularity

GeocodeResult.Granularity

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

viewport

Viewport

Một khung hiển thị phù hợp để hiển thị kết quả mã hoá địa lý.

bounds

Viewport

Một hộp bao quanh 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.

Tham số này chỉ được điền sẵn khi kết quả thuộc loại "postal_code".

types[]

string

Một nhóm 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 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ó tên dài 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ó tên viết tắt là "AU".

types[]

string

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

Hãy xem https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types để biết thêm thông tin chi tiết.

language_code

string

Ngôn ngữ dùng để định dạng các 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 được 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 Nội suy từ một dải số nhà. Ví dụ: nếu chúng ta biết rằng một đoạn đường Amphitheatre Pkwy có số nhà từ 1600 đến 1699, thì số nhà 1650 có thể được đặt ở giữa các điểm cuối.
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.

Địa danh

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

Trường
relational_description

LocalizedText

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

tags[]

Landmark.Tag

Các thẻ mô tả cách sử dụng địa điểm nổi tiếng trong bối cảnh của đích đến.

straight_line_distance_meters

double

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

travel_distance_meters

double

Chỉ có đầu ra. Khoảng cách theo mạng lưới đường bộ từ địa danh này đến đích đế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ể mô tả cách sử dụng một địa danh trong bối cảnh của một đích đến.

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

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

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

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à chỉ dẫn nên kết thúc. Điểm này được cố ý đặt lệch một chút so với đường tim của đường để đánh dấu rõ ràng phía đường nơi địa điểm đó nằm.

travel_modes[]

NavigationPoint.TravelMode

Các chế độ di chuyển phù hợp với điểm điều hướng này.

usages[]

NavigationPoint.Usage

Các cách sử dụng được điểm điều hướng này hỗ trợ.

TravelMode

Các chế độ di chuyển phù hợp với điểm điều hướng này.

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

Cách sử dụng

Các cách sử dụng được điểm điều hướng này hỗ trợ.

Enum
USAGE_UNSPECIFIED Không được dùng.
UNKNOWN Loại mức sử dụng không xác định. Hầu hết các điểm điều hướng sẽ là UNKNOWN và điều này không nhất thiết có nghĩa là việc sử dụng các điểm này bị hạn chế theo bất kỳ cách nào. Thông tin chỉ đường này vẫn có thể phù hợp với việc đến lấy hàng và/hoặc trả hàng.
DROPOFF Phù hợp để trả khách. Ví dụ: vị trí trả khách của dịch vụ đi chung xe.
PICKUP Phù hợp để đón hành khách. Ví dụ: vị trí đón xe đi chung.

PlaceView

Biểu thị một khung hiển thị của Địa điểm trong Places API. Ngoài ra, thông tin này cũng cung cấp thêm thông tin cụ thể về 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 mã địa điểm mà Places API trả về cho các trường typesdisplay_name.

Trường
place

string

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

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 được 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ỉ trên 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 vị trí 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ợ MultiPolygon, vì vậy, một đối tượng display_polygon có thể biểu thị nhiều đa giác.

StructureType

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

Enum
STRUCTURE_TYPE_UNSPECIFIED Không được dùng.
POINT Vị trí điểm.
SECTION Một phần 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 phức hợp căn hộ hoặc trung tâm mua sắm.

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.

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 chế độ di chuyển để lọc các điểm điều hướng. Đ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 có thể trả về các điểm điều hướng 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 là giá trị gồm 2 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 (nhưng không hạn chế hoàn toàn) đến kết quả của dịch vụ.

Trường nhóm primary_query. Truy vấn điểm đế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ể chuyển thành điểm đến.

Các đích đến được xây dựng dựa trên cụm từ tìm kiếm chính đã chỉ định.

Lưu ý: chỉ những địa điểm và địa chỉ có thể có đích đến điều hướng mới được hỗ trợ. Ví dụ: bạn có thể dùng một địa điểm đại diện cho một ngôi nhà hoặc khu chung cư làm cụm từ tìm kiếm chính, nhưng không thể dùng những địa điểm đại diện cho một địa phương hoặc khu vực hành chính làm cụm từ tìm kiếm 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. Truy vấn địa chỉ. kind chỉ có thể là một trong những trạng thái sau:
address

PostalAddress

Địa chỉ đường phố ở đị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 duy nhất.

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 đề xuất đích đến.

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

LatLng

Vị trí LatLng chính xác.

PlaceFilter

Bộ lọc để áp dụng cho các đề xuất đích đến.

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 đảm bảo có một địa điểm chính với 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ả các đích đến được trả về sẽ có một địa điểm chính với 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 cho các đ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 các đa giác hiển thị của 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à 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í tương ứng về khả năng định địa chỉ.

Khả năng nhắm đến

Xác định các lựa chọn để lọc khả năng định địa chỉ. 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 địa chỉ không phải là tiêu chí lọc. Các đích đến được trả về bất kể khả năng định địa chỉ của chúng.
PRIMARY Tất cả các đích đến được trả về sẽ có một địa điểm chính với địa chỉ hoặc tên ở cấp đường.
WEAK Tất cả các đích đến được trả về sẽ có một địa điểm chính hoặc một đích đế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 các đích đến.

Dịch vụ này 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 biệt hoặc không có kết quả nào.