С помощью Business Profile API вы можете создать платформу для продавцов, чтобы им было удобно управлять данными о своих компаниях в Google. Платформа поддерживает поиск мест по названию компании, почтовому адресу и телефону. Продавцы смогут запрашивать право собственности, а также указывать точное местоположение офисов и магазинов (широту и долготу).
Подготовка
Прежде чем начинать работу с Business Profile API, необходимо зарегистрировать свое приложение и получить учетные данные OAuth 2.0. Подробнее о начале работы с Business Profile API рассказывается в этой статье.
Как работать с данными об адресах
Для работы с данными об адресах и геолокацией на собственной платформе вы можете использовать два отдельных набора инструментов: Business Profile API и Maps API.
Самые популярные ресурсы для работы с профилем компании
С помощью API GoogleLocations
продавец может заранее узнать, заявлял ли кто-то права собственности на определенный адрес в сервисе "Профиль компании". Если нет, то можно сразу же запросить доступ к этим данным.
Объект PostalAddress
представляет собой физический адрес компании.
Самые популярные ресурсы для работы с сервисом "Google Карты"
Виджеты мест для Карт на JavaScript часто используются для создания интерактивных карт в партнерских системах. Рекомендуем также обратить внимание на следующие API:
- Возвращайте предполагаемые места с помощью автозаполнения и данных. Информацию о стоимости можно найти здесь.
- Запрашивайте информацию о местах с помощью решения для поиска. Информацию о стоимости можно найти здесь.
- Отправляйте данные о геокодировании и обеспечивайте обратное геокодирование. Информацию о стоимости можно найти здесь.
Один или ноль вариантов
Когда партнер ищет подходящие адреса для своей компании, его цель – сузить результаты поиска так, чтобы получить только один вариант или обнаружить, что таких адресов нет. Это говорит о том, что адрес точно соответствует критериям поиска или ещё не был добавлен в сервис "Профиль компании".
Если в списке результатов поиска пусто или есть только один адрес, используйте метод accounts.locations.create
для создания новых данных или следуйте руководству по работе с GoogleLocations
, чтобы запросить право собственности на существующий адрес. Если система Google не может выполнить геокодирование адреса, он не будет создан и в ответе API вы увидите запрос координат LatLng
. Инструкции для продавцов по добавлению координат LatLng
вы найдете в разделе Как корректировать данные о геолокации вручную.
После определения координат LatLng
создаются новые данные о компании.
Частичные соответствия или много вариантов
Когда владелец компании или его представитель ищет места, соответствующие адресу, в списке результатов могут появиться частичные соответствия или много вариантов. Сузить результаты поиска с помощью Maps API можно вручную двумя способами.
Уточнение запроса
Если в результатах поиска есть несколько частичных соответствий, пользователь партнерской платформы может выполнить одно из следующих действий:
- Изучить эти совпадения и выбрать подходящий вариант.
- Изменить запрос так, чтобы получить только один вариант или обнаружить, что таких адресов нет.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=9&hl=ru)
Выбор из одного или нескольких точных соответствий
Иногда в результатах поиска появляется несколько адресов, полностью соответствующих поисковому запросу. Допустим, пользователь указал в поисковой строке на партнерской платформе следующий адрес:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Он получил следующие результаты, каждый из которых соответствует адресу:
- Kasperson Printer Center, неподтвержденный адрес.
- Bengo Seguro, подтвержденный адрес.
- Garush Productions, неподтвержденный адрес.
Пользователь должен вручную выбрать подходящий вариант. Чтобы клиенты могли прокладывать точные маршруты, в таких случаях может быть необходимо скорректировать широту и долготу (LatLng
). Инструкции по добавлению координат LatLng
вы найдете в разделе Как корректировать данные о геолокации вручную.
Как корректировать данные о геолокации вручную
Представители компаний могут указать широту и долготу (LatLng
) своего офиса или магазина, чтобы данные в сервисе "Профиль компании" были максимально точными. Если координаты LatLng
неизвестны, можно вручную поставить маркер с помощью специального виджета. Это заменяет добавление объекта LatLng
.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=9&hl=ru)
LatLng
, их необходимо скорректировать вручную для каждого места.Качество результатов поиска
Результаты поиска сильно зависят от географического региона и от того, насколько точно указан адрес в запросе. В развивающихся странах данных о компаниях в Картах меньше. Кроме того, места не всегда могут соответствовать принятым в Google форматам адресов. Это снижает качество результатов поиска, поэтому адреса приходится чаще корректировать вручную с помощью Maps API.