Address Validation (beta)

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

Interfejs żądania dla AddressValidation.fetchAddressValidation.
address
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

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.
components
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

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.
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

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.
business
Typ:  boolean
poBox
Typ:  boolean
residential
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.
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

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.
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.
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

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.
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

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.
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

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.
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

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.
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

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.
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.