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 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 , używając własnych adresów.
- Porównanie: porównaj wyniki interfejsu 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óra z nich
może zapewnić lepsze wyniki.
Szablon Arkuszy Google
Rozwiązaniem jest Arkusz Google, który zawiera niestandardowe funkcje Apps Script , które będą wykonywać żądania do interfejsu Address Validation API w kolejności.
Aby uruchomić adresy za pomocą interfejsu API, wykonaj te czynności (wymagane jest konto Google
i klucz API
):
- Otwórz przykładowy
arkusz kalkulacyjny
i w menu wybierz: Plik > Utwórz kopię
(musisz zalogować się na konto Google lub je utworzyć) - Włącz Address Validation
API
i wygeneruj klucz interfejsu API w konsoli Cloud.
- Na karcie Arkusze „Klucz interfejsu API + panel” zastąp komórkę B2 kluczem interfejsu API.
- Skopiuj i wklej adresy w szablonie (w osobnym arkuszu, aby sformatować dane: połącz numer domu, nazwę ulicy, miasto i kod pocztowy).
- Zaznacz komórki arkusza, a następnie w menu wybierz „Weryfikacja adresu” > „Wybór interfejsu Address Validation API”.
- Przy pierwszym uruchomieniu pojawi się komunikat „Wymagane uprawnienia”, aby umożliwić dostęp do Apps Script.
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 podanymi przez użytkownika końcowego w ramach potwierdzenia lub korekty. Zapoznaj się z tabelą 11.3.1 (Uprawnienia do buforowania) w Warunkach korzystania z usługi Google Maps
Platform:
- placeId
- Lokalizacja: wartości szerokości i długości geograficznej
- verdict
- formattedAddress
- postalAddress
- addressComponent: componentName
- Dane USPS standardizedAddress
Uwagi
- Wydajność: przetwarzaj dane w partiach po 1000 wierszy. Skrypt może się zatrzymać, na przykład po przekroczeniu limitu 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.
- 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 zrozumienie, jak może on być strategiczny 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.
Dalsze działania
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ń