Interfejs API do weryfikacji adresów w Arkuszach Google

Cel

Z tego dokumentu dowiesz się, jak używać interfejsu Address Validation API w Arkuszach Google, aby szybko i łatwo przetestować usługę.

Jako osoba niebędąca programistą, która chce pracować z danymi pochodzącymi z Google Maps Platform, takimi jak interfejs Address Validation API, możesz chcieć znaleźć sposób na rozpoczęcie korzystania z usługi bez dużej pomocy ze strony zespołów technicznych.

Przypadki użycia

Przyjrzyjmy się teraz przypadkom użycia, w których interfejs Address Validation API w Arkuszach Google jest przydatny:

• Wersja próbna: jako firma możesz szybko przetestować możliwości interfejsu Address Validation API za pomocą własnych adresów.
• Porównywanie: porównaj wyniki interfejsu Address Validation API z wynikami innych punktów końcowych, takich jak Geocoding API czy Places API.
• Test A/B: testuj warianty tego samego zbioru danych, aby sprawdzić, które z nich mogą dać lepsze wyniki.
  

Szablon Arkuszy Google

Rozwiązanie to Arkusz Google z niestandardowymi funkcjami Apps Script, które wykonują żądania w sekwencji do interfejsu Address Validation API.

Wskazówka: ten przykład służy wyłącznie jako wskazówka dotycząca integracji. Przed użyciem w aplikacjach sprawdź jakość. Pomoc jest dostępna w przypadku usług, takich jak interfejs Address Validation API użyty w tym przykładzie.

Aby uruchomić adresy za pomocą interfejsu API, wykonaj te czynności (wymagane są konto Google i klucz interfejsu API):

1. Otwórz przykładowy arkusz kalkulacyjny i w menu wybierz kolejno Plik > Utwórz kopię
   (musisz zalogować się na konto Google lub utworzyć je).
   
2. Włącz interfejs Address Validation API i wygeneruj klucz interfejsu API w konsoli Cloud.
   
3. Na karcie arkusza „Klucz interfejsu API + panel” zastąp komórkę B2 swoim kluczem interfejsu API.
   
4. Kopiowanie i wklejanie adresów w szablonie (w osobnym arkuszu w celu sformatowania danych: łączenie numeru domu, nazwy ulicy, miasta i kodu pocztowego)
   
5. Wybierz komórki arkusza, a następnie w menu wybierz „Weryfikacja adresu” > „Wybór interfejsu API do weryfikacji adresu”.
   
6. Przy pierwszym uruchomieniu pojawi się komunikat „Wymagana autoryzacja”, który umożliwi dostęp do Apps Script.
   

Ostrzeżenie: zabezpiecz swój klucz interfejsu API, ograniczając jego użycie tylko do interfejsu Address Validation API. Aby zapobiec nieoczekiwanemu użyciu, udostępniaj arkusz tylko zaufanym osobom i po zakończeniu analizy usuń klucz w konsoli.

Wskazówka: aby zachować zgodność z Warunkami korzystania z usługi Google Maps Platform, po 30 dniach usuń arkusz kalkulacyjny, ponieważ Arkusze Google mają wbudowaną historię.

Warunki usługi Google Maps Platform

Rozwiązanie jest udostępniane do celów testowych w przypadku ograniczonej liczby adresów: dozwolony okres buforowania: 30 kolejnych dni kalendarzowych, po których Klient musi (1) usunąć buforowane Treści z Map Google lub (2) zastąpić je danymi Użytkownika przekazanymi w ramach potwierdzenia lub korekty Użytkownika. Zapoznaj się z tabelą 11.3.1 Warunków korzystania z Google Maps Platform (Uprawnienia do buforowania):

• placeId
  
• Lokalizacja: wartości szerokości i długości geograficznej
  
• werdykt
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componentName
  
• USPS Data standardizedAddress
  

Uwagi

• Wydajność: przetwarzaj dane w porcjach po 1000 wierszy naraz. Skrypt może się ostatecznie zatrzymać, np. po przekroczeniu limitu interfejsu API na sekundę. W takim przypadku możesz kontynuować działanie od wiersza, w którym skrypt się zatrzymał.
• Kod jest dostępny w menu Rozszerzenia > Apps Script. Możesz utworzyć własną wersję skryptu dostosowaną do Twoich potrzeb.
• Cennik interfejsu Address Validation API.

Podsumowanie

Interfejs Address Validation API w Arkuszach Google umożliwia osobom niebędącym programistami wysyłanie zapytań do interfejsu Address Validation API i sprawdzanie, jak może on być przydatny w ich działalności. W tym dokumencie pokazujemy, jak każdy może zacząć wysyłać zapytania do interfejsu API, tworząc klucz interfejsu API i korzystając z podanego szablonu Arkuszy Google.

Następne działania

Sugerowane dodatkowe materiały:

• Weryfikacja adresu podczas płatności w e-commerce
• Biblioteka weryfikacji adresów o dużej liczbie zapytań

Współtwórcy

Google jest autorem tego artykułu. Oryginalni autorzy:
Główny autor:

Thomas Anglaret | Inżynier ds. rozwiązań