Chỉ mục
DestinationService(giao diện)GeocodeService(giao diện)Destination(thông báo)Destination.ArrivalSummary(thông báo)Entrance(thông báo)Entrance.Tag(enum)GeocodeAddressRequest(thông báo)GeocodeAddressRequest.LocationBias(thông báo)GeocodeAddressResponse(thông báo)GeocodeLocationRequest(thông báo)GeocodeLocationResponse(thông báo)GeocodePlaceRequest(thông báo)GeocodeResult(thông báo)GeocodeResult.AddressComponent(thông báo)GeocodeResult.Granularity(enum)Landmark(thông báo)Landmark.Tag(enum)NavigationPoint(thông báo)NavigationPoint.TravelMode(enum)NavigationPoint.Usage(enum)PlaceView(thông báo)PlaceView.StructureType(enum)PlusCode(thông báo)SearchDestinationsRequest(thông báo)SearchDestinationsRequest.AddressQuery(thông báo)SearchDestinationsRequest.LocationQuery(thông báo)SearchDestinationsRequest.LocationQuery.PlaceFilter(thông báo)SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability(enum)SearchDestinationsResponse(thông báo)
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 |
|---|
|
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.
|
GeocodeService
Một dịch vụ để thực hiện việc mã hoá địa lý.
| GeocodeAddress |
|---|
|
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ỉ.
|
| GeocodeLocation |
|---|
|
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ỉ.
|
| GeocodePlace |
|---|
|
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.
|
Đí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 |
Địa điểm chính do |
containing_places[] |
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[] |
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[] |
Đị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[] |
Lối vào của địa điểm này. |
navigation_points[] |
Các điểm điều hướng cho đích đến này. |
arrival_summary |
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 |
Nội dung tóm tắt về trải nghiệm khi đến nơi tại điểm đến. |
flag_content_url |
Đườ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 |
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 |
Vị trí của lối vào. |
tags[] |
Danh sách các thẻ mô tả lối vào. |
place |
Cấu trúc mà lối vào này nằm trên đó, ở định dạng |
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ì Lưu ý: Lối vào có biểu tượng |
GeocodeAddressRequest
Thông báo yêu cầu cho GeocodeService.GeocodeAddress.
| Trường | |
|---|---|
location_bias |
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 |
Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về. |
region_code |
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 |
Địa chỉ không có cấu trúc để mã hoá địa lý. |
address |
Đị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 |
Một hộp hình chữ nhật được xác định bằng góc đông bắc và tây nam. |
GeocodeAddressResponse
Thông báo phản hồi cho GeocodeService.GeocodeAddress.
| Trường | |
|---|---|
results[] |
Kết quả mã hoá địa lý. |
GeocodeLocationRequest
Thông báo yêu cầu cho GeocodeService.GeocodeLocation.
| Trường | |
|---|---|
language_code |
Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về. |
region_code |
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[] |
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[] |
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 |
Vị trí ở định dạng chuỗi "lat,lng". Ví dụ: "64.7611872,-18.4705364". |
location |
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[] |
Kết quả mã hoá địa lý. |
plus_code |
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 |
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 |
Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về. |
region_code |
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 |
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 |
Mã địa điểm cho kết quả này. |
location |
LatLng của địa chỉ này. |
granularity |
Độ chi tiết của vị trí. |
viewport |
Một khung hiển thị phù hợp để hiển thị kết quả mã hoá địa lý. |
bounds |
Một hộp bao quanh cho địa chỉ. |
formatted_address |
Địa chỉ được định dạng trên một dòng. |
postal_address |
Địa chỉ ở định dạng địa chỉ bưu chính. |
address_components[] |
Các thành phần lặp lại cho từng cấp độ địa phương. |
postal_code_localities[] |
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[] |
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 |
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 |
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 |
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[] |
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 |
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 |
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[] |
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 |
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 |
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 |
Đị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ẻ ADDRESS và ARRIVAL, 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. |
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 types và display_name.
| Trường | |
|---|---|
place |
Tên tài nguyên của địa điểm này, ở định dạng |
display_name |
Nội dung mô tả địa điểm mà con người có thể đọc được. Ví dụ: "Cổng B", "McDonalds" |
primary_type |
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[] |
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 |
Địa chỉ trên một dòng. |
postal_address |
Địa chỉ có cấu trúc. |
structure_type |
Loại cấu trúc tương ứng với địa điểm này. |
location |
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 |
Đườ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 |
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 |
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 |
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[] |
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 |
language_code |
Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về. |
region_code |
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 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. |
|
place |
Tên tài nguyên của một địa điểm, ở định dạng |
address_query |
Địa chỉ đường phố. |
location_query |
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 |
Địa chỉ đường phố ở định dạng địa chỉ bưu chính. |
address_query |
Đị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 |
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 |
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 |
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 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 |
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[] |
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. |