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 z Google Maps Platform, takimi jak Address Validation API, możesz szukać sposobu na rozpoczęcie korzystania z usługi bez zbytniej pomocy zespołów technicznych.

Przypadki użycia

Teraz omówimy przypadki użycia, w których Address Validation API w Arkuszach Google jest przydatny:

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

Szablon Arkuszy Google

Rozwiązaniem jest Arkusz Google, który zawiera niestandardowe funkcje Apps Script, które będą wykonywać żądania do Address Validation API w kolejności.

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

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

1. Otwórz przykładowy arkusz kalkulacyjny i w menu wybierz: Plik > Utwórz kopię
   (musisz zalogować się na konto Google lub je utworzyć)
   
2. Włącz Address Validation API i wygeneruj klucz interfejsu API w konsoli Cloud.
   
3. W karcie Arkusze „Klucz interfejsu API + panel” zastąp komórkę B2 kluczem interfejsu API.
   
4. Skopiuj i wklej adresy w szablonie (w osobnym arkuszu, aby sformatować dane: połącz numer domu, nazwę ulicy, miasto i kod pocztowy).
   
5. Zaznacz komórki arkusza, a następnie w menu wybierz „Weryfikacja adresu” > „Wybór Address Validation API”.
   
6. Przy pierwszym uruchomieniu pojawi się komunikat „Wymagane uprawnienia”, aby umożliwić dostęp do Apps Script.
   

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

Wskazówka:aby zachować zgodność z Warunkami korzystania z 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 na ograniczonym zbiorze adresów. Dozwolony okres buforowania: 30 kolejnych dni kalendarzowych, po których Klient musi (1) usunąć buforowaną treść z Map Google lub (2) zastąpić ją danymi użytkownika końcowego przekazanymi przez użytkownika końcowego w ramach potwierdzenia lub korekty. Zapoznaj się z tabelą 11.3.1 (Uprawnienia do buforowania) w Warunkach korzystania z Google Maps Platform:

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

Uwagi

• Wydajność: przetwarzaj dane w partiach po 1000 wierszy. Skrypt może się zatrzymać, np. gdy przekroczysz limit interfejsu API na sekundę. W takim przypadku kontynuuj od wiersza, w którym skrypt się zatrzymał.
• Możesz uzyskać dostęp do kodu, klikając Menu > Rozszerzenia > Apps Script, i utworzyć własną wersję skryptu dostosowaną do swoich potrzeb.
• Ceny Address Validation API.

Podsumowanie

Address Validation API w Arkuszach Google umożliwia osobom niebędącym programistami wysyłanie zapytań do Address Validation API i zrozumienie, jak może to być strategiczne dla ich firmy. Ten dokument pokazuje, jak każdy może zacząć wysyłać zapytania do interfejsu API, tworząc klucz interfejsu API i używając podanego szablonu Arkuszy Google.

Następne kroki

Sugerowane dalsze lektury:

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

Współtwórcy

Ten artykuł jest utrzymywany przez Google. Pierwotnie napisali go ci współtwórcy:
Główny autor:

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