Google Maps Reviews
Google Maps 리뷰는 작성된 텍스트, 작성자 참조 정보, 평점, 원본 및 대상 링크, 게시 시각과 수집 시각, 미디어를 포함할 수 있는 공개 장소 피드백 기록입니다. 출처가 연결된 피드백 데이터셋을 만들고, 알고 있는 장소 또는 수집 기간별로 비교하는 데 활용할 수 있습니다.
Google Maps Reviews API 주요 기능
- 알고 있는 URL 일괄 입력별도의 식별자 API로 장소를 찾지 않고, 지원되는 google.com 또는 goo.gl URL을 하나 이상 비동기 작업 하나로 제출합니다.
- 선택 가능한 일 단위 기간최근 리뷰 기간이 필요한 워크플로에서는 양수 days_limit 값 하나를 제출한 모든 URL 행에 적용할 수 있습니다.
- 안정적인 리뷰 레코드리뷰 식별 정보, 텍스트, 작성자 필드, 평점, 장소 참조 정보, 타임스탬프, 원본 URL, 확인 가능한 미디어를 리뷰 v1.0 스키마로 읽습니다.
Google Maps Reviews API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | google.com, google.com의 모든 서브도메인, goo.gl 또는 goo.gl의 서브도메인에 있는 비어 있지 않은 URL을 쉼표나 줄바꿈으로 구분해 하나 이상 지정합니다. 리뷰 수집에는 알고 있는 Maps 장소 URL을 사용하세요. |
days_limit | 선택 | 리뷰의 최근 기간으로 모든 제공처 입력 행에 적용되는 양의 정수이며, 선택 값입니다. 생략하면 일 단위 기간 필터를 보내지 않습니다. |
results_limit | 선택 | 작업에 저장할 전체 리뷰 수의 상한으로, 1 이상 2,000 이하의 정수이며 선택 값입니다. 기본값은 100이고, 원본에서 제공되는 양에 따라 더 적은 행이 반환될 수 있습니다. |
Google Maps Reviews API 사용 방법
알고 있는 Google Maps URL을 제출하고, 비동기 작업을 추적한 뒤, 작업 결과 커서로 저장된 리뷰 레코드를 읽습니다.
- google.com 또는 goo.gl에 있는 지원되는 Google Maps 장소 URL을 하나 이상 준비합니다.
- urls를 /v1/google-maps/reviews로 POST하고, 필요하면 days_limit 값과 results_limit 값도 함께 보냅니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, results.has_more가 true이면 results.next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Google Maps Reviews API 추천 활용 사례
- 알고 있는 장소의 피드백 데이터셋: 정해 둔 공개 장소 URL 집합을 대상으로 리뷰 텍스트, 평점, 게시 시각, 원본 링크를 준비합니다.
- 출처를 고려한 작성자 조사: 확인 가능한 작성자 이름, 사용자 이름, 프로필 링크, 리뷰 URL을 보존해 레코드를 공개된 맥락까지 추적할 수 있게 합니다.
- 최근 기간 비교: 같은 장소 집합을 기록해 둔 days_limit 값으로 시점을 달리해 수집하고, 전체 이력을 확보했다고 주장하지 않으면서 범위가 정해진 수집 결과끼리 비교합니다.
- 미디어가 연결된 리뷰 아카이브: 확인 가능한 리뷰 미디어를 텍스트, 평점, 장소 참조 정보, 수집 시각과 함께 정규화된 조사용 레코드에 담아 둡니다.
Google Maps Reviews API 활용 팁
- 확인 가능한 google.com 또는 goo.gl Maps URL을 제출하세요. 장소 이름, Google Business Profile 계정, Place ID만으로는 urls 항목으로 허용되지 않습니다.
- days_limit 값은 양의 정수로 기간을 정하는 것이 의미가 있을 때만 사용하세요. 생략하면 제공처 행에 해당 필터가 적용되지 않습니다.
- results_limit은 URL마다 보장되는 값이 아니라 URL 묶음 전체에 적용되는 하나의 저장 결과 상한으로 취급하세요.
- 제출 시의 results_limit과 작업 결과를 읽을 때의 limit은 별개입니다. 후자는 페이지 크기를 1~500으로 조절하며 불투명한 커서를 사용합니다.
- 공개 원본에 노출되지 않으면 텍스트, 작성자 속성, 평점, 대상 참조 정보, 타임스탬프, 미디어가 없을 수 있다는 점을 감안하세요.
관련 API
Google Maps Reviews API 외에 Google Maps의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Maps Search API — 검색어와 위치로 공개 Google Maps 장소를 검색하며, 정규화된 장소 정보, 주소, 연락처, 평점, 리뷰 수, URL, 좌표 필드를 포함합니다.
- Google Maps Place Details API