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.

BetafetchAddressValidation
fetchAddressValidation(request)
Parametry: 
Zwracana wartość:  Promise<AddressValidation>
Betaaddress
Typ:  Address optional
Informacje o samym adresie, a nie o geokodzie.
Betageocode
Typ:  Geocode optional
Informacje o lokalizacji i miejscu, do którego został przypisany adres.
Betametadata
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.
BetaresponseId
Typ:  string optional
Identyfikator UUID tej odpowiedzi. Jeśli adres wymaga ponownej weryfikacji, do nowej prośby musi być dołączony ten identyfikator UUID.
BetauspsData
Typ:  USPSData optional
Dodatkowe flagi dostarczalności udostępniane przez USPS. Dostępne tylko w regionach USPR.
Betaverdict
Typ:  Verdict optional
Flagi ogólnej oceny
BetatoJSON
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 BetaAddressValidation.fetchAddressValidation.

Betaaddress
Adres jest weryfikowany. Nieformatowane adresy należy przesyłać za pomocą PostalAddress.addressLines.
BetapreviousResponseId 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ść BetaAddressValidation.responseId z pierwszej odpowiedzi w sekwencji weryfikacji.
BetauspsCASSEnabled optional
Typ:  boolean optional
Włącza tryb zgodny z USPS CASS. Dotyczy to tylko pola BetaAddressValidation.uspsDataAddressValidation. 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.

Betacomponents
Poszczególne komponenty sformatowanego i poprawionego adresu wraz z informacjami o weryfikacji. Zawiera informacje o stanie weryfikacji poszczególnych komponentów.
BetaformattedAddress
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.
BetamissingComponentTypes
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_addressaddress_components. Na przykład ['street_number', 'route'] w przypadku danych wejściowych „Boulder, Colorado, 80301, USA”. Listę możliwych typów znajdziesz tutaj.
BetapostalAddress
Typ:  PostalAddress optional
Przetworzony adres w formie adresu pocztowego.
BetaunconfirmedComponentTypes
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 BetaAddressComponent.confirmationLevel nie jest równe BetaConfirmationLevel.CONFIRMED lub flaga BetaAddressComponent.inferred nie jest ustawiona na true. Listę możliwych typów znajdziesz tutaj.
BetaunresolvedTokens
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.

BetacomponentName
Typ:  string optional
Tekst nazwy komponentu. Na przykład „5th Avenue” jako nazwa ulicy lub „1253” jako numer ulicy.
BetacomponentNameLanguageCode
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.
BetacomponentType
Typ:  string optional
Typ komponentu adresu. Listę możliwych typów znajdziesz w tabeli 2: Dodatkowe typy zwracane przez usługę Miejsca.
BetaconfirmationLevel
Typ:  ConfirmationLevel optional
Wskazuje poziom pewności, że komponent jest prawidłowy.
Betainferred
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.
Betareplaced
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.
BetaspellCorrected
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”.
Betaunexpected
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.

Betabusiness
Typ:  boolean
BetapoBox
Typ:  boolean
Betaresidential
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.

BetaCONFIRMED
BetaUNCONFIRMED_AND_SUSPICIOUS
BetaUNCONFIRMED_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.

Betabounds
Typ:  LatLngBounds optional
Granice geokodowanego miejsca.
BetafeatureSizeMeters
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.
Betalocation
Typ:  LatLngAltitude optional
Geokodowana lokalizacja danych wejściowych.
BetaplaceId
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.
BetaplaceTypes
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.
BetaplusCode
Typ:  PlusCode optional
Plus Code odpowiadający atrybutowi location.
BetafetchPlace
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.

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

Betacity
Typ:  string optional
Nazwa miasta.
BetacityStateZipAddressLine
Typ:  string optional
Wiersz adresu zawierający miasto, stan i kod pocztowy.
Betafirm
Typ:  string optional
Nazwa firmy.
BetafirstAddressLine
Typ:  string optional
Pierwszy wiersz adresu.
BetasecondAddressLine
Typ:  string optional
Drugi wiersz adresu.
Betastate
Typ:  string optional
Dwuliterowy kod stanu.
Betaurbanization
Typ:  string optional
Nazwa urbanizacji w Portoryko.
BetazipCode
Typ:  string optional
Kod pocztowy, np. „10009”.
BetazipCodeExtension
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.

