Places API hỗ trợ Place Photo (Ảnh địa điểm) hiện có. Nếu bạn đã quen với Ảnh địa điểm hiện có, phiên bản mới của Ảnh địa điểm sẽ thực hiện các thay đổi sau:
- Dịch vụ Ảnh địa điểm mới yêu cầu bạn chuyển tên tài nguyên của ảnh, bao gồm mã địa điểm vào URL yêu cầu, thay vì chỉ cung cấp thông tin tham khảo về ảnh. Để biết thêm thông tin, hãy xem phần Chuyển sang tệp tham chiếu ảnh.
- Dịch vụ Ả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 hiện 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ợ.
| Thông 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. |
Kích thước ảnh tăng lên
Ảnh địa điểm hiện có hỗ trợ kích thước ảnh tối đa là 1600 x 1600 pixel. Place Photo (Mới) hỗ trợ kích thước lên tới 4800 x 4800 pixel.
Thay đổi đối với ảnh tham chiếu
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à tài liệu tham khảo ảnh, ở dạng:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Các phiên bản mới của tính năng Tìm kiếm lân cận, Tìm kiếm văn bản và Chi tiết địa điểm đề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 thuộc tính bắt buộc. Trường này luôn hiện diện nhưng có thể trống.
Với API hiện có, bạn chỉ phải chuyển tệp tham chiếu ảnh, trong biểu mẫu:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Tất cả tính năng Tìm địa điểm, Tìm kiếm lân cận, Tìm kiếm bằng văn bản và Thông tin chi tiết về địa điểm hiện 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 hiện 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 thuộc tính bắt buộc. Trường này luôn hiện diện nhưng có thể trống.