Indeks
AddressValidation
(interfejs)Address
(komunikat)AddressComponent
(komunikat)AddressComponent.ConfirmationLevel
(wyliczenie)AddressMetadata
(komunikat)ComponentName
(komunikat)Geocode
(komunikat)LanguageOptions
(komunikat)PlusCode
(komunikat)ProvideValidationFeedbackRequest
(komunikat)ProvideValidationFeedbackRequest.ValidationConclusion
(wyliczenie)ProvideValidationFeedbackResponse
(komunikat)UspsAddress
(komunikat)UspsData
(komunikat)ValidateAddressRequest
(komunikat)ValidateAddressResponse
(komunikat)ValidationResult
(komunikat)Verdict
(komunikat)Verdict.Granularity
(wyliczenie)
AddressValidation
Usługa do weryfikowania adresów.
ProvideValidationFeedback |
---|
Opinia o wynikach sekwencji prób weryfikacji. Powinno to być ostatnie wywołanie po serii wywołań weryfikacyjnych dotyczących tego samego adresu. Należy je wywołać po zakończeniu transakcji. Należy go wysłać tylko raz w przypadku sekwencji |
ValidateAddress |
---|
Weryfikuje adres. |
Adres
Szczegóły przetworzonego adresu. Proces końcowy obejmuje poprawienie błędnie zapisanych części adresu, zastąpienie nieprawidłowych części i wykrycie brakujących części.
Pola | |
---|---|
formatted_address |
Przetworzony adres w postaci adresu jednowierszowego zgodny z regułami formatowania adresu obowiązującymi w regionie, w którym znajduje się adres. |
postal_address |
Adres po przetworzeniu danych, który jest widoczny jako adres pocztowy. |
address_components[] |
Lista nieuporządkowana. Poszczególne składniki adresu sformatowanego i poprawionego adresu wraz z informacjami weryfikacyjnymi. Znajdziesz tam informacje o stanie weryfikacji poszczególnych komponentów. Komponenty adresu nie są uporządkowane w określony sposób. Nie zakładaj w żaden sposób kolejności komponentów adresu na liście. |
missing_component_types[] |
Typy komponentów, które powinny znajdować się w poprawnie sformatowanym adresie pocztowym, ale nie znaleziono w danych wejściowych ORAZ nie można wywnioskować. Komponenty tego typu nie występują w elementach |
unconfirmed_component_types[] |
Typy komponentów obecnych w polu |
unresolved_tokens[] |
Wszystkie wpisane dane wejściowe, których nie udało się rozpoznać. Mogą to być dane, które nie zostały rozpoznane jako prawidłowa część adresu (np. w danych takich jak „ul. Główna 123235253253, San Francisco, CA, 94105”, nierozstrzygnięte tokeny mogą wyglądać tak: |
AddressComponent
Reprezentuje komponent adresu, na przykład ulicę, miasto lub stan.
Pola | |
---|---|
component_name |
Nazwa tego komponentu. |
component_type |
Typ komponentu adresu. Listę możliwych typów znajdziesz w tabeli 2. Dodatkowe typy zwracanych przez usługę Miejsca. |
confirmation_level |
Wskazuje poziom pewności, że komponent jest prawidłowy. |
inferred |
Wskazuje, że komponent nie był częścią danych, ale wywnioskowaliśmy go dla lokalizacji adresu i uważamy, że należy go podać, aby podać pełny adres. |
spell_corrected |
Wskazuje poprawkę błędu pisowni w nazwie komponentu. Interfejs API nie zawsze oznacza zmiany między wariantami pisowni, np. przy zmianie słowa „w środku” na „wyśrodkowany”. Nie zawsze oznacza też typowe błędy w pisowni, na przykład gdy zmieniasz nazwę „Pałac Kultury i Nauki” na „Pałac Kultury i Nauki”. |
replaced |
wskazuje, że nazwa komponentu została zastąpiona całkowicie inną nazwą (np. nieprawidłowy kod pocztowy został zastąpiony prawidłowym kodem adresu). Nie jest to tylko kosmetyczna zmiana, ponieważ komponent danych wejściowych został zmieniony na inny. |
unexpected |
Wskazuje składnik adresu, który nie powinien występować w adresie pocztowym dla danego regionu. Zachowajmy je tylko dlatego, że były częścią danych wejściowych. |
ConfirmationLevel
Różne możliwe wartości poziomów potwierdzenia.
Wartości w polu enum | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
Wartość domyślna. Ta wartość nie jest używana. |
CONFIRMED |
Udało nam się ustalić, czy ten komponent istnieje i czy ma sens w kontekście reszty adresu. |
UNCONFIRMED_BUT_PLAUSIBLE |
Nie udało się potwierdzić tego komponentu, ale prawdopodobnie istnieje. Może to być na przykład numer budynku ze znanego zakresu numerów na ulicy, dla której nie są znane konkretne numery domów. |
UNCONFIRMED_AND_SUSPICIOUS |
Ten komponent nie został potwierdzony i prawdopodobnie jest nieprawidłowy. Może to być na przykład dzielnica, która nie pasuje do reszty adresu. |
AddressMetadata
Metadane adresu. Nie ma gwarancji, że pole metadata
będzie w pełni wypełnione dla każdego adresu przesłanego do interfejsu Address Review API.
Pola | |
---|---|
business |
Wskazuje, że jest to adres firmy. Jeśli nie jest skonfigurowana, wskazuje, że wartość jest nieznana. |
po_box |
Wskazuje, że adres skrytki pocztowej. Jeśli nie jest skonfigurowana, wskazuje, że wartość jest nieznana. |
residential |
Wskazuje, że jest to adres miejsca zamieszkania. Jeśli nie jest skonfigurowana, wskazuje, że wartość jest nieznana. |
ComponentName
Kod nazwy komponentu.
Pola | |
---|---|
text |
Tekst nazwy. Na przykład „Piąta Aleja” dla nazwy ulicy lub „1253” dla numeru budynku. |
language_code |
Kod języka BCP-47. Ten atrybut nie będzie dostępny, jeśli nazwa komponentu nie jest powiązana z językiem, np. z numerem domu. |
Geokod
Zawiera informacje o miejscu, do którego dane wejściowe zostały przetworzone geokodem.
Pola | |
---|---|
location |
Geokodowana lokalizacja danych wejściowych. Używanie identyfikatorów miejsc jest preferowane zamiast używania adresów, współrzędnych szerokości i długości geograficznej lub kodów plus. Korzystanie ze współrzędnych podczas wyznaczanie trasy lub obliczanie trasy dojazdu zawsze powoduje przyciągnięcie punktu do drogi znajdującej się najbliżej tych współrzędnych. Nie może to być droga, która szybko lub bezpiecznie prowadzi do celu i nie może znajdować się w pobliżu punktu dostępu do posesji. Ponadto, gdy lokalizacja jest poddawana odwrotnym geokodowi, nie ma gwarancji, że zwrócony adres jest zgodny z pierwotnym adresem. |
plus_code |
Kod plus odpowiadający kontu |
bounds |
Granice miejsca geokodowanego. |
feature_size_meters |
Wielkość miejsca geokodowanego (w metrach). Jest to kolejna miara przybliżenia geokodowanej lokalizacji, ale jej rozmiaru fizycznego, a nie semantycznego. |
place_id |
Identyfikator miejsca miejsca, do którego dane geograficzne są przesyłane. Więcej informacji na temat identyfikatorów miejsc znajdziesz tutaj. |
place_types[] |
Typy miejsc, na które dane wejściowe zostały przekształcone geograficznie. Na przykład: |
LanguageOptions
Podgląd: ta funkcja jest w wersji testowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte Szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.
Włącza interfejs Address Billingation API, aby uwzględnić w odpowiedzi dodatkowe informacje.
Pola | |
---|---|
return_english_latin_address |
Podgląd: zwróć urządzenie |
PlusCode
Plus Code (http://plus.codes) to odniesienie do lokalizacji w dwóch formatach: globalny kod definiujący wymiary 14 m x 14 m (1/8000 stopnia) lub mniejszy prostokąt oraz kod złożony, zastępując prefiks adresem referencyjnym.
Pola | |
---|---|
global_code |
Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, który reprezentuje obszar o wymiarach 1/8000 x 1/8000 stopnia (ok. 14 x 14 metrów). |
compound_code |
Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, który zawiera sufiks kodu globalnego i zastępuje prefiks sformatowaną nazwą jednostki referencyjnej. |
ProvideValidationFeedbackRequest
Prośba o przesłanie opinii weryfikacyjnej.
Pola | |
---|---|
conclusion |
To pole jest wymagane. Rezultat sekwencji prób weryfikacji. Jeśli pole ma wartość |
response_id |
To pole jest wymagane. Identyfikator odpowiedzi, której dotyczy ta opinia. Powinien to być parametr [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id], który pochodzi z pierwszej odpowiedzi z serii prób weryfikacji adresu. |
ValidationConclusion
Możliwe wyniki końcowe sekwencji żądań weryfikacji adresu potrzebnych do zweryfikowania adresu.
Wartości w polu enum | |
---|---|
VALIDATION_CONCLUSION_UNSPECIFIED |
Ta wartość nie jest używana. Jeśli pole ProvideValidationFeedbackRequest.conclusion ma wartość VALIDATION_CONCLUSION_UNSPECIFIED , zwracany jest błąd INVALID_ARGUMENT . |
VALIDATED_VERSION_USED |
Transakcja została użyta przy użyciu wersji adresu zwróconej przez interfejs Address Verificationation API. |
USER_VERSION_USED |
Wersja adresu podana przez użytkownika została użyta do zrealizowania transakcji |
UNVALIDATED_VERSION_USED |
W transakcji została użyta wersja adresu, która została podana po ostatniej próbie weryfikacji, ale nie została ponownie zweryfikowana. |
UNUSED |
Transakcja została porzucona, a adres nie został użyty. |
ProvideValidationFeedbackResponse
Ten typ nie ma żadnych pól.
Odpowiedź na opinię dotyczącą weryfikacji.
Jeśli opinia została wysłana, odpowiedź będzie pusta.
UspsAddress
Reprezentacja adresu w Stanach Zjednoczonych przez USPS.
Pola | |
---|---|
first_address_line |
Pierwszy wiersz adresu. |
firm |
Nazwa firmy. |
second_address_line |
Drugi wiersz adresu. |
urbanization |
Portorykańska nazwa urbanizacji. |
city_state_zip_address_line |
Miasto + województwo + kod pocztowy. |
city |
Nazwa miasta. |
state |
Dwuliterowy kod stanu. |
zip_code |
Kod pocztowy, np. 10009. |
zip_code_extension |
4-cyfrowe rozszerzenie kodu pocztowego, np. 5023. |
UspsData
Dane USPS dotyczące adresu. Nie możemy zagwarantować, że pole uspsData
będzie w pełni wypełnione dla każdego adresu w USA lub instytucji PR wysyłanego przez interfejs Address Verificationation API. Jeśli w odpowiedzi używasz pola uspsData, zalecamy zintegrowanie w odpowiedzi pól zapasowego adresu.
Pola | |
---|---|
standardized_address |
Ujednolicony adres USPS. |
delivery_point_code |
2-cyfrowy kod punktu dostawy |
delivery_point_check_digit |
Cyfra kontrolna punktu dostawy. Ten numer jest dodawany na końcu kodu delivery_point_barcode w przypadku e-maili zeskanowanych mechanicznie. Dodanie do siebie wszystkich cyfr parametru „delivery_point_barcode”, „delivery_point_check_digit” i „zip+4” powinno dać liczbę podzieloną przez 10. |
dpv_confirmation |
Możliwe wartości potwierdzenia DPV. Zwraca pojedynczy znak lub nie zwraca żadnej wartości.
|
dpv_footnote |
Przypisy z weryfikacji punktu dostawy. W jednym ciągu może być połączonych wiele przypisów.
|
dpv_cmra |
Wskazuje, czy adres to CMRA (Commercial Mail Delivery Agency) – prywatna firma odbierająca pocztę w imieniu klientów. Zwraca pojedynczy znak.
|
dpv_vacant |
Czy to miejsce jest puste? Zwraca pojedynczy znak.
|
dpv_no_stat |
Czy jest to adres niedostępny w statystykach czy adres aktywny? Brak adresów statystycznych to adresy, na których nikt nie jest stale zajęty, lub adresy, których USPS nie obsługuje. Zwraca pojedynczy znak.
|
dpv_no_stat_reason_code |
Wskazuje typ NoStat. Zwraca kod przyczyny jako int.
|
dpv_drop |
Flaga oznacza, że e-mail jest dostarczany do określonego odbiorcy w witrynie. Zwraca pojedynczy znak.
|
dpv_throwback |
Wskazuje, że poczta nie jest dostarczana na adres. Zwraca pojedynczy znak.
|
dpv_non_delivery_days |
Oznaczenie flagą oznacza, że poczta nie jest dostarczana codziennie. Zwraca pojedynczy znak.
|
dpv_non_delivery_days_values |
Liczba całkowita określająca dni, w których dostawa nie jest realizowana. Można go przesłuchać za pomocą flag: 0x40 – niedziela jest dniem niedostawy 0x20 – poniedziałek jest dniem niedostawy 0x10 – wtorek oznacza dzień niedostawy 0x08 – środa oznacza dzień niedostawy 0x04 – czwartek jest dniem niedoręczenia 0x02 – piątek to dzień niedostawy 0x02 |
dpv_no_secure_location |
Flaga oznacza, że drzwi są dostępne, ale ze względów bezpieczeństwa przesyłka nie zostanie pozostawiona. Zwraca pojedynczy znak.
|
dpv_pbsa |
Wskazuje, że adres został dopasowany do rekordu PBSA. Zwraca pojedynczy znak.
|
dpv_door_not_accessible |
Flaga wskazuje adresy, pod którymi USPS nie może zapukać do dostarczenia poczty. Zwraca pojedynczy znak.
|
dpv_enhanced_delivery_code |
Wskazuje, że dla danego adresu prawidłowy jest więcej niż 1 kod zwrotu DPV. Zwraca pojedynczy znak.
|
carrier_route |
Kod trasy przewoźnika. Czteroznakowy kod składający się z jednoliterowego prefiksu i 3-cyfrowego oznaczenia trasy. Prefiksy:
|
carrier_route_indicator |
Wskaźnik sortowania szybkości trasy przewoźnika. |
ews_no_match |
Adres dostawy można dopasować, ale plik EWS wskazuje, że wkrótce będzie dostępne dopasowanie ścisłe. |
post_office_city |
Główny urząd pocztowy. |
post_office_state |
Główny stan urzędu pocztowego. |
abbreviated_city |
Skrócona nazwa miasta. |
fips_county_code |
Kod kraju FIPS. |
county |
Nazwa hrabstwa. |
elot_number |
Numer eLOT (ELOT). |
elot_flag |
eLOT rosnąco/malejąco (A/D). |
lacs_link_return_code |
Kod zwrotny LACSLink. |
lacs_link_indicator |
Wskaźnik LACSLink. |
po_box_only_postal_code |
Kod pocztowy obejmujący tylko skrytkę pocztową. |
suitelink_footnote |
Przypisy od pasującego rekordu ulicy lub wieżowca do informacji o budynku. Jeśli nazwa firmy zostanie znaleziona, zostanie zwrócony numer dodatkowy.
|
pmb_designator |
Oznaczenie jednostki PMB (Private Mail Box). |
pmb_number |
numer PMB (Private Mail Box); |
address_record_type |
Typ rekordu adresu pasującego do wpisanego adresu.
|
default_address |
Wskaźnik informujący, że został znaleziony adres domyślny, ale istnieją bardziej szczegółowe adresy. |
error_message |
Komunikat o błędzie pobierania danych przez USPS. Ta wartość jest wypełniana, gdy przetwarzanie USPS zostaje zawieszone z powodu wykrywania sztucznie utworzonych adresów. Gdy występuje ten błąd, pola danych USPS mogą nie być wypełnione. |
cass_processed |
Wskaźnik, że żądanie zostało przetworzone CASS. |
ValidateAddressRequest
Żądanie weryfikacji adresu.
Pola | |
---|---|
address |
To pole jest wymagane. Sprawdzany adres. Niesformatowane adresy należy przesyłać za pomocą parametru Całkowita długość pól w tych danych nie może przekraczać 280 znaków. Listę obsługiwanych regionów znajdziesz tutaj. Wartość Interfejs Address Verification API ignoruje wartości w |
previous_response_id |
To pole musi być puste w przypadku pierwszego żądania weryfikacji adresu. Jeśli do pełnej weryfikacji pojedynczego adresu potrzeba więcej żądań (np. zmiany wprowadzane przez użytkownika po pierwszej weryfikacji muszą być ponownie zweryfikowane), każde kolejne żądanie musi wypełnić to pole wartością |
enable_usps_cass |
Włącza tryb zgodności USPS CASS. Ma to wpływ tylko na pole Zalecamy użycie komponentu |
language_options |
Opcjonalnie. Podgląd: ta funkcja jest w wersji testowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte Szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania. Włącza interfejs Address Billingation API, aby uwzględnić w odpowiedzi dodatkowe informacje. |
session_token |
Opcjonalnie. Ciąg znaków, który identyfikuje sesję autouzupełniania na potrzeby rozliczeń. Musi to być bezpieczny adres URL i bezpieczny dla nazwy pliku ciąg base64 o długości nie większej niż 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT. Sesja zaczyna się, gdy użytkownik wpisze zapytanie autouzupełniania, a kończy się, gdy wybierze miejsce i prześle żądanie informacji o miejscu lub weryfikacji adresu. Każda sesja może zawierać kilka zapytań autouzupełniania, po których następuje 1 prośba o informacje o miejscu lub o weryfikację adresu. Dane logowania używane w przypadku każdego żądania w ramach sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token traci ważność. Aplikacja musi generować nowy token dla każdej sesji. Jeśli parametr Uwaga: sprawdzania adresu można używać tylko w sesjach z interfejsem Autocomplete (New) API, a nie z interfejsem Autocomplete API. Więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/session-pricing. |
ValidateAddressResponse
Odpowiedź na żądanie weryfikacji adresu.
Pola | |
---|---|
result |
Wynik weryfikacji adresu. |
response_id |
Identyfikator UUID, który identyfikuje tę odpowiedź. Jeśli adres wymaga ponownej weryfikacji, ten identyfikator UUID musi dołączyć do nowego żądania. |
ValidationResult
Wynik weryfikacji adresu.
Pola | |
---|---|
verdict |
Flagi oceny ogólnej |
address |
Informacje o adresie, a nie o geokodzie. |
geocode |
Informacje o lokalizacji i miejscu, do którego został przekodowany adres. |
metadata |
Inne informacje istotne z punktu widzenia dostawy. Nie ma gwarancji, że pole |
usps_data |
Dodatkowe oznaczenia dotyczące dostawy są dostarczane przez USPS. Podano tylko w regionach |
english_latin_address |
Podgląd: ta funkcja jest w wersji testowej (przed GA). Usługi i funkcje przed GA mogą mieć ograniczoną obsługę, a zmiany w takich usługach mogą być niezgodne z ich innymi wersjami. Oferty przed GA są objęte Szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania. Adres przetłumaczony na język angielski. Przetłumaczonych adresów nie można wykorzystywać ponownie jako danych wejściowych przez interfejs API. Usługa zapewnia taką możliwość, dzięki czemu użytkownik może użyć swojego języka ojczystego do potwierdzenia lub odrzucenia pierwotnie podanego adresu. Jeśli część adresu nie ma tłumaczenia na język angielski, usługa zwraca tę część w języku alternatywnym z alfabetem łacińskim. Informacje o sposobie wyboru języka alternatywnego znajdziesz tutaj. Jeśli część adresu nie ma żadnych tłumaczeń ani transliteracji w języku korzystającym z alfabetu łacińskiego, usługa zwraca tę część w lokalnym języku powiązanym z adresem. Włącz te dane wyjściowe za pomocą flagi Uwaga: pole |
Wynik
Ogólny przegląd wyniku weryfikacji adresu i kodu geograficznego.
Pola | |
---|---|
input_granularity |
szczegółowość adresu wejściowego, Jest to wynik analizy adresu wejściowego i nie przekazuje żadnych sygnałów weryfikacyjnych. Sygnały weryfikacyjne znajdziesz w sekcji Jeśli na przykład podany adres zawiera konkretny numer mieszkania, w polu |
validation_granularity |
Poziom szczegółowości, na którym interfejs API może w pełni validate adres. Na przykład wartość Wynik weryfikacji komponentu według adresu można znaleźć w pliku |
geocode_granularity |
Informacje o szczegółowości Czasem może się różnić od wartości |
address_complete |
Adres jest uważany za kompletny, jeśli nie ma nierozwiązanych tokenów ani nieoczekiwanych lub brakujących komponentów adresu. Jeśli wartość nie jest skonfigurowana, wskazuje, że wartość to |
has_unconfirmed_components |
Co najmniej 1 komponentu adresu nie można skategoryzować ani zweryfikować. Więcej informacji znajdziesz na stronie |
has_inferred_components |
Wywnioskowano (dodano) co najmniej 1 komponent adresu, którego nie było w danych wejściowych. Szczegółowe informacje znajdziesz na stronie |
has_replaced_components |
Zastąpiono co najmniej jeden komponent adresu. Szczegółowe informacje znajdziesz na stronie |
Szczegółowość
Różne poziomy szczegółowości adresu lub geokodu. Wartości te użyte do określenia szczegółowości adresu wskazują poziom szczegółowości adresu miejsca docelowego poczty. Na przykład adres „123 Main Street, Redwood City, CA, 94061” identyfikuje PREMISE
, a „Redwood City, CA, 94061” identyfikuje LOCALITY
. Jeśli jednak nie uda nam się znaleźć geokodu dla ulicy „Ulica Główna 123” w Warszawie, zwrócony geokod może mieć poziom szczegółowości LOCALITY
, mimo że adres jest bardziej szczegółowy.
Wartości w polu enum | |
---|---|
GRANULARITY_UNSPECIFIED |
Wartość domyślna. Ta wartość nie jest używana. |
SUB_PREMISE |
Wynik poniżej poziomu budynku, na przykład mieszkania. |
PREMISE |
Wynik na poziomie budynku. |
PREMISE_PROXIMITY |
Geokod określający lokalizację adresu na poziomie budynku. |
BLOCK |
Adres lub geokod wskazuje blok. Używany tylko w regionach z adresowaniem na poziomie blokowym, np. w Japonii. |
ROUTE |
Geokod lub adres są bardzo szczegółowe, np. obejmuje ulicę, drogę lub autostradę. |
OTHER |
Wszystkie inne szczegóły, które są grupowane, ponieważ są niemożliwe do przesłania. |