places/{placeId}
형식의 문자열인 리소스 이름을 기반으로 장소의 세부정보를 가져옵니다.
HTTP 요청
GET https://places.googleapis.com/v1/{name=places/*}
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
name |
필수 항목입니다. 장소의 리소스 이름으로, |
쿼리 매개변수
매개변수 | |
---|---|
language |
선택사항입니다. 가능한 경우 장소 세부정보가 기본 언어로 표시됩니다. 현재 지원되는 언어 목록: https://developers.google.com/maps/faq#languagesupport |
region |
선택사항입니다. 요청이 발생한 위치의 유니코드 국가/지역 코드(CLDR)입니다. 이 매개변수는 지역별 장소 이름과 같은 장소 세부정보를 표시하는 데 사용됩니다(있는 경우). 이 매개변수는 관련 법규에 따라 결과에 영향을 줄 수 있습니다. 자세한 내용은 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html을 참조하세요. 현재 3자리 지역 코드는 지원되지 않습니다. |
session |
선택사항입니다. 결제 목적으로 자동 완성 세션을 식별하는 문자열입니다. URL 및 파일 이름에 안전한 base64 문자열이어야 하며 길이는 최대 36자(영문 기준)여야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 장소 세부정보 또는 주소 유효성 검사를 호출하면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 장소 세부정보 또는 주소 유효성 검사 요청이 뒤따릅니다. 세션 내 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 세션마다 새 토큰을 생성해야 합니다. 다음 가이드라인이 권장됩니다.
|
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공한 경우 응답 본문에 Place
의 인스턴스가 포함됩니다.