BetaabbreviatedCity
Typ:  string optional
Skrócona nazwa miasta.
BetaaddressRecordType
Typ:  string optional
Typ rekordu adresu, który pasuje do adresu wejściowego.
BetacarrierRoute
Typ:  string optional
Kod trasy przewoźnika. Czteroznakowy kod składający się z jednoliterowego prefiksu i trzycyfrowego oznaczenia trasy.
BetacarrierRouteIndicator
Typ:  string optional
Wskaźnik sortowania stawek trasy przewoźnika.
BetacassProcessed
Typ:  boolean
Wskaźnik, że żądanie zostało przetworzone przez CASS.
Betacounty
Typ:  string optional
Nazwa hrabstwa.
BetadeliveryPointCheckDigit
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.
BetadeliveryPointCode
Typ:  string optional
2-cyfrowy kod punktu dostawy.
BetadpvCMRA
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.
BetadpvConfirmation
Typ:  string optional
Możliwe wartości potwierdzenia DPV. Zwraca pojedynczy znak lub nie zwraca żadnej wartości.
BetadpvDoorNotAccessible
Typ:  string optional
Flaga wskazuje adresy, pod którymi USPS nie może zapukać do drzwi, aby dostarczyć pocztę. Zwraca pojedynczy znak.
BetadpvDrop
Typ:  string optional
Flaga oznacza, że poczta jest dostarczana do jednego pojemnika w danej lokalizacji. Zwraca pojedynczy znak.
BetadpvEnhancedDeliveryCode
Typ:  string optional
Wskazuje, że dla adresu jest ważny więcej niż jeden kod zwrotu DPV. Zwraca pojedynczy znak.
BetadpvFootnote
Typ:  string optional
Przypisy z weryfikacji punktu dostawy. W jednym ciągu znaków można połączyć kilka przypisów.
BetadpvNonDeliveryDays
Typ:  string optional
Flaga wskazująca, że dostawa poczty nie jest realizowana codziennie. Zwraca pojedynczy znak.
BetadpvNonDeliveryDaysValues
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.
BetadpvNoSecureLocation
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.
BetadpvNoStat
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.
BetadpvNoStatReasonCode
Typ:  number optional
Wskazuje typ NoStat. Zwraca kod przyczyny jako liczbę całkowitą.
BetadpvPBSA
Typ:  string optional
Wskazuje, że adres został dopasowany do rekordu PBSA. Zwraca pojedynczy znak.
BetadpvThrowback
Typ:  string optional
Wskazuje, że poczta nie jest dostarczana na adres ulicy. Zwraca pojedynczy znak.
BetadpvVacant
Typ:  string optional
Wskazuje, czy adres jest pusty. Zwraca pojedynczy znak.
BetaelotFlag
Typ:  string optional
Flaga kolejności rosnącej/malejącej eLOT (A/D).
BetaelotNumber
Typ:  string optional
Numer ulepszonej linii podróży (eLOT).
BetaerrorMessage
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.
BetafipsCountyCode
Typ:  string optional
Kod FIPS hrabstwa.
BetahasDefaultAddress
Typ:  boolean
Wskaźnik, że znaleziono adres domyślny, ale istnieją bardziej szczegółowe adresy.
BetahasNoEWSMatch
Typ:  boolean
Adres dostawy można dopasować, ale plik EWS wskazuje, że dokładne dopasowanie będzie dostępne wkrótce.
BetalacsLinkIndicator
Typ:  string optional
Wskaźnik LACSLink.
BetalacsLinkReturnCode
Typ:  string optional
Kod zwrotu LACSLink.
BetapmbDesignator
Typ:  string optional
Oznaczenie jednostki PMB (Private Mail Box).
BetapmbNumber
Typ:  string optional
Numer PMB (Private Mail Box).
BetapoBoxOnlyPostalCode
Typ:  boolean
Kod pocztowy tylko dla skrytki pocztowej.
BetapostOfficeCity
Typ:  string optional
Miasto, w którym znajduje się główny urząd pocztowy.
BetapostOfficeState
Typ:  string optional
Stan głównego urzędu pocztowego.
BetastandardizedAddress
Typ:  USPSAddress optional
Znormalizowany adres USPS.
BetasuiteLinkFootnote
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.

BetaaddressComplete
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 BetaAddress.missingComponentTypes, BetaAddress.unresolvedTokens lub BetaAddressComponent.unexpected.
BetageocodeGranularity
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.
BetahasInferredComponents
Typ:  boolean
Dodano co najmniej jeden element adresu, którego nie było w danych wejściowych. Więcej informacji znajdziesz w sekcji AddressComponent.
BetahasReplacedComponents
Typ:  boolean optional
Zastąpiono co najmniej 1 element adresu – szczegóły znajdziesz w AddressComponent.
BetahasUnconfirmedComponents
Typ:  boolean
Nie można skategoryzować ani zweryfikować co najmniej 1 elementu adresu. Szczegółowe informacje znajdziesz w sekcji AddressComponent.
BetainputGranularity
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.
BetavalidationGranularity
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.