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 weryfikacji adresów.
ProvideValidationFeedback |
---|
Opinia na temat wyniku sekwencji prób weryfikacji. Powinno to być ostatnie wywołanie po serii wywołań weryfikacji dla tego samego adresu. Powinno być ono wywoływane po zakończeniu transakcji. Należy je wysłać tylko raz w przypadku sekwencji żądań |
ValidateAddress |
---|
Weryfikuje adres. |
Adres
Szczegóły przetworzonych adresów. Proces ten obejmuje poprawianie błędnie napisanych części adresu, wymianę nieprawidłowych części oraz ustalanie brakujących części.
Pola | |
---|---|
formatted_address |
Przetworzony adres w formacie jednowierszowym zgodnie z regułami formatowania adresu obowiązującymi w regionie, w którym się znajduje. |
postal_address |
Adres pocztowy do przetworzenia po przetworzeniu. |
address_components[] |
Lista nieuporządkowana. Pojedyncze składniki sformatowanego i poprawionego adresu wraz z informacjami dotyczącymi weryfikacji. Znajdziesz tu informacje o stanie weryfikacji poszczególnych komponentów. Komponenty adresu nie są uporządkowane w określony sposób. Nie przyjmij żadnych założeń dotyczących kolejności komponentów adresu na liście. |
missing_component_types[] |
Typy komponentów, które powinny znajdować się w prawidłowo sformatowanym adresie pocztowym, ale nie zostały znalezione w danych wejściowych ORAZ nie można ich określić. Komponenty tego typu nie występują w środowiskach |
unconfirmed_component_types[] |
Typy komponentów, które występują w polu |
unresolved_tokens[] |
Wszystkie tokeny w danych wejściowych, których nie udało się znaleźć. Może to być wartość, która nie została rozpoznana jako prawidłowa część adresu. Na przykład w przypadku danych wejściowych takich jak „123235253253 Main St, San Francisco, CA, 94105”, nierozpoznane tokeny mogą wyglądać jak |
AddressComponent
Reprezentuje komponent adresu, np. ulicę, miasto lub województwo.
Pola | |
---|---|
component_name |
Nazwa tego komponentu. |
component_type |
Typ komponentu adresu. Listę możliwych typów znajdziesz w tabeli 2. Dodatkowe typy zwracane przez usługę Miejsca. |
confirmation_level |
Wskazuje poziom pewności, że komponent jest prawidłowy. |
inferred |
Wskazuje, że komponent nie był częścią danych wejściowych, ale wywnioskowaliśmy, że jest to lokalizacja adresu i uważamy, że należy go podać w przypadku pełnego adresu. |
spell_corrected |
Wskazuje poprawkę błędu pisowni w nazwie komponentu. Interfejs API nie zawsze oznacza zmiany z jednej wersji pisowni na inny, na przykład przy zmianie wartości „centre” na „center”. Nie zawsze oznacza to również częste błędy pisowni, np. „Amphitheater Pkwy” na „Amphitheatre Pkwy”. |
replaced |
Wskazuje, że nazwa komponentu została zastąpiona zupełnie inną – np. nieprawidłowy kod pocztowy został zastąpiony kodem poprawnym dla adresu. Nie jest to zmiana wyglądu. Komponent wejściowy został zmieniony na inny. |
unexpected |
Wskazuje komponent adresu, którego nie powinno się znajdować w adresie pocztowym w danym regionie. Zostały przez nas zachowane tylko dlatego, że stanowiły część tych danych. |
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 |
Mogliśmy potwierdzić, że 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 domu mieszczący się w określonym prawidłowym zakresie numerów na ulicy, na której nie są znane konkretne numery domów. |
UNCONFIRMED_AND_SUSPICIOUS |
Ten komponent nie został potwierdzony i prawdopodobnie jest nieprawidłowy. Przykładem może być dzielnica, która nie pasuje do podanego adresu. |
AddressMetadata
Metadane adresu. Nie ma gwarancji, że w przypadku każdego adresu wysłanego do interfejsu Address Validation API pole metadata
będzie wypełnione w pełni.
Pola | |
---|---|
business |
Wskazuje, że jest to adres firmy. Jeśli zasada jest nieskonfigurowana, wartość jest nieznana. |
po_box |
Wskazuje, że jest to adres skrytki pocztowej. Jeśli zasada jest nieskonfigurowana, wartość jest nieznana. |
residential |
Wskazuje, że jest to adres miejsca zamieszkania. Jeśli zasada jest nieskonfigurowana, wartość jest nieznana. |
ComponentName
Opakowanie nazwy komponentu.
Pola | |
---|---|
text |
Tekst nazwy. Na przykład „Piąta Aleja” dla nazwy ulicy lub „1253” w przypadku numeru ulicy. |
language_code |
Kod języka BCP-47. Nie pojawi się, jeśli nazwa komponentu nie jest powiązana z językiem, np. z numerem domu. |
Geokod
Zawiera informacje o miejscu, na które dane zostały zmapowane.
Pola | |
---|---|
location |
Geokodowana lokalizacja danych wejściowych. Preferowanym sposobem używania identyfikatora miejsca jest stosowanie adresów, współrzędnych geograficznych oraz kodów plus. Używanie współrzędnych do wyznaczania tras lub wyznaczania tras dojazdu zawsze powoduje przyciągnięcie punktu do drogi znajdującej się najbliżej tych współrzędnych. Nie musi to być droga, która szybko lub bezpiecznie prowadzi do miejsca docelowego, i nie musi znajdować się w pobliżu punktu dostępu do nieruchomości. Jeśli lokalizacja jest geokodowana w odwrotnym zapisie, nie ma gwarancji, że zwrócony adres będzie zgodny z oryginałem. |
plus_code |
Plus Code odpowiadający atrybutowi |
bounds |
Granice miejsca objętego geokodowaniem. |
feature_size_meters |
Wielkość miejsca objętego geokodem (w metrach). Jest to kolejna miara niedokładności geokodowanej lokalizacji, ale w kontekście fizycznym, a nie semantycznym. |
place_id |
Identyfikator PlaceID miejsca, do którego dane są geokodowane. Więcej informacji o identyfikatorach miejsc znajdziesz tutaj. |
place_types[] |
Typy miejsc, dla których dane wejściowe zostały przekształcone w dane geograficzne. Na przykład: |
LanguageOptions
Wersja testowa: ta funkcja jest w wersji przedpremierowej (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 podlegają Szczegółowym warunkom korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.
Włącza interfejs Address Validation API, aby mógł zawierać dodatkowe informacje w odpowiedzi.
Pola | |
---|---|
return_english_latin_address |
Podgląd: zwróć |
PlusCode
Plus Code (http://plus.codes) to odniesienie do lokalizacji w 2 formatach: kod globalny definiujący rozmiar 14 m x 14 m lub mniejszy prostokątny oraz kod złożony, zastępując prefiks lokalizacją referencyjną.
Pola | |
---|---|
global_code |
Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, reprezentujący obszar o wymiarach 1/8000 x 1/8000 stopni (ok. 14 x 14 metrów). |
compound_code |
Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, zawierający sufiks kodu globalnego i zastąpienie go sformatowaną nazwą elementu referencyjnego. |
ProvideValidationFeedbackRequest
Prośba o przesłanie opinii dotyczącej weryfikacji.
Pola | |
---|---|
conclusion |
Wymagane. Wynik sekwencji prób weryfikacji. Jeśli to pole ma wartość |
response_id |
Wymagane. Identyfikator odpowiedzi, której dotyczy ta opinia. Powinien to być identyfikator [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] z pierwszej odpowiedzi w serii prób weryfikacji adresu. |
ValidationConclusion
Możliwe końcowe wyniki sekwencji próśb o weryfikację adresu, które są niezbędne 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 , zostanie zwrócony błąd INVALID_ARGUMENT . |
VALIDATED_VERSION_USED |
Wersja adresu zwrócona przez interfejs Address Validation API została użyta w transakcji. |
USER_VERSION_USED |
Wersja adresu podana przez użytkownika, która została użyta do zrealizowania transakcji |
UNVALIDATED_VERSION_USED |
W przypadku transakcji została użyta wersja adresu podana po ostatniej próbie weryfikacji, która nie została ponownie zweryfikowana. |
UNUSED |
Transakcja została porzucona i adres nie został użyty. |
ProvideValidationFeedbackResponse
Ten typ nie zawiera pól.
Odpowiedź na opinię dotyczącą weryfikacji.
Jeśli opinia została wysłana, odpowiedź jest pusta.
UspsAddress
Dokument przesyłany przez USPS z adresu w Stanach Zjednoczonych.
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 |
Czterocyfrowe rozszerzenie kodu pocztowego, np. 5023. |
UspsData
Dane USPS dotyczące adresu. Nie ma gwarancji, że pole uspsData
będzie wypełnione w całości w przypadku każdego adresu w Stanach Zjednoczonych lub kraju, który został wysłany do interfejsu Address Validation API. Jeśli jako główną część odpowiedzi używasz pola uspsData, zalecamy zintegrowanie w odpowiedzi pól zapasowego adresu URL.
Pola | |
---|---|
standardized_address |
Ustandaryzowany adres USPS. |
delivery_point_code |
2-cyfrowy kod punktu dostawy |
delivery_point_check_digit |
Cyfra kontrolna punktu dostawy. Ta liczba jest dodawana na końcu parametru delivery_point_barcode w przypadku poczty skanowanej mechanicznie. Po dodaniu wszystkich cyfr kodu kreskowego_punktu dostawy, kodu pocztowego (delivery_point_check_digit), kodu pocztowego i kodu ZIP+4 otrzymasz 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 tym samym ciągu znaków może być wiele przypisów.
|
dpv_cmra |
Wskazuje, czy adres należy do agencji zajmującej się dostarczaniem poczty e-mail (CMRA) – prywatnej firmy, która odbiera pocztę w imieniu klientów. Zwraca pojedynczy znak.
|
dpv_vacant |
Czy to miejsce jest puste? Zwraca pojedynczy znak.
|
dpv_no_stat |
Czy to jest adres bez danych statystycznych czy aktywny? Adresy bez statystyk to takie, które nie są stale zajęte lub nie są obsługiwane przez USPS. Zwraca pojedynczy znak.
|
dpv_no_stat_reason_code |
Wskazuje typ NoStat. Zwraca kod przyczyny w postaci liczby całkowitej.
|
dpv_drop |
Flaga wskazuje, że poczta jest dostarczana do jednej skrzynki odbiorczej w witrynie. Zwraca pojedynczy znak.
|
dpv_throwback |
Wskazuje, że poczta nie jest dostarczana na adres. Zwraca pojedynczy znak.
|
dpv_non_delivery_days |
Flaga oznacza, że poczta nie jest dostarczana każdego dnia tygodnia. Zwraca pojedynczy znak.
|
dpv_non_delivery_days_values |
Liczba całkowita określająca dni niedostarczenia. Można sprawdzać je przy użyciu flag bitowych: 0 x 40 – niedziela to dzień niedostarczenia 0x20 – poniedziałek to dzień niedostarczenia 0x10 – wtorek to dzień niedostarczenia 0x08 – środa to dzień niedoręczenia 0x04 – czwartek to dzień niedoręczenia 0x02 – piątek to dzień niedoręczenia 0x02 – piątek to dzień niedoręczenia 0x01 |
dpv_no_secure_location |
Flaga wskazuje, że drzwi są dostępne, ale paczka nie zostanie pozostawiona ze względów bezpieczeństwa. 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ć w celu dostarczenia poczty. Zwraca pojedynczy znak.
|
dpv_enhanced_delivery_code |
Wskazuje, że dla danego adresu prawidłowy jest więcej niż 1 kod zwrotny od dostawcy zewnętrznego. Zwraca pojedynczy znak.
|
carrier_route |
Kod trasy przewoźnika. Czteroznakowy kod składający się z 1-literowego prefiksu i 3-cyfrowego oznaczenia trasy. Prefiksy:
|
carrier_route_indicator |
Wskaźnik sortowania stawki przewoźnika. |
ews_no_match |
Adres dostawy jest możliwy do dopasowania, ale plik EWS wskazuje, że dopasowanie ścisłe będzie wkrótce dostępne. |
post_office_city |
Główny urząd pocztowy. |
post_office_state |
Główny stan poczty. |
abbreviated_city |
Skrócone miasto. |
fips_county_code |
Kod kraju FIPS. |
county |
Nazwa hrabstwa. |
elot_number |
numeru rozszerzonego linii podróży (eLOT). |
elot_flag |
Flaga eLOT rosnąco/malejąco (A/D). |
lacs_link_return_code |
Kod zwrotu LACSLink. |
lacs_link_indicator |
Wskaźnik LACSLink. |
po_box_only_postal_code |
Kod pocztowy tylko w przypadku skrytki pocztowej. |
suitelink_footnote |
Przypisy od dopasowania do rekordu ulicy lub wieżowca po informacje o lokalu. Jeśli znajdziemy pasującą nazwę firmy, wyświetli się numer dodatkowy.
|
pmb_designator |
Oznaczenie jednostki PMB (Private Mail Box). |
pmb_number |
Numer PMB (Private Mail Box); |
address_record_type |
Typ rekordu adresowego, który pasuje do wejściowego adresu.
|
default_address |
Wskazuje, że znaleziono adres domyślny, ale istnieją bardziej szczegółowe adresy. |
error_message |
Komunikat o błędzie pobierania danych przez USPS. To pole jest wypełniane, gdy przetwarzanie przez USPS zostanie zawieszone z powodu wykrycia sztucznie utworzonych adresów. Ten błąd może powodować, że pola danych USPS mogą nie być wypełnione. |
cass_processed |
Wskazuje, że żądanie zostało przetworzone przez CASS. |
ValidateAddressRequest
Żądanie weryfikacji adresu.
Pola | |
---|---|
address |
Wymagane. Trwa weryfikacja adresu. Niesformatowane adresy należy przesyłać za pomocą formularza Łączna długość pól w tych danych nie może przekraczać 280 znaków. Obsługiwane regiony znajdziesz tutaj. Wartość Interfejs Address Validation API ignoruje wartości w polach |
previous_response_id |
W przypadku pierwszego żądania weryfikacji adresu to pole musi być puste. Jeśli do pełnej weryfikacji pojedynczego adresu potrzeba więcej żądań (np. zmiany wprowadzone przez użytkownika po początkowej weryfikacji wymagają ponownej weryfikacji), każde dodatkowe żądanie musi zawierać w tym polu wartość |
enable_usps_cass |
Włącza tryb zgodności USPS CASS. Dotyczy to tylko pola Zalecamy użycie składowego elementu |
language_options |
Opcjonalnie. Wersja testowa: ta funkcja jest w wersji przedpremierowej (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 podlegają Szczegółowym warunkom korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania. Włącza interfejs Address Validation API, aby mógł zawierać dodatkowe informacje w odpowiedzi. |
session_token |
Opcjonalnie. Ciąg znaków identyfikujący sesję autouzupełniania w celach rozliczeniowych. Musi to być adres URL i nazwa pliku bezpieczny ciąg znaków w formacie base64 o długości maksymalnie 36 znaków ASCII. W przeciwnym razie zwracany jest błąd INVALID_ARGUMENT. Sesja rozpoczyna się, gdy użytkownik wykona zapytanie autouzupełniania, i kończy się, gdy użytkownik wybierze miejsce i wywoła informacje o miejscu lub weryfikację adresu. Każda sesja może zawierać kilka zapytań autouzupełniania, po których następuje jedno pytanie o informacje o miejscu lub weryfikację adresu. Dane logowania używane w każdym żądaniu w sesji muszą należeć do tego samego projektu w konsoli Google Cloud. Po zakończeniu sesji token straci ważność – aplikacja musi wygenerować nowy token dla każdej sesji. Jeśli parametr Uwaga: weryfikacji adresów można używać tylko w sesjach z nowym interfejsem API autouzupełniania, a nie z interfejsem API autouzupełniania. 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 identyfikujący tę odpowiedź. Jeśli adres wymaga ponownej weryfikacji, identyfikator UUID musi zostać dołączony do nowego żądania. |
ValidationResult
Wynik weryfikacji adresu.
Pola | |
---|---|
verdict |
Flagi ogólnej oceny |
address |
Informacje o samym adresie, a nie o kodzie geograficznym. |
geocode |
Informacje o lokalizacji i miejscu, do którego przekodowano dane geograficzne. |
metadata |
Inne informacje istotne z punktu widzenia dostawy. Nie ma gwarancji, że w przypadku każdego adresu wysłanego do interfejsu Address Validation API pole |
usps_data |
Dodatkowe flagi dostawy dostarczane przez USPS. Jest dostępna tylko w regionach |
english_latin_address |
Wersja testowa: ta funkcja jest w wersji przedpremierowej (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 podlegają Szczegółowym warunkom 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 używać ponownie jako danych wejściowych interfejsu API. Dzięki tej usłudze użytkownik może w swoim języku potwierdzić lub odrzucić poprawność pierwotnie podanego adresu. Jeśli część adresu nie ma tłumaczenia na język angielski, usługa zwróci tę część w języku alternatywnym używającym alfabetu łacińskiego. Wyjaśnienie wyboru języka alternatywnego znajdziesz tutaj. Jeśli część adresu nie ma żadnych tłumaczeń ani transliteracji w języku używającym alfabetu łacińskiego, usługa zwróci tę część w języku lokalnym powiązanym z adresem. Włącz te dane wyjściowe za pomocą flagi Uwaga: pola |
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 daje żadnych sygnałów weryfikacyjnych. Informacje o sygnałach weryfikacji znajdziesz w sekcji Jeśli na przykład podany adres zawiera konkretny numer mieszkania, pole |
validation_granularity |
Poziom szczegółowości, na którym interfejs API może w pełni validate adres. Na przykład wartość Wyniki weryfikacji komponentu według adresu można znaleźć w polu |
geocode_granularity |
Informacje o szczegółowości Ta zasada może się czasami różnić od powyższej procedury |
address_complete |
Adres jest uznawany za pełny, jeśli nie ma nierozstrzygniętych tokenów ani niespodziewanych lub brakujących komponentów adresu. Jeśli zasada jest nieskonfigurowana, wartość to |
has_unconfirmed_components |
Nie można sklasyfikować ani zweryfikować co najmniej jednego komponentu adresu. Więcej informacji znajdziesz na stronie |
has_inferred_components |
Pobrano (dodano) co najmniej 1 komponent adresu, którego nie ma w danych wejściowych. Więcej informacji znajdziesz tutaj: |
has_replaced_components |
Zastąpiono co najmniej 1 komponent adresu. Szczegóły znajdziesz tutaj: |
Szczegółowość
Różne poziomy szczegółowości adresu lub geokodu. Wartości te używane do określania szczegółowości adresu wskazują, z jaką dokładnością adres identyfikuje miejsce docelowe poczty. Na przykład adres „123 Main Street, Redwood City, CA, 94061” identyfikuje PREMISE
, a na przykład „Redwood City, CA, 94061” wskazuje identyfikator LOCALITY
. Jeśli jednak nie możemy znaleźć kodu geograficznego „ulica Główna 123” w Redwood City, zwracany geokod może mieć dokładność LOCALITY
, mimo że jest bardziej szczegółowy.
Wartości w polu enum | |
---|---|
GRANULARITY_UNSPECIFIED |
Wartość domyślna. Ta wartość nie jest używana. |
SUB_PREMISE |
Wynik znajdujący się poniżej poziomu budynku, np. mieszkanie. |
PREMISE |
Wynik na poziomie budynku. |
PREMISE_PROXIMITY |
Geokod, który określa przybliżoną lokalizację adresu na poziomie budynku. |
BLOCK |
Adres lub kod geograficzny wskazują blok. Używany tylko w regionach z adresowaniem na poziomie bloku, np. w Japonii. |
ROUTE |
Geokod lub adres są bardzo szczegółowe w odniesieniu do trasy, np. ulicy, drogi lub autostrady. |
OTHER |
Wszystkie inne szczegóły, które są grupowane razem, ponieważ nie są możliwe do dostarczenia. |