AddressValidation class
google.maps.addressValidation.AddressValidation
zajęcia
Klasa statyczna do uzyskiwania dostępu do interfejsów API Address Validation.
Dostęp przez połączenie pod numer const {AddressValidation} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Metody statyczne | |
---|---|
|
fetchAddressValidation(request) Parametry:
Zwracana wartość:
Promise<AddressValidation> Sprawdza poprawność adresu. Zobacz https://developers.google.com/maps/documentation/javascript/address-validation/validate-address. |
Właściwości | |
---|---|
|
Typ:
Address optional Informacje o samym adresie, a nie o geokodzie. |
|
Typ:
Geocode optional Informacje o lokalizacji i miejscu, do którego został przypisany adres. |
|
Typ:
AddressMetadata optional inne informacje istotne dla dostarczalności. metadata nie musi być w pełni wypełniony w przypadku każdego adresu wysłanego do interfejsu Address Validation API. |
|
Typ:
string optional Identyfikator UUID tej odpowiedzi. Jeśli adres wymaga ponownej weryfikacji, do nowej prośby musi być dołączony ten identyfikator UUID. |
|
Typ:
USPSData optional Dodatkowe flagi dostarczalności udostępniane przez USPS. Dostępne tylko w regionach US i PR . |
|
Typ:
Verdict optional Flagi ogólnej oceny |
Metody | |
---|---|
|
toJSON() Parametry: brak
Zwracana wartość:
Object Konwertuje klasę AddressValidation na obiekt JSON o tych samych właściwościach. |
AddressValidationRequest interfejs
google.maps.addressValidation.AddressValidationRequest
interfejs
Interfejs żądania dla
.AddressValidation.fetchAddressValidation
Właściwości | |
---|---|
|
Typ:
PostalAddressLiteral Adres jest weryfikowany. Nieformatowane adresy należy przesyłać za pomocą PostalAddress.addressLines . |
|
Typ:
string optional To pole nie może być ustawione w przypadku pierwszej prośby o weryfikację adresu. Jeśli do pełnej weryfikacji jednego adresu potrzebne są kolejne żądania (np. jeśli zmiany wprowadzone przez użytkownika po wstępnej weryfikacji wymagają ponownej weryfikacji), każde kolejne żądanie musi zawierać w tym polu wartość z pierwszej odpowiedzi w sekwencji weryfikacji. |
|
Typ:
boolean optional Włącza tryb zgodny z USPS CASS. Dotyczy to tylko pola w AddressValidation . Uwaga: w przypadku żądań dotyczących adresów w Portoryko, które są obsługiwane przez USPS CASS, w polu PostalAddress.regionCode elementu address musi być podana wartość „PR”, a w polu PostalAddress.administrativeArea elementu address musi być podana wartość „Puerto Rico” (bez rozróżniania wielkości liter) lub „PR”. |
Address class
google.maps.addressValidation.Address
zajęcia
Szczegóły przetworzonego adresu. Przetwarzanie końcowe obejmuje poprawianie błędnie napisanych części adresu, zastępowanie nieprawidłowych części i wywnioskowywanie brakujących części.
Dostęp przez połączenie pod numer const {Address} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Właściwości | |
---|---|
|
Typ:
Array<AddressComponent> Poszczególne komponenty sformatowanego i poprawionego adresu wraz z informacjami o weryfikacji. Zawiera informacje o stanie weryfikacji poszczególnych komponentów. |
|
Typ:
string optional Przetworzony adres sformatowany jako adres w jednym wierszu zgodnie z zasadami formatowania adresów obowiązującymi w regionie, w którym znajduje się adres. |
|
Typ:
Array<string> Typy komponentów, które powinny znajdować się w prawidłowo sformatowanym adresie pocztowym, ale nie zostały znalezione w danych wejściowych ANI nie można ich było wywnioskować. Komponenty tego typu nie są dostępne w tych krajach: formatted_address , postal_address i address_components . Na przykład ['street_number', 'route'] w przypadku danych wejściowych „Boulder, Colorado, 80301, USA”. Listę możliwych typów znajdziesz tutaj. |
|
Typ:
PostalAddress optional Przetworzony adres w formie adresu pocztowego. |
|
Typ:
Array<string> Typy komponentów, które znajdują się w address_components , ale nie udało się potwierdzić ich poprawności. To pole jest udostępniane dla wygody użytkowników: jego zawartość jest równoważna z iteracją przez address_components w celu znalezienia typów wszystkich komponentów, w których nie jest równe lub flaga nie jest ustawiona na true . Listę możliwych typów znajdziesz tutaj. |
|
Typ:
Array<string> Wszystkie tokeny w danych wejściowych, których nie udało się rozpoznać. Może to być dane wejściowe, które nie zostały rozpoznane jako prawidłowa część adresu (na przykład w danych wejściowych „123235253253 Main St, San Francisco, CA, 94105” nierozwiązane tokeny mogą wyglądać jak ["123235253253"] , ponieważ nie przypominają prawidłowego numeru ulicy. |
AddressComponent class
google.maps.addressValidation.AddressComponent
zajęcia
Reprezentuje pojedynczy składnik adresu (np. nazwę ulicy, miasto).
Dostęp przez połączenie pod numer const {AddressComponent} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Właściwości | |
---|---|
|
Typ:
string optional Tekst nazwy komponentu. Na przykład „5th Avenue” jako nazwa ulicy lub „1253” jako numer ulicy. |
|
Typ:
string optional Kod języka BCP-47. Nie będzie on widoczny, jeśli nazwa komponentu nie jest powiązana z językiem, np. w przypadku numeru domu. |
|
Typ:
string optional Typ komponentu adresu. Listę możliwych typów znajdziesz w tabeli 2: Dodatkowe typy zwracane przez usługę Miejsca. |
|
Typ:
ConfirmationLevel optional Wskazuje poziom pewności, że komponent jest prawidłowy. |
|
Typ:
boolean Jeśli wartość to prawda, ten komponent nie był częścią danych wejściowych, ale został wywnioskowany na podstawie lokalizacji adresu. Uwzględnienie tego komponentu jest zalecane w przypadku pełnego adresu. |
|
Typ:
boolean Wskazuje, że nazwa komponentu została zastąpiona zupełnie inną nazwą. Na przykład zastąpienie nieprawidłowego kodu pocztowego prawidłowym kodem pocztowym dla danego adresu. To nie jest zmiana kosmetyczna. Komponent wejściowy został zastąpiony innym. |
|
Typ:
boolean Wskazuje poprawkę błędu pisowni w nazwie komponentu. Interfejs API nie zawsze oznacza zmiany z jednej wersji pisowni na inną, np. z „centre” na „center”. |
|
Typ:
boolean Jeśli wartość to „prawda”, ten komponent nie powinien występować w adresie pocztowym w danym regionie. Został zachowany tylko dlatego, że był częścią danych wejściowych. |
AddressMetadata class
google.maps.addressValidation.AddressMetadata
zajęcia
Metadane adresu. Nie ma gwarancji, że w przypadku każdego adresu wysłanego do interfejsu Address Validation API pole AddressMetadata będzie w pełni wypełnione.
Dostęp przez połączenie pod numer const {AddressMetadata} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Właściwości | |
---|---|
|
Typ:
boolean |
|
Typ:
boolean |
|
Typ:
boolean |
ConfirmationLevel stałe
google.maps.addressValidation.ConfirmationLevel
stałe
Różne możliwe wartości wskazujące poziom pewności, że komponent jest prawidłowy.
Dostęp przez połączenie pod numer const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
|
|
|
|
|
Geocode class
google.maps.addressValidation.Geocode
zajęcia
Zawiera informacje o miejscu, do którego przypisano dane wejściowe za pomocą geokodowania.
Dostęp przez połączenie pod numer const {Geocode} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Właściwości | |
---|---|
|
Typ:
LatLngBounds optional Granice geokodowanego miejsca. |
|
Typ:
number optional Rozmiar zakodowanego geograficznie miejsca w metrach. Jest to kolejny wskaźnik przybliżenia geokodowanej lokalizacji, ale wyrażony w rozmiarze fizycznym, a nie w znaczeniu semantycznym. |
|
Typ:
LatLngAltitude optional Geokodowana lokalizacja danych wejściowych. |
|
Typ:
string optional Identyfikator miejsca zakodowanego geograficznie. Zalecamy używanie miejsca zamiast adresów, współrzędnych geograficznych lub kodów Plus Code. Użycie współrzędnych do wyznaczania trasy lub obliczania wskazówek dojazdu zawsze spowoduje przypisanie punktu do najbliższej drogi. Może to nie być droga, która szybko lub bezpiecznie prowadzi do miejsca docelowego, ani nie musi znajdować się w pobliżu punktu dostępu do obiektu. Dodatkowo w przypadku geokodowania zwrotnego lokalizacji nie ma gwarancji, że zwrócony adres będzie zgodny z oryginalnym. |
|
Typ:
Array<string> Typy miejsc, do których odnosi się wynik geokodowania. Na przykład: ['locality', 'political'] . Pełną listę typów znajdziesz w dokumentacji interfejsu Geocoding API. |
|
Typ:
PlusCode optional Plus Code odpowiadający atrybutowi location . |
Metody | |
---|---|
|
fetchPlace() Parametry: brak
Zwracana wartość: brak
Zwraca reprezentację miejsca tego kodu geograficznego. Aby uzyskać pełne informacje o miejscu, należy wywołać funkcję place.fetchFields(). |
Stałe w przypadku szczegółowości
google.maps.addressValidation.Granularity
stałe
Różne poziomy szczegółowości, jakie może mieć adres lub geokod. Gdy te wartości są używane do określania szczegółowości adresu, wskazują, jak szczegółowo adres identyfikuje miejsce docelowe przesyłki. Na przykład adres „ul. Główna 123, Warszawa, 00-000” identyfikuje PREMISE
, a „Warszawa, 00-000” identyfikuje LOCALITY
. Jeśli jednak nie uda nam się znaleźć geokodu dla adresu „123 Main Street” w Redwood City, zwrócony geokod może mieć LOCALITY
, mimo że adres jest bardziej szczegółowy.
Dostęp przez połączenie pod numer const {Granularity} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
|
Adres lub geokod wskazuje blok. Używany tylko w regionach, w których stosuje się adresowanie na poziomie bloku, np. w Japonii. |
|
Pozostałe poziomy szczegółowości, które są grupowane, ponieważ nie można ich dostarczyć. |
|
Wynik na poziomie budynku. |
|
Geokod, który przybliża lokalizację adresu na poziomie budynku. |
|
Kod geograficzny lub adres jest szczegółowy w odniesieniu do trasy, np. ulicy, drogi lub autostrady. |
|
Wynik poniżej poziomu budynku, np. mieszkanie. |
USPSAddress class
google.maps.addressValidation.USPSAddress
zajęcia
Reprezentacja adresu w Stanach Zjednoczonych w formacie USPS.
Dostęp przez połączenie pod numer const {USPSAddress} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Właściwości | |
---|---|
|
Typ:
string optional Nazwa miasta. |
|
Typ:
string optional Wiersz adresu zawierający miasto, stan i kod pocztowy. |
|
Typ:
string optional Nazwa firmy. |
|
Typ:
string optional Pierwszy wiersz adresu. |
|
Typ:
string optional Drugi wiersz adresu. |
|
Typ:
string optional Dwuliterowy kod stanu. |
|
Typ:
string optional Nazwa urbanizacji w Portoryko. |
|
Typ:
string optional Kod pocztowy, np. „10009”. |
|
Typ:
string optional 4-cyfrowe rozszerzenie kodu pocztowego, np. „5023”. |
USPSData class
google.maps.addressValidation.USPSData
zajęcia
Dane USPS dotyczące adresu. Nie ma gwarancji, że w przypadku każdego adresu w Stanach Zjednoczonych lub Portoryko przesłanego do interfejsu Address Validation API pole USPSData będzie w pełni wypełnione. Jeśli używasz uspsData jako głównej części odpowiedzi, zalecamy zintegrowanie w niej pól adresu kopii zapasowej.
Dostęp przez połączenie pod numer const {USPSData} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Właściwości | |
---|---|
|
Typ:
string optional Skrócona nazwa miasta. |
|
Typ:
string optional Typ rekordu adresu, który pasuje do adresu wejściowego. |
|
Typ:
string optional Kod trasy przewoźnika. Czteroznakowy kod składający się z jednoliterowego prefiksu i trzycyfrowego oznaczenia trasy. |
|
Typ:
string optional Wskaźnik sortowania stawek trasy przewoźnika. |
|
Typ:
boolean Wskaźnik, że żądanie zostało przetworzone przez CASS. |
|
Typ:
string optional Nazwa hrabstwa. |
|
Typ:
string optional Cyfra kontrolna punktu dostawy. Ta liczba jest dodawana na końcu kodu kreskowego punktu dostawy w przypadku poczty skanowanej mechanicznie. Suma wszystkich cyfr w polach delivery_point_barcode, delivery_point_check_digit, postal code i ZIP+4 powinna być podzielna przez 10. |
|
Typ:
string optional 2-cyfrowy kod punktu dostawy. |
|
Typ:
string optional Wskazuje, czy adres należy do komercyjnej agencji odbioru poczty (CMRA) – prywatnej firmy odbierającej pocztę dla klientów. Zwraca pojedynczy znak. |
|
Typ:
string optional Możliwe wartości potwierdzenia DPV. Zwraca pojedynczy znak lub nie zwraca żadnej wartości. |
|
Typ:
string optional Flaga wskazuje adresy, pod którymi USPS nie może zapukać do drzwi, aby dostarczyć pocztę. Zwraca pojedynczy znak. |
|
Typ:
string optional Flaga oznacza, że poczta jest dostarczana do jednego pojemnika w danej lokalizacji. Zwraca pojedynczy znak. |
|
Typ:
string optional Wskazuje, że dla adresu jest ważny więcej niż jeden kod zwrotu DPV. Zwraca pojedynczy znak. |
|
Typ:
string optional Przypisy z weryfikacji punktu dostawy. W jednym ciągu znaków można połączyć kilka przypisów. |
|
Typ:
string optional Flaga wskazująca, że dostawa poczty nie jest realizowana codziennie. Zwraca pojedynczy znak. |
|
Typ:
number optional Liczba całkowita określająca dni, w których nie ma dostawy. Można go sprawdzić za pomocą flag bitowych: 0x40 – niedziela jest dniem bez dostawy, 0x20 – poniedziałek jest dniem bez dostawy, 0x10 – wtorek jest dniem bez dostawy, 0x08 – środa jest dniem bez dostawy, 0x04 – czwartek jest dniem bez dostawy, 0x02 – piątek jest dniem bez dostawy, 0x01 – sobota jest dniem bez dostawy. |
|
Typ:
string optional Flaga oznacza, że drzwi są dostępne, ale przesyłka nie zostanie pozostawiona ze względu na obawy dotyczące bezpieczeństwa. Zwraca pojedynczy znak. |
|
Typ:
string optional Wskazuje, czy adres jest adresem bez statystyk, czy adresem aktywnym. Adresy statystyczne to adresy, które nie są stale zajęte lub nie są obsługiwane przez USPS. Zwraca pojedynczy znak. |
|
Typ:
number optional Wskazuje typ NoStat. Zwraca kod przyczyny jako liczbę całkowitą. |
|
Typ:
string optional Wskazuje, że adres został dopasowany do rekordu PBSA. Zwraca pojedynczy znak. |
|
Typ:
string optional Wskazuje, że poczta nie jest dostarczana na adres ulicy. Zwraca pojedynczy znak. |
|
Typ:
string optional Wskazuje, czy adres jest pusty. Zwraca pojedynczy znak. |
|
Typ:
string optional Flaga kolejności rosnącej/malejącej eLOT (A/D). |
|
Typ:
string optional Numer ulepszonej linii podróży (eLOT). |
|
Typ:
string optional Komunikat o błędzie podczas pobierania danych USPS. To pole jest wypełniane, gdy przetwarzanie przez USPS jest zawieszone z powodu wykrycia sztucznie utworzonych adresów. |
|
Typ:
string optional Kod FIPS hrabstwa. |
|
Typ:
boolean Wskaźnik, że znaleziono adres domyślny, ale istnieją bardziej szczegółowe adresy. |
|
Typ:
boolean Adres dostawy można dopasować, ale plik EWS wskazuje, że dokładne dopasowanie będzie dostępne wkrótce. |
|
Typ:
string optional Wskaźnik LACSLink. |
|
Typ:
string optional Kod zwrotu LACSLink. |
|
Typ:
string optional Oznaczenie jednostki PMB (Private Mail Box). |
|
Typ:
string optional Numer PMB (Private Mail Box). |
|
Typ:
boolean Kod pocztowy tylko dla skrytki pocztowej. |
|
Typ:
string optional Miasto, w którym znajduje się główny urząd pocztowy. |
|
Typ:
string optional Stan głównego urzędu pocztowego. |
|
Typ:
USPSAddress optional Znormalizowany adres USPS. |
|
Typ:
string optional przypisy z dopasowania rekordu ulicy lub wieżowca do informacji o lokalu; Jeśli zostanie znalezione dopasowanie nazwy firmy, zwracany jest numer dodatkowy. |
Verdict class
google.maps.addressValidation.Verdict
zajęcia
Reprezentuje przetworzony adres podany przez użytkownika.
Dostęp przez połączenie pod numer const {Verdict} = await google.maps.importLibrary("addressValidation")
.
Zobacz Biblioteki w Maps JavaScript API.
Właściwości | |
---|---|
|
Typ:
boolean Adres jest uznawany za kompletny, jeśli nie zawiera nierozwiązanych tokenów ani nieoczekiwanych lub brakujących komponentów. Jeśli nie jest ustawiona, oznacza to, że wartość to false . Więcej informacji znajdziesz w polach , lub . |
|
Typ:
Granularity optional Informacje o szczegółowości Geocode . Można to rozumieć jako semantyczne znaczenie tego, jak przybliżona lub dokładna jest lokalizacja zakodowana geograficznie. |
|
Typ:
boolean Dodano co najmniej jeden element adresu, którego nie było w danych wejściowych. Więcej informacji znajdziesz w sekcji AddressComponent . |
|
Typ:
boolean optional Zastąpiono co najmniej 1 element adresu – szczegóły znajdziesz w AddressComponent . |
|
Typ:
boolean Nie można skategoryzować ani zweryfikować co najmniej 1 elementu adresu. Szczegółowe informacje znajdziesz w sekcji AddressComponent . |
|
Typ:
Granularity optional Szczegółowość adresu wejściowego. Jest to wynik analizy adresu wejściowego, który nie zawiera żadnych sygnałów weryfikacyjnych. Sygnały weryfikacji znajdziesz w sekcji validationGranularity . |
|
Typ:
Granularity optional Poziom szczegółowości, na którym interfejs API może w pełni zweryfikować adres. Na przykład validationGranularity o wartości PREMISE oznacza, że można zweryfikować wszystkie komponenty adresu na poziomie PREMISE i wyższym. |