Di chuyển đến ảnh địa điểm (Mới)

Places API hỗ trợ Ảnh địa điểm (Cũ). Nếu bạn đã quen với tính năng Ảnh địa điểm (cũ), thì Ảnh địa điểm (mới) sẽ có những thay đổi sau:

  • Tính năng Ảnh địa điểm (Mới) yêu cầu bạn truyền tên tài nguyên của ảnh, bao gồm mã địa điểm trong URL yêu cầu, thay vì chỉ tham chiếu ảnh. Để biết thêm thông tin, hãy xem phần Thay đổi thành tệp tham chiếu ảnh.
  • Tính năng Ảnh địa điểm (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.

Bảng sau đây liệt kê các thông số trong Ảnh địa điểm (Cũ) đã được đổi tên hoặc sửa đổi cho Ảnh địa điểm (Mới) hoặc các thông số không còn được hỗ trợ.

Tham số hiện tại Thông số mới Ghi chú
maxheight maxHeightPx Bạn phải chỉ định maxHeightPx, maxWidthPx hoặc cả hai.
maxwidth maxWidthPx Bạn phải chỉ định maxHeightPx, maxWidthPx hoặc cả hai.

Tăng kích thước ảnh

Tính năng Ảnh tại địa điểm (phiên bản cũ) hỗ trợ kích thước ảnh tối đa là 1600x1600 pixel. Ảnh địa điểm (Mới) hỗ trợ kích thước lên đến 4800 x 4800 pixel.

Thay đổi thành tệp đối chiếu ảnh

API Ảnh địa điểm (Mới) yêu cầu bạn truyền tên tài nguyên của ảnh được yêu cầu, bao gồm mã địa điểm và thông tin tham chiếu ảnh, ở dạng:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

Tìm kiếm lân cận (Mới), Tìm kiếm bằng văn bản (Mới) và Thông tin chi tiết về địa điểm (Mới) đều trả về một mảng photos[] trong phản hồi hỗ trợ định dạng này. Mỗi phần tử của photos[] trong phản hồi mới chứa các trường sau:

  • name – Một chuỗi chứa tên tài nguyên của ảnh. Chuỗi này có dạng:

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx – Chiều cao tối đa của hình ảnh, tính bằng pixel.
  • widthPx – Chiều rộng tối đa của hình ảnh, tính bằng pixel.
  • authorAttributions[] – Mọi nội dung ghi công bắt buộc. Trường này luôn xuất hiện nhưng có thể để trống.

Với API hiện có, bạn chỉ cần truyền thông tin tham chiếu ảnh ở dạng:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Tìm địa điểm (Cũ), Tìm kiếm lân cận (Cũ), Tìm kiếm bằng văn bản (Cũ) và Chi tiết địa điểm (Cũ) đều trả về một mảng photos[] trong phản hồi hỗ trợ định dạng này. Mỗi phần tử photo trong phản hồi cũ chứa các trường sau:

  • photo_reference – Một chuỗi dùng để xác định ảnh khi bạn thực hiện yêu cầu Ảnh.
  • height – Chiều cao tối đa của hình ảnh.
  • width – Chiều rộng tối đa của hình ảnh.
  • html_attributions[] – Mọi nội dung ghi công bắt buộc. Trường này luôn xuất hiện nhưng có thể để trống.