Trang này được dịch bởi Cloud Translation API.

Hình ảnh địa điểm (Mới)

Chọn nền tảng: Android iOS Dịch vụ web

Dịch vụ Place Photo (New) (Ảnh địa điểm) là một API chỉ có thể đọc cho phép bạn thêm nội dung ảnh chất lượng cao vào ứng dụng của mình. Dịch vụ Ảnh địa điểm cung cấp cho bạn quyề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 nhận thông tin địa điểm bằng cách sử dụng 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 tài nguyên ảnh cho nội dung ảnh có liên quan. Bằng cách sử dụng dịch vụ Ảnh, bạn có thể truy cập vào các ảnh được tham chiếu và đổi kích thước hình ảnh thành kích thước tối ưu cho ứng dụng của mình.

API Explorer cho phép bạn đưa ra các yêu cầu trực tiếp để làm quen với API và các 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 có dạng:

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ừ yêu cầu Thông tin 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) trong thuộc tính name của mỗi phần tử thuộc 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 các giá trị đã chỉ định, thì hệ thống sẽ trả về hình ảnh gốc. Nếu hình ảnh lớn hơn ở một trong hai kích thước, thì hình ảnh sẽ được điều chỉnh theo tỷ lệ để khớp với kích thước nhỏ hơn trong hai kích thước, bị giới hạn theo tỷ lệ khung hình ban đầu. 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 hình ảnh sẽ không đạt yêu cầu. 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ụ Địa điểm ảnh phải bao gồm tên tài nguyên ảnh, được trả về trong phản hồi cho yêu cầu Tìm kiếm lân cận, Tìm kiếm văn bản hoặc 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 địa điểm đó có nội dung ảnh liên quan.

Lưu ý: Để đưa mảng photos[] vào phản hồi, hãy nhớ đưa photos (Thông tin chi tiết về địa điểm) hoặc places.photos (Tìm kiếm lân cận và Tìm kiếm văn bản) vào mặt nạ trường của yêu cầu. Mỗi API có thể trả về tối đa 10 ảnh cho một vị trí của một địa điểm.

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. Trường này luôn hiện diện 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 cả ảnh do chủ doanh nghiệp và ảnh do người dùng đóng góp. Trong hầu hết trường hợp, những bức ảnh này có thể được sử dụng mà không cần ghi nguồn đóng góp hoặc sẽ có thuộc tính bắt buộc được đưa vào dưới dạng một phần của hình ảnh. Tuy nhiên, nếu phần tử photo được trả về có chứa một giá trị trong trường authorAttributions, thì bạn phải đưa thuộc tính bổ sung đó vào ứng dụng của mình ở bất cứ nơi nào hiển thị hình ảnh.

Ví dụ sau đây cho thấy một yêu cầu Thông tin chi tiết về địa điểm đưa photos vào mặt nạ trường để phản hồi có 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/ChIJ2fzCmcW7j4AR2JzfXBBoh6E

Dướ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 sao cho 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 mức hiện có, máy chủ sẽ trả về trạng thái HTTP 403 và hiển thị hình ảnh bên dưới để cho biết rằng bạn đã vượt quá hạn mức:

Nếu không thể hiểu yêu cầu của bạn, máy chủ sẽ trả về trạng thái HTTP 400 (tức là trạng thái này cho biết yêu cầu không hợp lệ). Sau đây là những lý do phổ biến nhất dẫn đến yêu cầu không hợp lệ:

Bạn đã gửi không đúng tên ảnh.
Yêu cầu không bao gồm maxHeightPx hoặc thông số maxWidthPx.
Giá trị của maxHeightPx hoặc tham số maxWidthtPx đã được đặt thành null.
name đã hết hạn. Nếu name hết hạn, hãy yêu cầu Chi tiết đị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 name mới.

Hãy dùng thử!

API Explorer cho phép bạn đưa ra các yêu cầu mẫu để 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
```
Lưu ý: Hãy đảm bảo bạn đang sử dụng name trong một yêu cầu Chi tiết địa điểm gần đây vì name có thể hết hạn.
Thiết lập skipHttpRedirect thành true để yêu cầu trả về phản hồi JSON. Theo mặc định, yêu cầu này trả về hình ảnh mà Trình khám phá API không thể hiển thị.
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 dùng để tạo 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.