Address Validation (beta)

AddressValidation class

google.maps.addressValidation.AddressValidation zajęcia

Uwaga: dostępna tylko na kanale v=beta.

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	fetchAddressValidation(request) Parametry:  request:  AddressValidationRequest Zwracana wartość:  Promise<AddressValidation> Sprawdza poprawność adresu. Zobacz https://developers.google.com/maps/documentation/javascript/address-validation/validate-address.

Właściwości
address	Typ:  Address optional Informacje o samym adresie, a nie o geokodzie.
geocode	Typ:  Geocode optional Informacje o lokalizacji i miejscu, do którego został przypisany adres.
metadata	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.
responseId	Typ:  string optional Identyfikator UUID tej odpowiedzi. Jeśli adres wymaga ponownej weryfikacji, do nowej prośby musi być dołączony ten identyfikator UUID.
uspsData	Typ:  USPSData optional Dodatkowe flagi dostarczalności udostępniane przez USPS. Dostępne tylko w regionach US i PR.
verdict	Typ:  Verdict optional Flagi ogólnej oceny

Metody
toJSON	toJSON() Parametry: brak Zwracana wartość:  Object Konwertuje klasę AddressValidation na obiekt JSON o tych samych właściwościach.

AddressValidationRequest interfejs

google.maps.addressValidation.AddressValidationRequestinterfejs

Uwaga: dostępna tylko na kanale v=beta.

Interfejs żądania dla AddressValidation.fetchAddressValidation.

Właściwości
address	Typ:  PostalAddressLiteral Adres jest weryfikowany. Nieformatowane adresy należy przesyłać za pomocą PostalAddress.addressLines.
placeAutocompleteElement optional	Typ:  PlaceAutocompleteElement optional Jeśli używasz elementu PlaceAutocompleteElement, umieść go tutaj, aby połączyć wywołania interfejsu Address Validation API z tokenem sesji autouzupełniania.
previousResponseId optional	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ść AddressValidation.responseId z pierwszej odpowiedzi w sekwencji weryfikacji.
sessionToken optional	Typ:  AutocompleteSessionToken optional Token identyfikujący sesję autouzupełniania na potrzeby rozliczeń.
uspsCASSEnabled optional	Typ:  boolean optional Włącza tryb zgodny z USPS CASS. Dotyczy to tylko pola AddressValidation.uspsData 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

Uwaga: dostępna tylko na kanale v=beta.

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
components	Typ:  Array<AddressComponent> Poszczególne komponenty sformatowanego i poprawionego adresu wraz z informacjami o weryfikacji. Zawiera informacje o stanie weryfikacji poszczególnych komponentów.
formattedAddress	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.
missingComponentTypes	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.
postalAddress	Typ:  PostalAddress optional Przetworzony adres w formie adresu pocztowego.
unconfirmedComponentTypes	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 AddressComponent.confirmationLevel nie jest równe ConfirmationLevel.CONFIRMED lub flaga AddressComponent.inferred nie jest ustawiona na true. Listę możliwych typów znajdziesz tutaj.
unresolvedTokens	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

Uwaga: dostępna tylko na kanale v=beta.

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
componentName	Typ:  string optional Tekst nazwy komponentu. Na przykład „5th Avenue” jako nazwa ulicy lub „1253” jako numer ulicy.
componentNameLanguageCode	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.
componentType	Typ:  string optional Typ komponentu adresu. Listę możliwych typów znajdziesz w tabeli 2: Dodatkowe typy zwracane przez usługę Miejsca.
confirmationLevel	Typ:  ConfirmationLevel optional Wskazuje poziom pewności, że komponent jest prawidłowy.
inferred	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.
replaced	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.
spellCorrected	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”.
unexpected	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

Uwaga: dostępna tylko na kanale v=beta.

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
business	Typ:  boolean
poBox	Typ:  boolean
residential	Typ:  boolean

ConfirmationLevel stałe

google.maps.addressValidation.ConfirmationLevel stałe

Uwaga: dostępna tylko na kanale v=beta.

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
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

Geocode class

google.maps.addressValidation.Geocode zajęcia

Uwaga: dostępna tylko na kanale v=beta.

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
bounds	Typ:  LatLngBounds optional Granice geokodowanego miejsca.
featureSizeMeters	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.
location	Typ:  LatLngAltitude optional Geokodowana lokalizacja danych wejściowych.
placeId	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.
placeTypes	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.
plusCode	Typ:  PlusCode optional Plus Code odpowiadający atrybutowi location.

