Внимание! Вышла версия API 4.7. Подробная информация приведена в истории изменений. Публикации, связанные с COVID-19, по-прежнему временно разрешены для торговых сетей.

Поиск соответствий в Картах по адресам

С помощью Google My Business API вы можете создать платформу для продавцов, чтобы им было удобно управлять данными о своих компаниях в Google. Платформа поддерживает следующие функции: поиск мест по названию кампании, почтовому адресу и телефону. Продавцы смогут запрашивать право собственности, а также указывать точное местоположение офисов и магазинов (широту и долготу).

Подготовка

Прежде чем начинать работу с Google My Business API, необходимо зарегистрировать свое приложение и получить учетные данные OAuth 2.0. Подробнее о начале работы с Google My Business API рассказывается в этой статье.

Как работать с данными об адресах

Для работы с данными об адресах и геолокацией на собственной платформе вы можете использовать два отдельных набора инструментов: Google My Business API и Maps API.

Самые популярные ресурсы для работы с сервисом "Google Мой бизнес"

С помощью API GoogleLocations продавец может заранее узнать, заявлял ли кто-то права собственности на определенный адрес в сервисе "Google Мой бизнес". Если нет, то можно сразу же запросить доступ к этим данным.

Объект PostalAddress представляет собой физический адрес компании.

Самые популярные ресурсы для работы с сервисом "Google Карты"

Виджеты мест для Карт на JavaScript часто используются для создания интерактивных карт в партнерских системах. Рекомендуем также обратить внимание на следующие API:

Один или ноль вариантов

Когда партнер ищет подходящие адреса для своей компании, его цель – сузить результаты поиска так, чтобы получить только один вариант или обнаружить, что таких адресов нет. Это говорит о том, что адрес точно соответствует критериям поиска или ещё не был добавлен в сервис "Google Мой бизнес".

Если в списке результатов поиска пусто или есть только один адрес, используйте метод accounts.locations.create для создания новых данных или следуйте руководству по работе с GoogleLocations, чтобы запросить право собственности на существующий адрес. Если система Google не может выполнить геокодирование адреса, он не будет создан и в ответе API вы увидите запрос координат LatLng. Инструкции для продавцов по добавлению координат LatLng приведены здесь.

После определения координат LatLng создаются новые данные о компании.

Частичные соответствия или много вариантов

Когда владелец компании или его представитель ищет места, соответствующие адресу, в списке результатов могут появиться частичные соответствия или много вариантов. Сузить результаты поиска с помощью Maps API можно вручную двумя способами.

Если в результатах поиска есть несколько частичных соответствий, пользователь партнерской платформы может выполнить одно из следующих действий:

  • Изучить эти совпадения и выбрать подходящий вариант.
  • Изменить запрос так, чтобы получить только один вариант или обнаружить, что таких адресов нет.
Несколько частичных соответствий в результатах поиска по адресу.

Выбор из одного или нескольких точных соответствий

Иногда в результатах поиска появляется несколько адресов, полностью соответствующих поисковому запросу. Допустим, пользователь указал в поисковой строке на партнерской платформе следующий адрес:

Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia

Он получил следующие результаты, каждый из которых соответствует адресу:

  • Kasperson Printer Center, неподтвержденный адрес.
  • Bengo Seguro, подтвержденный адрес.
  • Garush Productions, неподтвержденный адрес.

Пользователь должен вручную выбрать подходящий вариант. Чтобы клиенты могли прокладывать точные маршруты, в таких случаях может быть необходимо скорректировать широту и долготу (LatLng). Инструкции по добавлению координат LatLng вручную приведены здесь.

Как корректировать данные о геолокации вручную

Представители компаний могут указать широту и долготу (LatLng) своего офиса или магазина, чтобы данные в сервисе "Google Мой бизнес" были максимально точными. Если координаты LatLng неизвестны, можно вручную поставить маркер с помощью специального виджета. Это заменяет добавление объекта LatLng.

Один адрес соответствует трем местам, между которыми 1500 футов. Чтобы точно сопоставить адрес компании с координатами LatLng, их необходимо скорректировать вручную для каждого места.

Качество результатов поиска

Результаты поиска сильно зависят от географического региона и от того, насколько точно указан адрес в запросе. В развивающихся странах данных о компаниях в Картах меньше. Кроме того, места не всегда могут соответствовать принятым в Google форматам адресов. Это снижает качество результатов поиска, поэтому адреса приходится чаще корректировать вручную с помощью Maps API.