Giới thiệu
Places API hỗ trợ Ảnh địa điểm (Cũ). Nếu bạn đã quen thuộc với Place Photos (Cũ), thì Place Photos (Mới) sẽ có những thay đổi sau:
- Ả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 cả 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 đối với thông tin tham chiếu ảnh.
- Ả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 tham 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 tham 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
Ảnh địa điểm (Cũ) hỗ trợ kích thước ảnh tối đa là 1600 x 1600 pixel. Ảnh địa điểm (Mới) hỗ trợ kích thước lên đến 4800 x 4800 pixel.
Thay đổi thành ảnh tham khảo
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à mã tham chiếu ảnh, ở dạng:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Nearby Search (Mới),
Tìm kiếm văn bản (Mới) và
Chi tiết đị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 thông tin 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 cũ, bạn chỉ cần truyền mã tham chiếu ảnh, ở dạng:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Find Place (Cũ), Nearby Search (Cũ), Tìm kiếm văn bản (Cũ) và Place Details (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– 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 thông tin ghi công bắt buộc. Trường này luôn xuất hiện nhưng có thể trống.