API Địa điểm hỗ trợ Ả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 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 phần Thay đổi thành 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 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ợ.
| 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. |
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
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
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 bằng văn bản và 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ử 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ỉ 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
Cá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 nội dung ghi công bắt buộc. Chiến dịch này trường luôn hiển thị nhưng có thể trống.