Liên kết với Google Maps

Places API (Mới) 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 Places API (Mới) chứa dữ liệu về một địa điểm, bao gồm dữ liệu vị trí và hình ảnh, vị trí địa lý và các điểm nổi bật thu hút sự chú ý.

Phản hồi từ Tìm kiếm văn bản (Mới), Nearby Search (Mới) và Place Details (Mới) cũng có thể chứa các đường liên kết đến Google Maps. Người dùng có thể duyệt đến các đường liên kết này trên Google Maps để xem thêm thông tin về một địa điểm trong phản hồi.

Ví dụ: bạn tìm kiếm các 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. Đố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 về địa điểm.

Cùng với các đường liên kết được thêm vào đối tượng Place, trường googleMapsUri cũng được thêm 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 Google Maps của bài đánh giá để bạn có thể xem bài đánh giá đó trong trình duyệt.

  • Photos.googleMapsUri: Chứa một đường liên kết đến Google Maps của ảnh để bạn có thể xem ảnh đó trong trình duyệt.

API Explorer cho phép bạn đưa ra các yêu cầu trực tiếp để làm quen với những lựa chọn mới này:

Hãy làm thử!

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
Đường đi Đường liên kết để mở đường đi đến địa điểm trong Google Maps. googleMapsLinks.directionsUri
Viết bài đánh giá Đường liên kết để viết bài đánh giá về địa điểm trong Google Maps. googleMapsLinks.writeAReviewUri
Đọc bài đánh giá Đường liên kết để hiển thị 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 về địa điểm trong Google Maps. googleMapsLinks.photosUri

Các đường liên kết trong phản hồi của Places được chứa 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 đường liên kết này xuất hiện trong phản hồi.

Ví dụ: Tìm kiếm văn bản (Mới) sau đây bao gồm tất cả các đường liên kết đến Google Maps trong 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"
      }
    }
  ]
}

Bạn không cần phải trả về tất cả cá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ỉ đưa trường photosUri vào:

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'

Đưa đường đi vào phản hồi

Tất cả các phương thức của Places đều hỗ trợ việc tạo đường liên kết đến đường đi 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 điểm đến và phương tiện đi lại là lái xe.

Ví dụ tiếp theo sử dụng Nearby Search (Mới) để đưa đường liên kết đến đường đi trên Maps 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

Bản phát hành này thêm trường googleMapsUri vào các đối tượng Reviews và Photos trong phản hồi. Khi duyệt đến các đường liên kết này, bài đánh giá hoặc ảnh sẽ mở ra trong Google Maps.

Ví dụ: Tìm kiếm văn bản (Mới) sau đây bao gồm các bài đánh giá và ảnh cho từng địa điểm trong 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 làm thử!

API Explorer cho phép bạn đưa ra các yêu cầu mẫu để làm quen với API và các lựa chọn API.

  1. Chọn biểu tượng API ở bên phải trang.

  2. Bạn có thể tùy chọn mở rộng Hiển thị các tham số tiêu chuẩn và đặt tham số fields thành mặt nạ trường.

  3. Bạn có thể chỉnh sửa Nội dung yêu cầu.

  4. 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 để đưa ra yêu cầu.

  5. Trong bảng điều khiển API Explorer, hãy chọn

    Toàn màn hình để mở rộng cửa sổ API Explorer.