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.

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

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

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

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

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

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

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.