Places API는 기존의 장소 세부정보. 기존 Places API에 익숙하다면 새로운 버전의 장소 세부정보 다음과 같이 변경합니다.
- 필드 마스킹이 필요합니다. 응답에서 반환할 필드를 지정해야 합니다. 반환되는 필드의 기본 목록은 없습니다. 이 목록을 생략하면 메서드에서 오류를 반환합니다. 자세한 내용은 FieldMask입니다.
- 새 장소 세부정보는 API 키와 OAuth 토큰을 모두 인증 메커니즘으로 지원합니다.
- 새 장소 세부정보에서는 JSON만 응답 형식으로 지원됩니다.
- 장소 세부정보 (신규)의 JSON 응답 형식 API가 기존 API의 형식에서 변경되었습니다. 자세한 내용은 Places API 응답 이전
다음 표에는 기존 다음에 대해 이름이 변경되었거나 수정된 장소 세부정보 새 장소 세부정보 또는 더 이상 사용되지 않는 매개변수로 지원됩니다.
| 현재 매개변수 | 새 매개변수 | 참고 |
|---|---|---|
place_id |
places/PLACE_ID |
문자열 places/PLACE_ID는 장소 리소스 이름이라고도 합니다. Place Details (New)의 응답에서
주변 검색 (신규) 및 텍스트 검색 (신규)
요청의 경우 이 문자열은 응답의 name 필드에 포함됩니다.
독립형 장소 ID는 응답의 id 필드에 포함됩니다. |
language |
languageCode |
|
region |
regionCode |
요청 예시
다음 GET 요청 예시는 기존
장소 세부정보 이 예시에서는
장소 ID에 대한 정보를 포함하는 응답으로 모든 매개변수를 URL로 전달
매개변수입니다. 또한 이 예에서는 fields를 사용하므로 응답에
장소의 표시 이름 및 형식이 지정된 주소:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
장소 세부정보(신규)를 사용하면 GET 요청을 실행하고 URL 매개변수와 헤더의 모든 매개변수를 요청의 일부로 전달합니다. 이 는 필드 마스크를 사용하므로 응답에 표시 이름만 포함됩니다. 장소의 형식이 지정된 주소:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
문자열 places/PLACE_ID는 장소 리소스 이름이라고도 합니다. 장소 세부정보(신규), 주변 지역 검색(신규), 텍스트 검색(신규) 요청의 응답에서 이 문자열은 응답의 name 필드에 포함됩니다. 독립형 장소 ID는
응답의 id 필드입니다.