Method: places.get

places/{placeId} 형식의 문자열인 리소스 이름을 기반으로 장소의 세부정보를 가져옵니다.

HTTP 요청

GET https://places.googleapis.com/v1/{name=places/*}

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 장소의 리소스 이름으로, places/{placeId} 형식입니다.

쿼리 매개변수

매개변수
languageCode

string

선택사항입니다. 장소 세부정보는 기본 언어(있는 경우)로 표시됩니다.

현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport
regionCode

string

선택사항입니다. 요청이 발생한 위치의 유니코드 국가/지역 코드 (CLDR)입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(해당하는 경우). 이 매개변수는 관련 법규에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참고하세요.

현재 3자리 지역 코드는 지원되지 않습니다.
sessionToken

string

선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. URL 및 파일 이름에 안전한 base64 문자열이어야 하며 길이는 최대 36자(영문 기준)여야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 장소 세부정보 또는 주소 유효성 검사를 호출하면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 장소 세부정보 또는 주소 유효성 검사 요청이 뒤따릅니다. 세션 내 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱에서 각 세션에 대해 새 토큰을 생성해야 합니다. sessionToken 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨).

다음 가이드라인이 권장됩니다.

  • 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다.
  • 각 세션에 대해 새 토큰을 생성합니다. 버전 4 UUID를 사용하는 것이 좋습니다.
  • 세션 내의 모든 Place Autocomplete, Place Details, Address Validation 요청에 사용되는 사용자 인증 정보가 동일한 Cloud 콘솔 프로젝트에 속하는지 확인합니다.
  • 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 Place의 인스턴스가 포함됩니다.