API проверки адресов в Google Sheets

Цель

В этом документе мы рассмотрим, как использовать API проверки адресов в Google Таблицах для быстрого и простого тестирования сервиса.

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

Варианты использования

Теперь давайте разберемся, в каких случаях API проверки адресов в Google Таблицах может быть полезен:

• Пробный период : Возможно, вашей компании потребуется быстро протестировать возможности API проверки адресов, используя собственные адреса.
• Сравнение : Сравните результаты проверки адресов с результатами других конечных точек, таких как API геокодирования или API мест.
• A/B-тестирование : Проведение A/B-тестирования различных вариантов одного и того же набора данных для определения того, какой из них может дать более подходящие результаты.
  

Шаблон Google Таблиц

Решением является Google Sheets , который включает в себя настраиваемые функции Apps Script , выполняющие последовательные запросы к API проверки адресов .

Совет: Этот пример предназначен только для ознакомления с рекомендациями по интеграции. Перед использованием в ваших приложениях необходимо убедиться в качестве. Поддержка доступна для таких продуктов, как API проверки адресов, используемый в этом примере.

Вы можете использовать API для отправки адресов, выполнив следующие шаги (требуется учетная запись Google и ключ API ):

1. Перейдите к образцу электронной таблицы и в меню выберите: Файл > Создать копию
   (Вам необходимо войти в свой аккаунт Google или создать новый)
   
2. Включите API проверки адресов и сгенерируйте ключ API в консоли Cloud .
   
3. На вкладке «Ключ API + Панель управления» замените ячейку B2 своим ключом API.
   
4. Скопируйте и вставьте адреса в шаблон (на отдельном листе для форматирования данных: объедините номер дома, название улицы, город и почтовый индекс).
   
5. Выберите ячейки листа, затем в меню выберите «Проверка адреса» > «Выбор API проверки адреса».
   
6. При первом запуске появится сообщение «Требуется авторизация», предоставляющее доступ к Apps Script.
   

Внимание: Защитите свой API-ключ, ограничив его использование только API проверки адресов. Чтобы предотвратить несанкционированное использование, убедитесь, что вы делитесь своей таблицей только с доверенными лицами, и удалите свой ключ в консоли после завершения анализа.

Совет: чтобы соблюдать условия использования платформы Google Maps, обязательно удаляйте электронную таблицу через 30 дней, так как в Google Sheets есть встроенная функция истории.

Условия использования платформы Google Maps

Решение предоставляется в целях тестирования на ограниченном наборе адресов: Допустимый период кэширования: 30 последовательных календарных дней, после чего Заказчик должен (1) удалить кэшированный контент Google Maps или (2) заменить его данными конечного пользователя, предоставленными посредством подтверждения или исправления конечным пользователем. См. Таблицу 11.3.1 (Разрешения на кэширование) Условий предоставления услуг платформы Google Maps :

• placeId
  
• Местоположение: значения широты, значения долготы
  
• вердикт
  
• отформатированныйАдрес
  
• почтовый адрес
  
• addressComponent: componentName
  
• Стандартизированный адрес данных USPS
  

Соображения

• Производительность: Обрабатывайте данные партиями по 1000 строк за раз, не более. Скрипт может в конечном итоге остановиться, например, при превышении квоты API в секунду, и продолжить выполнение с той строки, где он остановился.
• Вы можете получить доступ к коду через Меню > Расширения > Скрипты приложений и создать собственную версию скрипта, адаптированную под ваши нужды.
• Цены на API проверки адресов.

Заключение

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

Следующие действия

Рекомендуемая дополнительная литература:

• Проверка адреса для оформления заказа в интернет-магазине
• Библиотека для проверки адресов большого объема

Авторы

Данная статья поддерживается компанией Google. Ее первоначальный автор — следующие лица.
Основной автор:

Томас Англаре | Инженер по решениям