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ụ Ảnh địa điểm (Mới) 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. 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. Khi 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.

Trình khám phá API cho phép bạn tạo 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ử!

Lưu ý: Nhập địa điểm name từ mảng photos của nội dung phản hồi Thông tin chi tiết về địa điểm (Mới) rồi nhấp vào "Thực thi". Để xem ảnh, hãy sử dụng giá trị photoUri trong phần nội dung phản hồi của ảnh Địa điểm (Mới).

Yêu cầu về ảnh về địa điểm

Yêu cầu Ảnh địa điểm là một yêu cầu HTTP GET đến một URL ở dạng:

https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS

Trong đó, các tham số sau đây là bắt buộc:

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.

Danh sách đầy đủ các tham số bắt buộc và không bắt buộc được mô tả dưới đây.

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 bằng văn bản (Mới) trong thuộc tính name của mỗi phần tử trong mảng photos[].

Để biết ví dụ, hãy xem phần Lấy 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ị được chỉ định, hình ảnh gốc sẽ được trả về. Nếu lớn hơn ở một trong hai kích thước, hình ảnh sẽ được điều chỉnh theo tỷ lệ cho phù hợp với kích thước nhỏ hơn trong hai kích thước, bị giới hạn ở tỷ lệ khung hình ban đầu. Cả 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, maxWidthPx hoặc cả hai.

Thông số tùy chọn

skipHttpRedirect

Nếu false (mặc định), hãy tạo lệnh 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.

Lấy tên ảnh

Tất cả yêu cầu gửi đến dịch vụ Ảnh địa điểm 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 bằng văn bản hoặc Thông tin chi tiết về đị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 vị trí 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í đị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 Ả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 xuất hiện nhưng có thể để trống.

Ảnh do dịch vụ Photos trả về được lấy từ nhiều nguồn, bao gồm cả ảnh do chủ doanh nghiệp và người dùng đóng góp. Trong hầu hết trường hợp, bạn có thể sử dụng những bức ảnh này mà không cần ghi công hoặc sẽ có phần ghi công bắt buộc trong hình ảnh. Tuy nhiên, nếu phần tử photo được trả về chứa một giá trị trong trường authorAttributions, thì bạn phải thêm thông tin ghi công vào ứng dụng của mình bất cứ khi nào hiển thị hình ảnh.

Ví dụ sau đây cho thấy một yêu cầu về 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 chụp ả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 đã chỉ định tên ảnh không chính xác.
Yêu cầu không bao gồm thông số maxHeightPx hoặc 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 gửi yêu cầu đến 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 bằng văn bản (Mới) để lấy name mới.

Hãy dùng thử!

Trình khám phá API cho phép bạn tạo các yêu cầu mẫu để 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 ý: Hãy đảm bảo bạn đang sử dụng name từ một yêu cầu Thông tin chi tiết về địa điểm gần đây vì name có thể hết hạn.
Đặt skipHttpRedirect thành true để yêu cầu trả về một phản hồi JSON. Theo mặc định, yêu cầu sẽ 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 sử dụng để gửi 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.