- Yêu cầu HTTP
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- SearchDestinationsRequest.AddressQuery
- SearchDestinationsRequest.LocationQuery
- SearchDestinationsRequest.LocationQuery.PlaceFilter
- PlaceView.StructureType
- SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
- NavigationPoint.TravelMode
- Đích đến
- PlaceView
- PlaceView.AddressComponent
- Điểm mốc
- Landmark.Tag
- Lối vào
- Entrance.Tag
- StreetViewThumbnail
- ImageAnnotation
- ImageAnnotation.Coordinate
- NavigationPoint
- NavigationPoint.Usage
- Destination.ParkingOptions
- Destination.ParkingOptions.Availability
- Destination.ParkingOptions.ParkingFacility
- Destination.ArrivalSummary
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.
Yêu cầu HTTP
POST https://geocode.googleapis.com/v4alpha/geocode/destinations
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{ "travelModes": [ enum ( |
| Trường | |
|---|---|
travelModes[] |
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 |
languageCode |
Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về. |
regionCode |
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. |
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. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: |
|
place |
Tên tài nguyên của một địa điểm, ở định dạng |
addressQuery |
Địa chỉ đường phố. |
locationQuery |
Vị trí chính xác. |
| Kết thúc các trường loại trừ lẫn nhau. | |
Nội dung phản hồi
Thông báo phản hồi cho DestinationService.SearchDestinations.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{
"destinations": [
{
object ( |
| Trường | |
|---|---|
destinations[] |
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. |
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-platformhttps://www.googleapis.com/auth/maps-platform.geocodehttps://www.googleapis.com/auth/maps-platform.destinations
SearchDestinationsRequest.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.
| Biểu diễn dưới dạng JSON |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"address": {
object ( |
| Trường | |
|---|---|
| Cụm từ tìm kiếm địa chỉ. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: | |
address |
Địa chỉ đường phố theo định dạng địa chỉ bưu chính. |
addressQuery |
Địa chỉ đường phố được định dạng dưới dạng một dòng. |
| Kết thúc các trường loại trừ lẫn nhau. | |
SearchDestinationsRequest.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 containingPlaces sẽ bao gồm toà nhà.
| Biểu diễn dưới dạng JSON |
|---|
{ "placeFilter": { object ( |
| Trường | |
|---|---|
placeFilter |
Không bắt buộc. Bộ lọc để áp dụng cho các ứng viên đích. |
| Cụm từ tìm kiếm về vị trí. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: | |
location |
Vị trí chính xác theo vĩ độ và kinh độ. |
| Kết thúc các trường loại trừ lẫn nhau. | |
SearchDestinationsRequest.LocationQuery.PlaceFilter
Bộ lọc để áp dụng cho các ứng viên đích.
| Biểu diễn dưới dạng JSON |
|---|
{ "structureType": enum ( |
| Trường | |
|---|---|
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 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 |
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. |
PlaceView.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. |
SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
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. |
Đí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.
| Biểu diễn dưới dạng JSON |
|---|
{ "primary": { object ( |
| Trường | |
|---|---|
primary |
Địa điểm chính được xác định bằng |
containingPlaces[] |
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. |
subDestinations[] |
Đ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[] |
Đị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[] |
Lối vào cho điểm đến này. |
navigationPoints[] |
Điểm điều hướng cho đích đến này. |
parkingOptions |
Các lựa chọn đỗ xe cho điểm đến này. |
arrivalSummary |
Bản tóm tắt do AI tạo về trải nghiệm khi đến điểm đến. |
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à displayName.
| Biểu diễn dưới dạng JSON |
|---|
{ "place": string, "placeId": string, "displayName": { object ( |
| Trường | |
|---|---|
place |
Tên tài nguyên của Địa điểm này, ở định dạng |
placeId |
Giá trị nhận dạng riêng biệt của một địa điểm. |
displayName |
Nội dung mô tả địa điểm mà con người có thể đọc được. Ví dụ: "Cổng B", "McDonalds" |
primaryType |
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 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ó. |
formattedAddress |
Địa chỉ một dòng. |
postalAddress |
Địa chỉ có cấu trúc. |
structureType |
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 điểm phù hợp để đặt điểm đánh dấu trên bản đồ. |
displayPolygon |
Đườ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 |
addressComponents[] |
Các thành phần lặp lại cho từng cấp địa phương. |
PlaceView.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.
| Biểu diễn dưới dạng JSON |
|---|
{ "longText": string, "shortText": string, "types": [ string ], "languageCode": string } |
| Trường | |
|---|---|
longText |
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". |
shortText |
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[] |
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 |
languageCode |
Ngôn ngữ dùng để định dạng thành phần này, theo ký hiệu CLDR. |
Đị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.
| Biểu diễn dưới dạng JSON |
|---|
{ "relationalDescription": { object ( |
| Trường | |
|---|---|
relationalDescription |
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[] |
Thẻ mô tả cách sử dụng địa danh trong bối cảnh của điểm đến. |
straightLineDistanceMeters |
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). |
travelDistanceMeters |
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). |
| Địa danh. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: | |
place |
Địa điểm đại diện cho địa danh này. |
| Kết thúc các trường loại trừ lẫn nhau. | |
Landmark.Tag
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. |
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.
| Biểu diễn dưới dạng JSON |
|---|
{ "displayName": { object ( |
| Trường | |
|---|---|
displayName |
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 |
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 thực sự nằm trên đó, ở định dạng |
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. |
streetViewAnnotation |
Chú thích về lối vào trên |
Entrance.Tag
Đặ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 Lưu ý: lối và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.
| Biểu diễn dưới dạng JSON |
|---|
{ "pano": string, "widthPx": integer, "heightPx": integer, "headingDegree": number, "pitchDegree": number, "fovDegree": number } |
| Trường | |
|---|---|
pano |
Mã nhận dạng ảnh toàn cảnh cụ thể. |
widthPx |
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. |
heightPx |
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. |
headingDegree |
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. |
pitchDegree |
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. |
fovDegree |
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. |
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.
| Biểu diễn dưới dạng JSON |
|---|
{
"coordinates": [
{
object ( |
| Trường | |
|---|---|
coordinates[] |
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ồ. |
ImageAnnotation.Coordinate
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.
| Biểu diễn dưới dạng JSON |
|---|
{ "xPx": number, "yPx": number } |
| Trường | |
|---|---|
xPx |
Toạ độ X. |
yPx |
Toạ độ Y. |
Destination.ParkingOptions
Thông tin về các lựa chọn đỗ xe tại điểm đến.
| Biểu diễn dưới dạng JSON |
|---|
{ "availability": enum ( |
| Trường | |
|---|---|
availability |
Tình trạng chỗ đỗ xe tại điểm đến này. |
parkingFacilities[] |
Bãi đỗ xe của điểm đến này. |
onsiteParking |
Điểm đến có bãi đỗ xe tại chỗ. |
freeParkingLot |
Có bãi đỗ xe miễn phí. |
paidParkingLot |
Có bãi đỗ xe có tính phí. |
freeStreetParking |
Có chỗ đỗ xe miễn phí trên đường. |
paidStreetParking |
Có chỗ đỗ xe trên đường có tính phí. |
valetParking |
Có dịch vụ đỗ xe. |
freeGarageParking |
Có gara đỗ xe miễn phí. |
paidGarageParking |
Có gara đỗ xe có tính phí. |
Destination.ParkingOptions.Availability
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. |
Destination.ParkingOptions.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ó.
| Biểu diễn dưới dạng JSON |
|---|
{
"place": {
object ( |
| Trường | |
|---|---|
place |
Thông tin đại diện cho địa điểm của bãi đỗ xe cụ thể này. |
onsite |
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 |
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. |
straightLineDistanceMeters |
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. |
Destination.ArrivalSummary
Bản tóm tắt do AI tạo về trải nghiệm khi đến điểm đến.
| Biểu diễn dưới dạng JSON |
|---|
{ "text": { object ( |
| Trường | |
|---|---|
text |
Tóm tắt về trải nghiệm khi đến điểm đến. |
flagContentUrl |
Đườ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. |
disclosureText |
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. |