장소 사진

플랫폼 선택: Android iOS JavaScript 웹 서비스

<ph type="x-smartling-placeholder">

Places API의 일부인 장소 사진 서비스는 사진에 고품질 사진 콘텐츠를 추가할 수 있는 유일한 API입니다. 애플리케이션입니다. 장소 사진 서비스를 사용하면 수백만 장의 사진에 액세스할 수 있습니다. 장소 데이터베이스에 저장됩니다. 장소를 사용하여 장소 정보를 가져오는 경우 세부정보 요청, 관련 사진에 대해 사진 참조가 반환됩니다. 있습니다. 장소 찾기, 주변 검색, 텍스트 검색 요청도 단일 사진을 반환합니다. 참고할 수 있습니다. 사진 서비스를 사용하여 다음 항목에 액세스할 수 있습니다. 사진을 참조한 뒤 최적의 크기로 이미지를 조정할 수 있습니다. 애플리케이션입니다.

장소 사진 요청

장소 사진 요청은 다음 형식의 HTTP URL입니다.

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

검색 요청을 시작하기 위해서는 특정 매개변수가 필요합니다. 표준과 같음 URL에서 모든 매개변수는 앰퍼샌드 (&) 문자를 사용하여 구분합니다. 이 매개변수 및 가능한 값 목록은 아래에 나와 있습니다.

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.

사진 참조

장소 사진 서비스에 대한 모든 요청에는 photo_reference, 장소 찾기, 주변 검색, 텍스트 검색 또는 장소 세부정보에 대한 응답에서 반환됩니다. 합니다. 다음과 같은 경우 이러한 요청에 대한 응답에 photos[] 필드가 포함됩니다. 관련 사진 콘텐츠가 있는 사진

참고: 반환되는 사진 수는 요청에 따라 다릅니다.

  • 장소 찾기, 주변 검색 또는 텍스트 검색 요청은 최대 1개의 photo 요소를 반환합니다. 입니다.
  • 장소 세부정보 요청은 최대 10개의 photo 요소를 반환합니다.

각 photo 요소는 다음 필드를 포함합니다.

  • photo_reference: 사진 식별에 사용되는 문자열 수행할 수 있습니다.
  • height: 이미지의 최대 높이
  • width: 이미지의 최대 너비입니다.
  • html_attributions[] - 모든 필수 속성이 포함되어 있습니다. 이 필드는 항상 존재하지만 비어 있을 수도 있습니다.

사진 서비스에서 반환되는 사진은 다양한 위치에서 가져온 것입니다. 비즈니스 소유자 및 사용자 제공 사진이 포함됩니다. 대부분의 경우 사진을 저작자 표시 없이 사용할 수 있거나 필수 저작자 표시가 있습니다. 이미지의 일부로 포함되어 있습니다 그러나 반환된 photo 요소가 html_attributions 필드에 값이 있으면 저작자를 표시할 수 있습니다.

다음 예는 장소 세부정보 요청을 보여줍니다.

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

다음은 응답의 photos[] 배열에 대한 예입니다.

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

장소 사진의 예

아래는 예시 요청입니다. 이 요청은 참조된 너비가 400픽셀이 되도록 이미지의 크기를 조정합니다.

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

장소 사진 응답

성공적인 장소 사진 요청에 대한 응답은 이미지입니다. 유형 이미지는 원래 제출한 사진의 유형에 따라 다릅니다.

요청이 사용 가능한 할당량을 초과하는 경우 서버에서 아래 이미지를 표시하여 할당량이 초과:

할당량 초과 이미지

서버가 요청을 이해할 수 없으면 HTTP 400을 반환합니다. 잘못된 요청을 나타냅니다. 이 문제가 발생하는 가장 일반적인 이유는 잘못된 요청에는 다음이 포함됩니다.

  • 제출된 사진 참조가 올바르게 지정되지 않았습니다.
  • 요청에 maxwidth 또는 maxheight이(가) 포함되어 있지 않습니다. 매개변수입니다.
  • maxwidth 또는 maxheight 매개변수의 값이 설정됨 null에게 전송합니다.
  • photo_reference이(가) 만료되었습니다. photo_reference가 만료되면 Place Details 요청 장소 찾기, 주변 검색, 또는 텍스트 검색 업데이트된 photo_reference 값을 가져옵니다.