Ảnh địa điểm (Mới) Service là API chỉ đọc cho phép bạn thêm nội dung hình ảnh vào ứng dụng của mình. Dịch vụ Hình ảnh địa điểm cung cấp bạn truy cập vào hàng triệu ảnh được lưu trữ trong cơ sở dữ liệu Địa điểm.
Khi bạn nhận được thông tin địa điểm qua yêu cầu Chi tiết địa điểm, Tìm kiếm lân cận hoặc Tìm kiếm bằng văn bản, bạn cũng có thể yêu cầu cung cấp tài nguyên hình ảnh về nội dung hình ảnh có liên quan. Khi sử dụng dịch vụ Ảnh, bạn có thể truy cập ảnh được tham chiếu và thay đổi kích thước hình ảnh thành kích thước tối ưu cho .
API Explorer cho phép bạn đưa ra các yêu cầu trực tiếp để bạn có thể làm quen với API và Tuỳ chọn API:
Hãy làm thử!Yêu cầu về ảnh về địa điểm
Yêu cầu về Ảnh địa điểm là một yêu cầu HTTP GET tới một URL trong biểu mẫu:https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
Trường hợp các tham số sau được yêu cầu:
- NAME chứa tên tài nguyên của ảnh.
- API_KEY chứa khoá API.
- PARAMETERS chứa tham số
maxHeightPx
, tham sốmaxWidthPx
hoặc cả hai.
Dưới đây là danh sách đầy đủ các tham số bắt buộc và không bắt buộc.
Thông số bắt buộc
Tên ảnh
Giá trị nhận dạng dạng chuỗi giúp nhận dạng duy nhất một ảnh. Tên ảnh được trả về từ
Thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới),
hoặc yêu cầu Tìm kiếm văn bản (Mới)
trong thuộc tính name
của mỗi phần tử trong mảng photos[]
.
Ví dụ: xem phần Mua tên ảnh.
maxHeightPx và maxWidthPx
Chỉ định chiều cao và chiều rộng tối đa mong muốn của hình ảnh (tính bằng pixel). Nếu hình ảnh nhỏ hơn so với giá trị được chỉ định, thì hệ thống sẽ trả về hình ảnh ban đầu. Nếu hình ảnh lớn hơn ở một trong hai thì kích thước sẽ được điều chỉnh theo tỷ lệ để khớp với kích thước nhỏ hơn trong hai chiều, được giới hạn ở kích thước gốc tỷ lệ khung hình. Cả hai thuộc tính maxheight và maxwidth đều chấp nhận số nguyên từ 1 đến 4800.
Bạn phải chỉ định maxHeightPx
hoặc maxWidthPx
hoặc cả hai.
Thông số tùy chọn
skipHttpRedirect
Nếu là false
(mặc định), hãy chuyển hướng HTTP đến hình ảnh để trả về hình ảnh.
Nếu là true
, hãy bỏ qua lệnh chuyển hướng và trả về phản hồi JSON chứa thông tin chi tiết về hình ảnh.
Ví dụ:
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
Tuỳ chọn này bị bỏ qua đối với các yêu cầu không phải HTTP.
Đặt tên cho ảnh
Tất cả các yêu cầu đối với dịch vụ Ảnh về địa điểm phải bao gồm
tên tài nguyên ảnh, được trả về trong phản hồi cho Tìm kiếm lân cận, Tìm kiếm văn bản hoặc
Yêu cầu Chi tiết địa điểm. Phản hồi cho các yêu cầu này chứa một mảng photos[]
nếu
có nội dung hình ảnh có liên quan.
Mỗi phần tử của photo[]
chứa các trường sau:
name
— Một chuỗi chứa tên tài nguyên của ảnh khi bạn thực hiện Yêu cầu về ảnh. Chuỗi này có dạng:places/PLACE_ID/photos/PHOTO_RESOURCE
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.
Ảnh mà dịch vụ Ảnh trả về được lấy từ nhiều địa điểm,
bao gồm ảnh do chủ doanh nghiệp và người dùng đóng góp. Trong hầu hết các trường hợp, đây
ảnh có thể được sử dụng mà không cần ghi nguồn hoặc sẽ có thuộc tính bắt buộc
được thêm vào như một phần của hình ảnh. Tuy nhiên, nếu phần tử photo
được trả về
có chứa giá trị vào trường authorAttributions
, bạn phải thêm
thuộc tính bổ sung trong ứng dụng của bạn ở bất cứ nơi nào bạn hiển thị hình ảnh.
Ví dụ sau đây cho thấy một yêu cầu về Chi tiết địa điểm bao gồm photos
trong
mặt nạ trường để phản hồi bao gồm mảng photos[]
trong phản hồi:
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6EDưới đây là ví dụ về một mảng
photos[]
trong phản hồi.
... "photos" : [ { "name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1", "widthPx": 6000, "heightPx": 4000, "authorAttributions": [ { "displayName": "John Smith", "uri": "//maps.google.com/maps/contrib/101563", "photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" } ] }, ...
Yêu cầu hình ảnh địa điểm
Yêu cầu mẫu bên dưới trả về một hình ảnh bằng cách sử dụng tài nguyên name
, đổi kích thước hình ảnh để
chiều cao và chiều rộng tối đa là 400 pixel:
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
Phản hồi của một yêu cầu Ảnh địa điểm thành công là một hình ảnh. Loại hình ảnh phụ thuộc vào loại ảnh mà bạn gửi ban đầu.
Nếu yêu cầu của bạn vượt quá hạn ngạch có sẵn, máy chủ sẽ trả về một Trạng thái HTTP 403 và hiển thị hình ảnh bên dưới để cho biết hạn mức đã đã bị vượt quá:
![Hình ảnh vượt quá hạn mức](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/quota.png?authuser=7&hl=vi)
Nếu máy chủ không thể hiểu yêu cầu của bạn, thì máy chủ sẽ trả về HTTP 400 trạng thái, cho biết yêu cầu không hợp lệ. Những lý do phổ biến nhất dẫn đến lỗi yêu cầu không hợp lệ bao gồm:
- Bạn đã gửi không đúng tên ảnh.
- Yêu cầu không bao gồm
maxHeightPx
hoặcmaxWidthPx
. - Đã đặt giá trị của
maxHeightPx
hoặc thông sốmaxWidthtPx
đếnnull
. name
đã hết hạn. Nếuname
hết hạn, hãy thực hiện yêu cầu Chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới), hoặc Tìm kiếm văn bản (Mới) để nhận mộtname
mới.
Hãy dùng thử!
API Explorer cho phép bạn thực hiện các yêu cầu mẫu để mà bạn có thể làm quen với API và các tuỳ chọn API.
Cách gửi yêu cầu:
- Chọn biểu tượng API,
ở bên phải của trang.
- Đặt tham số
name
thành:places/PLACE_ID/photos/PHOTO_RESOURCE/media
- Thiết lập
skipHttpRedirect
thànhtrue
để yêu cầu trả về JSON của bạn. Theo mặc định, yêu cầu trả về hình ảnh mà không thể hiển thị bằng Trình khám phá API. - Chọn nút Thực thi. Trong cửa sổ bật lên, hãy chọn tài khoản mà bạn muốn sử dụng để đưa ra yêu cầu.
Trong bảng điều khiển API Explorer, hãy chọn biểu tượng mở rộng
, để mở rộng cửa sổ API Explorer.