장소 사진 (신규) 이 서비스는 읽기 전용 API로서 Google Cloud에서 제공하는 애플리케이션에 추가할 수 있습니다. 장소 사진 서비스는 장소 데이터베이스에 저장된 수백만 개의 사진에 액세스할 수 있습니다.
장소 세부정보, 주변 검색 또는 텍스트 검색 요청을 사용하여 장소 정보를 가져오는 경우 관련 사진 콘텐츠에 대한 사진 리소스를 요청할 수도 있습니다. 사진 서비스를 사용하면 참조된 사진에 액세스하고 이미지를 최적의 크기로 조정할 수 있습니다. 애플리케이션입니다.
API 탐색기를 사용하면 실시간 요청을 하여 API 및 API 옵션:
실습장소 사진 요청
장소 사진 요청은 다음과 같은 형식의 URL에 대한 HTTP GET 요청입니다.https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
여기서 다음과 같은 매개변수가 필요합니다.
- NAME에는 사진의 리소스 이름이 있습니다.
- API_KEY에는 API 키가 포함됩니다.
- PARAMETERS에는
maxHeightPx
매개변수 중 하나가 포함됩니다.maxWidthPx
매개변수 중 하나 또는 둘 다에 적용됩니다.
필수 및 선택 매개변수의 전체 목록은 아래에 설명되어 있습니다.
필수 매개변수
사진 이름
사진을 고유하게 식별하는 문자열 식별자입니다. 사진 이름은
Place Details (New), Nearby Search (New),
또는 텍스트 검색 (신규) 요청
photos[]
배열에서 각 요소의 name
속성에 설정합니다.
예를 보려면 사진 이름 가져오기를 참고하세요.
maxHeightPx 및 maxWidthPx
원하는 이미지의 최대 높이와 너비를 픽셀 단위로 지정합니다. 이미지가 더 작은 경우 지정된 값보다 작으면 원본 이미지가 반환됩니다. 이미지가 어느 쪽이든 더 큰 경우 두 차원 중 더 작은 쪽에 맞도록 크기가 원래 크기로 제한됨 가로세로 비율 maxheight 및 maxwidth 속성은 1부터 4800 사이의 정수를 허용합니다.
maxHeightPx
나 maxWidthPx
중 하나를 지정하거나 둘 다 지정해야 합니다.
선택적 매개변수
skipHttpRedirect
false
(기본값)인 경우 이미지로 HTTP 리디렉션을 만들어 이미지를 반환합니다.
true
인 경우 리디렉션을 건너뛰고 이미지 세부정보가 포함된 JSON 응답을 반환합니다.
예를 들면 다음과 같습니다.
{ "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media", "photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo" }
HTTP 요청이 아닌 경우 이 옵션이 무시됩니다.
사진 이름 가져오기
장소 사진 서비스에 대한 모든 요청에는
사진 리소스 이름으로, 주변 검색, 텍스트 검색 또는
Place Details 요청 다음과 같은 경우 이러한 요청에 대한 응답에는 photos[]
배열이 포함됩니다.
관련 사진 콘텐츠가 있는 사진
photo[]
의 각 요소에는 다음 필드가 포함됩니다.
name
- 사진을 생성할 때 사진의 리소스 이름이 포함된 문자열입니다. 수행할 수 있습니다. 이 문자열의 형식은 다음과 같습니다.places/PLACE_ID/photos/PHOTO_RESOURCE
heightPx
- 이미지의 최대 높이(픽셀)입니다.widthPx
- 이미지의 최대 너비(픽셀)입니다.authorAttributions[]
- 모든 필수 저작자 표시입니다. 이 필드는 항상 존재하지만 비어 있을 수도 있습니다.
사진 서비스에서 반환되는 사진은 다양한 위치에서 가져온 것입니다.
비즈니스 소유자 및 사용자 제공 사진이 포함됩니다. 대부분의 경우
사진을 저작자 표시 없이 사용할 수 있거나 필수 저작자 표시가 있습니다.
이미지의 일부로 포함되어 있습니다 그러나 반환된 photo
요소가
authorAttributions
필드에 값이 있으면
저작자를 표시할 수 있습니다.
다음 예는 다음의 photos
를 포함하는 장소 세부정보 요청을 보여줍니다.
응답에 photos[]
배열이 포함되도록 필드 마스크를 수정합니다.
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다음은 응답의
photos[]
배열에 대한 예입니다.
... "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" } ] }, ...
장소 사진 요청
아래 요청 예에서는 리소스 name
를 사용하여 이미지를 반환하므로 크기를 조절하여
최대 400픽셀(높이와 너비)입니다.
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
응답 이미지는 이미지입니다. 이미지 유형은 원래 제출한 사진의 유형에 따라 다릅니다.
요청이 사용 가능한 할당량을 초과하는 경우 서버에서 아래 이미지를 표시하여 할당량이 있음을 나타냅니다. 초과:
![할당량 초과 이미지](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/maps-static/images/quota.png?authuser=0000&hl=ko)
서버가 요청을 이해할 수 없으면 HTTP 400을 반환합니다. 잘못된 요청을 나타냅니다. 이 문제가 발생하는 가장 일반적인 이유는 잘못된 요청에는 다음이 포함됩니다.
- 제출한 사진 이름이 올바르게 지정되지 않았습니다.
- 요청에
maxHeightPx
또는maxWidthPx
이(가) 포함되지 않았습니다. 매개변수 값으로 사용됩니다. maxHeightPx
또는maxWidthtPx
매개변수의 값이 설정됨null
에게 전송합니다.name
이(가) 만료되었습니다.name
가 만료되면 Place Details (New), Nearby Search (New), 즉 또는 텍스트 검색 (신규)을 선택하여 새name
사용해 보기
API 탐색기를 사용하면 샘플 요청을 수행하여 API 및 API 옵션에 익숙해지실 수 있습니다.
요청하려면 다음 안내를 따르세요.
- API 아이콘
을 선택합니다. 을 클릭합니다.
name
매개변수를 다음과 같이 설정합니다.places/PLACE_ID/photos/PHOTO_RESOURCE/media
- 요청이 JSON을 반환하도록
skipHttpRedirect
를true
로 설정합니다. 있습니다. 기본적으로 요청은 이미지를 반환하며 이 이미지는 API 탐색기 - 실행 버튼을 선택합니다. 팝업에서 원하는 계정을 선택합니다. 사용하여 요청을 수행합니다.
API 탐색기 패널에서 펼치기 아이콘을 선택합니다.
: API 탐색기 창을 펼칩니다.