이 문서에는 Places API에 관해 자주 묻는 질문(FAQ)의 답변이 포함되어 있습니다. 여기에서 질문에 대한 답변을 찾을 수 없는 경우 다음 페이지가 도움이 될 수 있습니다.
Places API에는 개발자 커뮤니티도 활발히 운영되고 있습니다. 코드에 관해 궁금한 점이 있으면 커뮤니티에 질문을 게시하는 것이 좋습니다. 질문에 대한 자세한 내용은 지원 페이지를 참조하세요.
장소 검색
유형별로 필터링할 때 일부 장소가 반환되지 않는 이유는 무엇인가요?
찾는 장소가 아직 분류되지 않았을 수 있습니다.
Google에서 지원되는 장소 유형 중 하나로 분류할 수 있을 만큼 충분한 데이터를 확보할 때까지 모든 장소는 일반 유형 'establishment
'로 분류됩니다.
이 문제를 해결하려면 장소 type
를 keyword
매개변수에 전달하면 됩니다. keyword
매개변수는 이름, 유형, 주소 및 고객 리뷰에 일치됩니다.
장소 등록정보에 type
카테고리를 직접 추가하려면 장소 수정을 제출하세요. 수정사항이 승인되어 게시되면 올바른 type
필터링을 사용하여 표시됩니다.
주변 장소 중 일부가 반환되지 않는 이유는 무엇인가요?
기본적으로 Places API는 제공된 radius
내에서 prominence
를 기준으로 결과를 정렬합니다. 주변 검색 요청은 세 페이지에 걸쳐 최대 60개의 결과를 반환할 수 있습니다. prominence
에서
순위가 22위인 장소는 두 번째 결과 페이지에 표시되며, 페이징을 통해 액세스할 수
있습니다. prominence
에서
60위 이상인 장소는 검색의 중앙에 더 가깝더라도 검색결과에
포함되지 않습니다.
쿼리의 rankby
매개변수를 distance
로 설정하고 radius
매개변수를 생략하면 prominence
대신 distance
을 기준으로 결과를 정렬할 수 있습니다. 관련성은 무시되고 장소가 location
로부터의 거리 순으로 반환됩니다.
유형별로 요청을 필터링하는 경우 일부 결과가 응답에서 제외될 수 있습니다. 자세한 내용은 FAQ 항목 유형별로 필터링할 때 일부 장소가 반환되지 않는 이유는 무엇인가요?를 참고하세요.
일부 types
별로 필터링할 때 결과가 두 개까지만 표시되는 이유는 무엇인가요?
Places API는 주변 검색 요청을 실행하는 지역을 식별하는 데 도움이 되도록 주변 establishments
목록 (지원되는 장소 유형의 첫 번째 표에 있는 모든 항목)과 최대 2개의 위치 (지원되는 장소 유형의 두 번째 표에 있는 모든 항목) 결과를 반환하도록 설계되었습니다.
주변 검색 요청을 locality
또는 political
와 같은 위치 type
로 필터링하면 establishment
결과가 필터링됩니다.
장소 데이터
장소를 추가하거나 수정하려면 어떻게 해야 하나요?
비즈니스 소유자는 비즈니스 프로필을 사용하여 Google 지도에서 비즈니스 정보를 추가, 인증, 관리할 수 있습니다.
장소를 소유하지 않은 경우에도 변경사항을 제안할 수 있습니다.
문제 해결
"status": "REQUEST_DENIED" 메시지가 계속 표시되는 이유는 무엇인가요?
다음과 같은 경우 Places API에서
"status": "REQUEST_DENIED"
를 반환합니다.
- Google Cloud Console에서 Places API를 활성화하지 않았습니다.
- 요청에서
key
매개변수가 누락되었습니다. key
매개변수가 Google Cloud 콘솔의 API 키와 일치하지 않습니다.- Google Cloud Console에서 API 키가 올바르게 설정되지 않았습니다.
- 브라우저 제한 API 키를 사용하는 경우 허용된 리퍼러가 올바른지 확인합니다.
- 서버 제한 API 키를 사용하는 경우 허용된 IP가 올바른지 확인하세요.
- Android 또는 iOS 제한이 있는 API 키는 지원되지 않습니다. 일반 (무제한) API 키나 브라우저 또는 서버 제한이 있는 키를 사용하세요.
- 요청이
HTTPS
요청으로 전송되지 않았습니다. 모든 Places API 요청에는HTTPS
가 필요합니다. - 요청을 전송하는 데 잘못된
HTTP method
가 사용되었습니다.- [장소 추가][place-add]를 제외한 모든 요청은
GET
요청으로 전송해야 합니다. - 모든 [장소 추가][place-add] 요청은
POST
요청으로 전송해야 합니다.
- [장소 추가][place-add]를 제외한 모든 요청은