Цель
В этом документе мы рассмотрим, как использовать Address Validation API в Google Таблицах, чтобы быстро и легко протестировать сервис.
Если вы не разработчик, но хотите работать с данными платформы Google Карт, например Address Validation API, то можете начать работу с сервисом без помощи технических специалистов.
Примеры использования
Теперь давайте рассмотрим, в каких случаях может быть полезен Address Validation API в Google Таблицах.
- Пробная версия. Если вы хотите быстро протестировать возможности Address Validation API, используя собственные адреса.
- Сравнение. Сравните результаты Address Validation API с результатами других конечных точек, например Geocoding API или Places API.
- A/B-тестирование. Протестируйте разные варианты одного набора данных, чтобы понять, какой из них дает лучшие результаты.
Шаблон Google Таблиц
Решение – таблица Google со специальными функциями Apps Script, которые будут последовательно отправлять запросы к Address Validation API.
Вы можете проверить адреса с помощью API, выполнив следующие действия (требуется аккаунт Google и ключ API):
- Откройте образец таблицы и в меню выберите "Файл > Создать копию"
(вам потребуется войти в аккаунт Google или создать его). - Включите Address Validation API и сгенерируйте ключ API в Cloud Console.
- На вкладке API Key + Dashboard (Ключ API и панель управления) замените значение в ячейке B2 своим ключом API.
- Скопируйте и вставьте адреса в шаблон (на отдельный лист, чтобы отформатировать данные: объедините номер дома, название улицы, город и почтовый индекс).
- Выберите ячейки таблицы, а затем в меню нажмите Address Validation (Проверка адреса) > Address Validation API selection (Выбор Address Validation API).
- При первом запуске появится сообщение "Требуется авторизация". Предоставьте доступ к Apps Script.
Условия использования платформы Google Карт
Решение предоставляется для тестирования на ограниченном наборе адресов.
Разрешенный период кеширования: 30 календарных дней подряд, после чего Клиент должен: 1) удалить кешированный Контент Google Карт или 2) заменить его данными Конечного пользователя,
предоставленными в результате подтверждения или исправления Конечным пользователем. Ознакомьтесь с Условиями использования платформы Google Карт, таблица 11.3.1 (Разрешения на кеширование):
- placeId
- Местоположение: значения широты и долготы.
- решение
- formattedAddress
- postalAddress
- addressComponent: componentName
- USPS Data standardizedAddress
Примечания
- Производительность: обрабатывайте не более 1000 строк за раз. Скрипт может остановиться, например, если превышена квота API в секунду. В этом случае продолжите с той строки, на которой остановился скрипт.
- Вы можете получить доступ к коду, выбрав "Меню > Расширения > Apps Script", и создать собственную версию скрипта, соответствующую вашим потребностям.
- Цены на Address Validation API.
Заключение
Address Validation API в Google Таблицах позволяет пользователям, не являющимся разработчиками, отправлять запросы к Address Validation API и понимать, как этот API может быть полезен для их бизнеса. В этом документе рассказывается, как начать отправлять запросы к API, создав ключ API и используя предоставленный шаблон Google Таблиц.
Дальнейшие действия
Рекомендуемые материалы:
Авторы
Google поддерживает эту статью. The following contributors originally wrote it.
Основной автор:
Тома Англаре (Thomas Anglaret) | разработчик решений\