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

선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. ASCII 문자 36자 이하의 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

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

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

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

요청 본문

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

응답 본문

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