Places API hỗ trợ Place Photo hiện có. Nếu bạn đã quen thuộc 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 những 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, trong đó 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 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ố đã được đổi tên hoặc sửa đổi cho Ảnh địa điểm hiện có trong ả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
Ảnh địa điểm hiện 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 tối đa 4800 x 4800 pixel.
Thay đổi thành tham chiếu hình ảnh
API Địa điểm hình ảnh mới yêu cầu bạn chuyển tên tài nguyên của ảnh được yêu cầu, bao gồm mã địa điểm và tham chiếu ảnh dưới 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ì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 xuất hiệ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 ở dạng:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
Tính năng Tìm địa điểm, Tìm kiếm lân cận, Tìm kiếm 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 một 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 xuất hiện nhưng có thể trống.