Metody
fetchPlace	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

Uwaga: dostępna tylko na kanale v=beta.

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
BLOCK	Adres lub geokod wskazuje blok. Używany tylko w regionach, w których stosuje się adresowanie na poziomie bloku, np. w Japonii.
OTHER	Pozostałe poziomy szczegółowości, które są grupowane, ponieważ nie można ich dostarczyć.
PREMISE	Wynik na poziomie budynku.
PREMISE_PROXIMITY	Geokod, który przybliża lokalizację adresu na poziomie budynku.
ROUTE	Geokod lub adres jest szczegółowy w odniesieniu do trasy, np. ulicy, drogi lub autostrady.
SUB_PREMISE	Wynik na poziomie poniżej budynku, np. mieszkanie.

Stałe PossibleNextAction

google.maps.addressValidation.PossibleNextAction stałe

Uwaga: dostępna tylko na kanale v=beta.

Zawiera interpretacyjne podsumowanie odpowiedzi interfejsu API, które ma pomóc w określeniu potencjalnych działań do podjęcia. To pole jest wyliczane na podstawie innych pól w odpowiedzi interfejsu API i nie należy go traktować jako gwarancji dokładności adresu ani możliwości dostarczenia przesyłki.

Dostęp przez połączenie pod numer const {PossibleNextAction} = await google.maps.importLibrary("addressValidation").
 Zobacz Biblioteki w Maps JavaScript API.

Stałe
ACCEPT	Odpowiedź API nie zawiera sygnałów, które uzasadniałyby jedną z pozostałych wartości PossibleNextAction. Możesz użyć przetworzonego adresu bez dodatkowego pytania klienta, ale nie gwarantuje to, że adres jest prawidłowy i może nadal zawierać poprawki. To Ty musisz na podstawie własnej oceny ryzyka określić, czy i w jaki sposób poprosić klienta o potwierdzenie.
CONFIRM	Co najmniej jedno pole odpowiedzi interfejsu API wskazuje potencjalne drobne problemy z przetworzonym adresem, np. postal_code element adresu był replaced. Zachęcenie klienta do sprawdzenia adresu może pomóc w poprawie jego jakości.
CONFIRM_ADD_SUBPREMISES	Odpowiedź interfejsu API wskazuje, że w przetworzonym adresie może brakować podrzędnego lokalu. Zachęcenie klienta do sprawdzenia adresu i rozważenia dodania numeru lokalu może pomóc w poprawie jakości adresu. Adres po przetworzeniu może też mieć inne drobne problemy. Uwaga: ta wartość wyliczeniowa może być zwracana tylko w przypadku adresów w Stanach Zjednoczonych.
FIX	Co najmniej jedno pole odpowiedzi interfejsu API wskazuje potencjalny problem z przetworzonym adresem, np. verdict.validation_granularity ma wartość OTHER. Zachęcenie klienta do edycji adresu może pomóc w poprawie jego jakości.

USPSAddress class

google.maps.addressValidation.USPSAddress zajęcia

Uwaga: dostępna tylko na kanale v=beta.

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
city	Typ:  string optional Nazwa miasta.
cityStateZipAddressLine	Typ:  string optional Wiersz adresu zawierający miasto, stan i kod pocztowy.
firm	Typ:  string optional Nazwa firmy.
firstAddressLine	Typ:  string optional Pierwszy wiersz adresu.
secondAddressLine	Typ:  string optional Drugi wiersz adresu.
state	Typ:  string optional Dwuliterowy kod stanu.
urbanization	Typ:  string optional Nazwa urbanizacji w Portoryko.
zipCode	Typ:  string optional Kod pocztowy, np. „10009”.
zipCodeExtension	Typ:  string optional 4-cyfrowe rozszerzenie kodu pocztowego, np. „5023”.

USPSData class

google.maps.addressValidation.USPSData zajęcia

