Cel
W tym dokumencie dowiesz się, jak używać interfejsu Address Validation API w Arkuszach Google, aby szybko i łatwo przetestować tę usługę.
Jeśli nie jesteś deweloperem, ale chcesz pracować z danymi pochodzącymi z Google Maps Platform, takimi jak Address Validation API, możesz znaleźć sposób na rozpoczęcie korzystania z usługi bez zbyt dużej pomocy ze strony zespołów technicznych.
Przypadki użycia
Przyjrzyjmy się teraz przypadkom 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 interfejsu 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.
- Test A/B: przetestuj różne warianty tego samego zbioru danych, aby sprawdzić, który z nich może zapewnić lepsze wyniki.
Szablon Arkuszy Google
Rozwiązaniem są Arkusze Google z niestandardowymi funkcjami Apps Script, które będą wysyłać żądania do interfejsu Address Validation API w odpowiedniej kolejności.
Możesz sprawdzić adresy za pomocą interfejsu API, wykonując te czynności (wymaga to konta Google i klucza interfejsu API):
- Otwórz przykładowy arkusz kalkulacyjny i w menu wybierz: Plik > Utwórz kopię
(musisz zalogować się na swoje konto Google lub je utworzyć). - Włącz Address Validation API i wygeneruj klucz interfejsu API w Cloud Console.
- Na karcie „API Key + Dashboard” (Klucz interfejsu API i panel) w Arkuszach 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).
- Wybierz komórki arkusza, a następnie w menu kliknij „Weryfikacja adresów” > „Wybór interfejsu Address Validation API”.
- Przy pierwszym uruchomieniu pojawi się komunikat „Wymagana autoryzacja” z prośbą o przyznanie dostępu do Apps Script.
Warunki usługi Google Maps Platform
Rozwiązanie jest udostępniane do celów testowych na ograniczonym zestawie adresów:
Dozwolony okres przechowywania w pamięci podręcznej: 30 kolejnych dni kalendarzowych, po których Klient musi (1) usunąć Treści Map Google z pamięci podręcznej lub (2) zastąpić je danymi Użytkownika potwierdzonymi lub poprawionymi przez Użytkownika. 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 geograficznej, wartości długości geograficznej
- werdykt
- formattedAddress
- postalAddress
- addressComponent: componentName
- Dane USPS standardizedAddress
Uwagi
- Wydajność: przetwarzaj dane w partiach po 1000 wierszy, nie więcej naraz. 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, wybierając Menu > Rozszerzenia > Apps Script, i utworzyć własną wersję skryptu dostosowaną do Twoich potrzeb.
- Ceny Address Validation API.
Podsumowanie
Address Validation API w Arkuszach Google umożliwia osobom, które nie są programistami, wysyłanie zapytań do Address Validation API i zrozumienie, jak może ono pomóc w rozwoju ich firmy. 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 udostępnionego szablonu Arkuszy Google.
Następne działania
Sugerowane materiały dodatkowe:
Współtwórcy
Google zarządza tym artykułem. Został on napisany przez tych współtwórców.
Główny autor:
Thomas Anglaret | inżynier ds. rozwiązań\