API Địa điểm chấp nhận các yêu cầu về dữ liệu địa điểm thông qua nhiều phương thức. Phản hồi của API Địa điểm chứa dữ liệu về một địa điểm, bao gồm cả dữ liệu vị trí và hình ảnh, vị trí địa lý và các điểm yêu thích nổi bật.
Với bản phát hành này, nội dung phản hồi từ tính năng Tìm kiếm bằng văn bản, Tìm kiếm lân cận và Thông tin chi tiết về địa điểm cũng có thể chứa đường liên kết đến Google Maps. Người dùng có thể truy cập vào các đường liên kết đến Google Maps này để xem thêm thông tin về một địa điểm trong nội dung phản hồi.
Ví dụ: bạn tìm kiếm sân bay ở San Francisco, California. Sau đó, phản hồi sẽ bao gồm Sân bay quốc tế San Francisco (SFO) trong danh sách địa điểm.
Với bản phát hành này, đối tượng Place cho SFO trong phản hồi sẽ thêm trường googleMapsUri chứa các đường liên kết đến Google Maps để mở Google Maps đến địa điểm, đường đi đến địa điểm, bài đánh giá về địa điểm và ảnh địa điểm.
Cùng với các đường liên kết được thêm vào đối tượng Place, bản phát hành này cũng thêm trường googleMapsUri vào các đối tượng Reviews và Photos trong phản hồi:
Reviews.googleMapsUri: Chứa đường liên kết đến bài đánh giá trên Google Maps để bạn có thể xem bài đánh giá đó trong trình duyệt.Photos.googleMapsUri: Chứa đường liên kết đến ảnh trên Google Maps để bạn có thể xem ảnh đó trong trình duyệt.
Trình khám phá API cho phép bạn gửi yêu cầu trực tiếp để làm quen với các tuỳ chọn mới này:
Đường liên kết đến Google Maps được hỗ trợ cho một địa điểm
Bảng sau đây cho thấy các đường liên kết đến Google Maps mà bạn có thể đưa vào phản hồi:
| Đường liên kết đến Google Maps | Mô tả | Tên trường |
|---|---|---|
| Địa điểm | Đường liên kết để mở Google Maps đến địa điểm đó. | googleMapsLinks.placeUri |
| Cách tìm | Đường liên kết để mở thông tin đường đi đến địa điểm đó trong Google Maps. | googleMapsLinks.directionsUri |
| Viết bài đánh giá | Đường liên kết đến trang viết bài đánh giá về địa điểm đó trên Google Maps. | googleMapsLinks.writeAReviewUri |
| Đọc bài đánh giá | Đường liên kết đến các bài đánh giá về địa điểm đó trên Google Maps. | googleMapsLinks.reviewsUri |
| Ảnh | Đường liên kết để hiển thị ảnh của địa điểm trong Google Maps. | googleMapsLinks.photosUri |
Giá
Tính năng này đang ở giai đoạn Xem trước trước khi phát hành công khai và không tính phí, nghĩa là bạn sẽ không phải trả phí khi sử dụng trong giai đoạn Xem trước. Để biết thông tin chi tiết về mức giá đề xuất, hãy xem bài viết Hoạt động sử dụng và tính phí API Địa điểm.
Bao gồm tất cả đường liên kết trong phản hồi của Places
Các đường liên kết trong phản hồi về địa điểm nằm trong trường googleMapsLinks. Hãy nhớ đưa trường googleMapsLinks vào mặt nạ trường của yêu cầu nếu bạn muốn các trường này xuất hiện trong phản hồi.
Ví dụ: nội dung Tìm kiếm bằng văn bản sau đây bao gồm tất cả đường liên kết đến Maps trong nội dung phản hồi:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'
Phản hồi có dạng:
{
"places": [
{
"formattedAddress": "San Francisco, CA 94128, USA",
"displayName": {
"text": "San Francisco International Airport",
"languageCode": "en"
},
"googleMapsLinks": {
"placeUri": "https://maps.google.com/?cid=11885663895765773631",
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
}
}
]
}
Thêm một đường liên kết cụ thể vào nội dung phản hồi
Bạn không cần phải trả về tất cả đường liên kết trong phản hồi. Ví dụ: nếu bạn chỉ muốn đường liên kết đến ảnh trong phản hồi, hãy sửa đổi mặt nạ trường như minh hoạ bên dưới để chỉ bao gồm trường photosUri:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'
Thêm thông tin đường đi trong câu trả lời
Tất cả phương thức của Places đều hỗ trợ việc tạo đường liên kết đến chỉ đường trong phản hồi. Vị trí hiện tại được dùng làm điểm xuất phát, vị trí của địa điểm được dùng làm đích đến và phương thức di chuyển là lái xe.
Ví dụ tiếp theo sử dụng tính năng Tìm kiếm lân cận để đưa đường liên kết đến thông tin chỉ đường trên bản đồ vào phản hồi trong trường directionsUri:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": -33.8688,
"longitude": 151.1957362},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby
Đưa vào bài đánh giá và đường liên kết đến ảnh
Bản phát hành này thêm trường googleMapsUri vào đối tượng Reviews và Photos trong phản hồi. Khi bạn truy cập vào các đường liên kết này, bài đánh giá hoặc ảnh sẽ mở ra trong Google Maps.
Ví dụ: nội dung Tìm kiếm bằng văn bản sau đây bao gồm bài đánh giá và ảnh của từng địa điểm trong nội dung phản hồi:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'
Trong phản hồi, mỗi phần tử của mảng bài đánh giá và ảnh chứa trường googleMapsUri để mở bài đánh giá hoặc ảnh trong trình duyệt.
Hãy dùng thử!
Trình khám phá API cho phép bạn tạo các yêu cầu mẫu để làm quen với API và các tuỳ chọn API.
Chọn biểu tượng API,
, ở bên phải trang.Bạn có thể mở rộng phần Hiện các tham số chuẩn và đặt tham số
fieldsthành mặt nạ trường.Chỉnh sửa Phần nội dung yêu cầu (không bắt buộc).
Chọn nút Thực thi. Trong hộp thoại, hãy chọn tài khoản mà bạn muốn sử dụng để gửi yêu cầu.
Trong bảng điều khiển API Explorer (Trình khám phá API), hãy chọn biểu tượng mở rộng
để mở rộng cửa sổ API Explorer.