Uwaga: dostępna tylko na kanale v=beta.

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
abbreviatedCity	Typ:  string optional Skrócona nazwa miasta.
addressRecordType	Typ:  string optional Typ rekordu adresu, który pasuje do adresu wejściowego.
carrierRoute	Typ:  string optional Kod trasy przewoźnika. Czteroznakowy kod składający się z jednoliterowego prefiksu i trzycyfrowego oznaczenia trasy.
carrierRouteIndicator	Typ:  string optional Wskaźnik sortowania stawek trasy przewoźnika.
cassProcessed	Typ:  boolean Wskaźnik, że żądanie zostało przetworzone przez CASS.
county	Typ:  string optional Nazwa hrabstwa.
deliveryPointCheckDigit	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.
deliveryPointCode	Typ:  string optional 2-cyfrowy kod punktu dostawy.
dpvCMRA	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.
dpvConfirmation	Typ:  string optional Możliwe wartości potwierdzenia DPV. Zwraca pojedynczy znak lub nie zwraca żadnej wartości.
dpvDoorNotAccessible	Typ:  string optional Flaga wskazuje adresy, pod którymi USPS nie może zapukać do drzwi, aby dostarczyć pocztę. Zwraca pojedynczy znak.
dpvDrop	Typ:  string optional Flaga oznacza, że poczta jest dostarczana do jednego pojemnika w danej lokalizacji. Zwraca pojedynczy znak.
dpvEnhancedDeliveryCode	Typ:  string optional Wskazuje, że dla adresu jest ważny więcej niż jeden kod zwrotu DPV. Zwraca pojedynczy znak.
dpvFootnote	Typ:  string optional Przypisy z weryfikacji punktu dostawy. W jednym ciągu znaków można połączyć kilka przypisów.
dpvNonDeliveryDays	Typ:  string optional Flaga wskazująca, że dostawa poczty nie jest realizowana codziennie. Zwraca pojedynczy znak.
dpvNonDeliveryDaysValues	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.
dpvNoSecureLocation	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.
dpvNoStat	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.
dpvNoStatReasonCode	Typ:  number optional Wskazuje typ NoStat. Zwraca kod przyczyny jako liczbę całkowitą.
dpvPBSA	Typ:  string optional Wskazuje, że adres został dopasowany do rekordu PBSA. Zwraca pojedynczy znak.
dpvThrowback	Typ:  string optional Wskazuje, że poczta nie jest dostarczana na adres ulicy. Zwraca pojedynczy znak.
dpvVacant	Typ:  string optional Wskazuje, czy adres jest pusty. Zwraca pojedynczy znak.
elotFlag	Typ:  string optional Flaga kolejności rosnącej/malejącej eLOT (A/D).
elotNumber	Typ:  string optional Numer ulepszonej linii podróży (eLOT).
errorMessage	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.
fipsCountyCode	Typ:  string optional Kod FIPS hrabstwa.
hasDefaultAddress	Typ:  boolean Wskaźnik, że znaleziono adres domyślny, ale istnieją bardziej szczegółowe adresy.
hasNoEWSMatch	Typ:  boolean Adres dostawy można dopasować, ale plik EWS wskazuje, że dokładne dopasowanie będzie dostępne wkrótce.
lacsLinkIndicator	Typ:  string optional Wskaźnik LACSLink.
lacsLinkReturnCode	Typ:  string optional Kod zwrotu LACSLink.
pmbDesignator	Typ:  string optional Oznaczenie jednostki PMB (Private Mail Box).
pmbNumber	Typ:  string optional Numer PMB (Private Mail Box).
poBoxOnlyPostalCode	Typ:  boolean Kod pocztowy tylko dla skrytki pocztowej.
postOfficeCity	Typ:  string optional Miasto, w którym znajduje się główny urząd pocztowy.
postOfficeState	Typ:  string optional Stan głównego urzędu pocztowego.
standardizedAddress	Typ:  USPSAddress optional Znormalizowany adres USPS.
suiteLinkFootnote	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

Uwaga: dostępna tylko na kanale v=beta.

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
addressComplete	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 Address.missingComponentTypes, Address.unresolvedTokens lub AddressComponent.unexpected.
geocodeGranularity	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.
hasInferredComponents	Typ:  boolean Dodano co najmniej jeden element adresu, którego nie było w danych wejściowych. Więcej informacji znajdziesz w sekcji AddressComponent.
hasReplacedComponents	Typ:  boolean optional Zastąpiono co najmniej 1 element adresu – szczegóły znajdziesz w AddressComponent.
hasUnconfirmedComponents	Typ:  boolean Nie można skategoryzować ani zweryfikować co najmniej 1 elementu adresu. Szczegółowe informacje znajdziesz w sekcji AddressComponent.
inputGranularity	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.
possibleNextAction	Typ:  PossibleNextAction optional Możliwe kolejne działanie, które można wykonać na podstawie innych pól w odpowiedzi interfejsu API. Aby dowiedzieć się więcej, zobacz PossibleNextAction.
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.