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

Ả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.

Lưu ý: Để đưa mảng photos[] vào trong hãy đảm bảo bao gồm photos (Chi tiết địa điểm) hoặc places.photos (Tìm kiếm lân cận và Tìm kiếm văn bản) trong mặt nạ trường của yêu cầu. Một 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. 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/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 để 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á:

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ặc maxWidthPx .
Đã đặt giá trị của maxHeightPx hoặc thông số maxWidthtPx đến null.
name đã hết hạn. Nếu name 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ột name 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
```
Lưu ý: Đảm bảo bạn đang sử dụng name 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ề 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.