Business Profile API를 사용하면 Google에 표시되는 비즈니스를 판매자가 관리하는 플랫폼을 만들 수 있습니다. 플랫폼에서 파트너가 비즈니스 이름, 주소, 전화 데이터와 일치하는 비즈니스 정보를 검색하도록 허용할 수 있습니다. 파트너는 위치의 소유권을 설정할 수 있으며, 비즈니스의 실제 위치를 위도와 경도 기준으로 정확하게 배치할 수 있습니다.
시작하기 전에
Business Profile API를 사용하기 전에 애플리케이션을 등록하고 OAuth 2.0 사용자 인증 정보를 획득해야 합니다. Business Profile API를 시작하는 방법에 관한 자세한 내용은 기본 설정을 참고하세요.
주소 데이터 사용 방법
플랫폼에서 주소 및 위치정보 데이터를 사용하기 위해 Business Profile API와 지도 API라는 두 가지 서로 다른 API와 리소스를 사용할 수 있습니다.
일반적으로 사용되는 비즈니스 프로필 리소스
판매자는 GoogleLocations
API를 사용하여 비즈니스 프로필에서 위치의 소유권 주장이 이미 제기되었는지 미리 확인할 수 있습니다. 소유권 주장이 제기되지 않았다면 판매자가 즉시 이 위치에 대한 액세스를 요청할 수 있습니다.
PostalAddress
객체는 비즈니스의 실제 주소를 나타냅니다.
일반적으로 사용되는 Google 지도 리소스
지도 JavaScript Place Widgets은 파트너 워크플로에서 대화형 지도를 만드는 데 일반적으로 사용됩니다. 또한 다음 지도 API도 유용합니다.
- Place Autocomplete 및 장소 세부정보로 장소 예상 검색어를 반환합니다. 가격 책정에 관한 자세한 내용은 SKU: 자동 완성(장소 세부정보에 포함) – 세션당을 참고하세요.
- 장소 검색으로 장소 정보를 쿼리합니다. 가격 책정에 관한 자세한 내용은 SKU: 장소 검색을 참고하세요.
- 지오코딩을 사용하여 주소의 지오코딩과 역 지오코딩을 제공합니다. 가격 책정에 관한 자세한 내용은 SKU: 지오코딩을 참고하세요.
1개 또는 0개 일치
파트너가 위치와 일치하는 비즈니스 정보를 검색하는 경우 검색 결과를 1개 또는 0개로 좁히는 것이 목표입니다. 이는 각각 위치가 검색 기준에 부합하거나 비즈니스 프로필에 아직 존재하지 않음을 의미합니다.
일치 항목이 1개 또는 0개인 경우 accounts.locations.create
메서드를 사용하여 새 비즈니스 정보를 생성하거나 GoogleLocations
가이드에 따라 기존 비즈니스 정보의 소유권을 주장하세요. Google에서 주소를 지오코딩할 수 없는
경우 위치 생성에 실패하고 API 응답에 LatLng
데이터 요청이
포함됩니다. 판매자가 LatLng
데이터를 제공하는 방법에
관한 자세한 내용은
위치정보 데이터 수동 조정을 참고하세요.
LatLng
좌표가 확인되면 새 비즈니스 정보가 생성됩니다.
부분 일치 및 다중 일치
비즈니스 소유자 또는 파트너의 운영팀이 위치와 일치하는 비즈니스 정보를 검색할 때, 입력하는 정보와 부분적으로만 일치하는 결과가 반환되거나 검색어와 일치하는 결과가 여러 개일 수 있습니다. 검색 결과를 1개 또는 0개까지 좁히려면 두 개의 지도 API 사용 사례를 통해 부분 일치와 다중 일치를 수동으로 해결합니다.
사용자가 상세검색 실행
파트너 플랫폼의 사용자가 위치를 검색하고 부분 일치 결과가 여러 건 표시된 경우 다음 방법 중 하나로 문제를 해결할 수 있습니다.
- 부분 일치 주소를 분석하고 올바른 주소를 선택합니다.
- 정확성을 높일 수 있도록 주소의 일부를 수정하거나 다시 입력하여 검색 결과를 1개 또는 0개로 좁힙니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=6&hl=ko)
사용자가 하나 이상의 전체 일치 항목 중에서 선택
경우에 따라 여러 위치가 사용자의 검색 주소와 완전히 일치할 수 있습니다. 사용자가 파트너 플랫폼에 다음 주소를 입력하는 경우를 예로 들 수 있습니다.
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
다음 응답이 반환되었으며, 검색한 주소와 모두 일치한다고 가정해 보겠습니다.
- Kasperson Printer Center, 인증되지 않은 위치
- Bengo Seguro, 인증된 위치
- Garush Productions, 인증되지 않은 위치
사용자는 일치하는 비즈니스를 수동으로 선택해야 합니다. 소비자에게 비즈니스에 관한
정확한 경로를 제공하기 위해 이러한 위치의 위도 및
경도(LatLng
) 데이터를 조정하여 정확도를 높일 필요가 있을 수
있습니다. 사용자가 직접 LatLng
를 입력하는 방법에 관한 자세한 내용은
위치정보 데이터 수동 조정을 참고하세요.
위치정보 데이터 수동 조정
비즈니스는 위도 및 경도(LatLng
) 좌표를 추가하여 비즈니스 프로필의 비즈니스 정보 정확도를 높일 수 있습니다. 신규 비즈니스에서 LatLng
좌표를 모르는 경우 지도 JavaScript Place Widgets으로 장소를 직접 핀으로 고정하여 정확한 LatLng
좌표를 설정할 수 있습니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=6&hl=ko)
LatLng
좌표와 정확하게 연결하려면
각 위치의 좌표를 수동으로 조정해야
합니다.검색 결과의 품질
검색 결과는 검색한 주소의 정확성과 지역에 따라 크게 달라집니다. 개발 중인 지역의 경우 Google 지도에 표시되는 장소가 많지 않고 Google 주소 형식을 따르지 않은 장소가 표시되기도 합니다. 이 경우 검색 결과의 품질이 낮아지므로 주소 형식을 수동으로 지정하고 지도 API를 사용할 필요성이 커집니다.