Hình ảnh về địa điểm (Cũ)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Ảnh địa điểm (Phiên bản cũ), một phần của Places API, là một API chỉ đọ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. Place Photos (Legacy) cho phép bạn truy cập vào hàng triệu bức ảnh được lưu trữ trong cơ sở dữ liệu Places. Khi bạn nhận được thông tin về địa điểm bằng cách sử dụng yêu cầu PlaceDetails, các thông tin tham chiếu về ảnh sẽ được trả về cho nội dung ảnh có liên quan. Các yêu cầu Tìm địa điểm (Phiên bản cũ), Tìm kiếm lân cận (Phiên bản cũ) và Tìm kiếm bằng văn bản (Phiên bản cũ) cũng trả về một thông tin tham chiếu duy nhất về ảnh cho mỗi địa điểm, khi có liên quan. Khi dùng Ảnh địa điểm (Phiên bản cũ), bạn có thể truy cập vào các bứ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.

Yêu cầu về Hình ảnh về địa điểm (Cũ)

Yêu cầu Place Photos (cũ) là một URL HTTP có dạng như sau:

https://maps.googleapis.com/maps/api/place/photo?parameters

Bạn cần có một số tham số nhất định để bắt đầu yêu cầu tìm kiếm. Theo tiêu chuẩn trong URL, tất cả các tham số đều được phân tách bằng ký tự dấu và (&). Danh sách các thông số và giá trị có thể của các thông số đó được liệt kê dưới đây.

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

Ảnh tham chiếu

Tất cả các yêu cầu đối với Place Photos (Legacy) đều phải bao gồm một photo_reference, được trả về trong phản hồi cho yêu cầu Find Place (Legacy), Nearby Search (Legacy), Text Search (Legacy) hoặc Place Details (Legacy). Phản hồi cho các yêu cầu này sẽ chứa trường photos[] nếu địa điểm có nội dung nhiếp ảnh liên quan.

Lưu ý: Số lượng ảnh được trả về sẽ thay đổi tuỳ theo yêu cầu.

  • Yêu cầu Tìm địa điểm (Phiên bản cũ), Tìm kiếm lân cận (Phiên bản cũ) hoặc Tìm kiếm bằng văn bản (Phiên bản cũ) trả về tối đa một phần tử photo trong mảng.
  • Yêu cầu Chi tiết về địa điểm (cũ) trả về tối đa 10 phần tử photo.

Mỗi phần tử photo 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 Place Photos (Legacy).
  • 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[] – chứa mọi thông tin bắt buộc về quyền tác giả. Trường này sẽ luôn xuất hiện, nhưng có thể trống.

Ảnh do Place Photos (Phiên bản cũ) trả về được lấy từ nhiều vị trí, bao gồm cả ảnh do chủ sở hữu 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 nhận quyền tác giả hoặc sẽ có thông tin ghi nhận quyền tác giả bắt buộc trong 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 html_attributions, thì bạn phải thêm thông tin ghi công bổ sung vào ứng dụng của mình bất cứ khi nào bạn hiển thị hình ảnh.

Ví dụ sau đây minh hoạ một yêu cầu Chi tiết về địa điểm (Phiên bản cũ):

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

Dưới đây là ví dụ về mảng photos[] trong phản hồi.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

Ví dụ về Hình ảnh về địa điểm (Cũ)

Sau đây là ví dụ về yêu cầu. Yêu cầu này trả về hình ảnh được tham chiếu, thay đổi kích thước để hình ảnh có chiều rộng tối đa là 400 pixel.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Phản hồi về Ảnh về địa điểm (Cũ)

Phản hồi của một yêu cầu Place Photos (Cũ) thành công là một hình ảnh. Loại hình ảnh phụ thuộc vào loại ảnh được 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:

Hình ảnh vượt quá hạn mức

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

  • Thông tin tham chiếu về ảnh bạn gửi không được chỉ định chính xác.
  • Yêu cầu không bao gồm tham số maxwidth hoặc maxheight.
  • Giá trị cho tham số maxwidth hoặc maxheight được đặt thành null.
  • Mã photo_reference đã hết hạn. Nếu photo_reference hết hạn, hãy gửi yêu cầu đến Place Details (Legacy), Find Place (Legacy), Nearby Search (Legacy) hoặc Text Search (Legacy) để nhận giá trị photo_reference mới.