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

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

Place Photos (Cũ), một phần của Places API, 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. Ảnh địa điểm (Cũ) 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 Địa điểm. Khi bạn nhận thông tin về địa điểm bằng yêu cầu Chi tiết địa điểm, thông tin tham chiếu ảnh sẽ được trả về cho nội dung ảnh có liên quan. Yêu cầu Tìm địa điểm (Cũ), Nearby Search (Cũ) và Tìm kiếm văn bản (Cũ) cũng trả về một tệp đối chiếu ảnh cho mỗi địa điểm, nếu có. Khi sử dụng Ảnh địa điểm (Cũ), bạn có thể truy cập vào ảnh được tham chiếu và đổi kích thước ảnh thành kích thước tối ưu cho ứng dụng của mình.

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

Yêu cầu về Ảnh địa điểm (Cũ) là một URL loại 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 một yêu cầu tìm kiếm. Theo tiêu chuẩn trong URL, tất cả tham số đều được phân tách bằng ký tự dấu và (&). Danh sách các tham số và giá trị có thể có của các tham số đó được liệt kê bên dưới.

Tham số bắt buộc

photo_reference

Giá trị nhận dạng chuỗi giúp xác định duy nhất một ảnh. Tham chiếu ảnh được trả về từ yêu cầu Tìm kiếm địa điểm hoặc Place Details.

maxheight hoặc maxwidth

maxheight chỉ định chiều cao ưu tiên tối đa 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ình ảnh gốc sẽ được trả về. 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 ở tỷ lệ khung hình ban đầu.

maxwidth chỉ định chiều rộng tối đa ưu tiê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ình ảnh gốc sẽ được trả về. 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 một số nguyên từ 1 đến 1600.

Bạn phải chỉ định maxheight hoặc maxwidth, hoặc cả hai.

Ảnh tham khảo

Tất cả yêu cầu đối với Ảnh địa điểm (Cũ) phải bao gồm một photo_reference, được trả về trong phản hồi cho yêu cầu Tìm địa điểm (Cũ), Tìm kiếm lân cận (Cũ), Tìm kiếm văn bản (Cũ) hoặc Chi tiết địa điểm (Cũ). 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 ảnh liên quan.

  • Yêu cầu Tìm địa điểm (Cũ), Nearby Search (Cũ) hoặc Tìm kiếm văn bản (Cũ) trả về tối đa một phần tử photo trong mảng.
  • Yêu cầu Place Details (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 Ảnh địa điểm (Cũ).
  • 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 ghi nhận tác giả bắt buộc. Trường này sẽ luôn xuất hiện nhưng có thể để trống.

Ảnh do Place Photos (Cũ) trả về được lấy từ nhiều vị trí, bao gồm cả ả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, bạn có thể sử dụng những bức ảnh này mà không cần ghi nhận tác giả hoặc sẽ có thông tin ghi nhậ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ứ 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 Chi tiết địa điểm (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ề Place Photos (Cũ)

Dưới đây là ví dụ về yêu cầu. Yêu cầu này trả về hình ảnh được tham chiếu, đổi kích thước hình ảnh sao cho 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 của Place Photos (Cũ)

Kết quả của một yêu cầu thành công về Ảnh địa điểm (Cũ) 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 máy chủ không thể hiểu yêu cầu của bạn, thì 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ệ: