API Địa điểm hỗ trợ Ảnh địa điểm hiện có. Nếu bạn đã quen thuộc với Ảnh địa điểm hiện tại, thì phiên bản mới của Ảnh địa điểm sẽ có những thay đổi sau:
- Dịch vụ Ả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 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 Ả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ợ.
| 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 hiện tại 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 tệp đối chiếu ảnh
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 nội dung 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 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. Trường này luôn xuất hiện nhưng có thể để trống.