Places API hỗ trợ API địa điểm Ảnh địa điểm. 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 thực hiện các thay đổi sau:
- Dịch vụ Hình ả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 yêu cầu của bạn, thay vì chỉ tham chiếu ảnh. Để biết thêm thông tin, hãy xem Chuyển sang tham chiếu hình ảnh.
- Dịch vụ Ảnh địa điểm mới hỗ trợ cả Khoá API và OAuth làm cơ chế xác thực.
Bảng sau đây liệt kê các tham số trong thành phần Ảnh địa điểm đã đượ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ợ.
| 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ợ tối đa ảnh kích thước 1600 x 1600 pixel. Hình ảnh địa điểm (Mới) hỗ trợ kích thước lên đến 4800 x 4800 pixel.
Thay đổi đối với ảnh tham chiếu
Gói thuê bao mới Ảnh địa điểm API yêu cầu bạn chuyển tên tài nguyên của ảnh được yêu cầu. Ảnh này bao gồm mã địa điểm và tài liệu tham khảo ảnh, trong biểu mẫu:
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ột
phần tử của photos[] trong phản hồi mới có 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. Chiến dịch này trường luôn hiển thị 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
Công cụ Tìm địa điểm hiện có,
Tìm kiếm lân cận, Tìm kiếm văn bản và
Tất cả Thông tin chi tiết về đị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ử photo trong thành phần hiện có
phản hồi chứa các trường sau:
photo_reference– Chuỗi dùng để nhận dạng ảnh khi bạn thực hiện Yêu cầu về ả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. Chiến dịch này trường luôn hiển thị nhưng có thể trống.