Package google.maps.addressvalidation.v1

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Chỉ mục

Xác thực địa chỉ

Dịch vụ xác thực địa chỉ.

Cung cấp phản hồi xác thực

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Phản hồi về kết quả của trình tự xác thực. Đây phải là lệnh gọi cuối cùng được thực hiện sau một chuỗi các lệnh gọi xác thực cho cùng một địa chỉ và phải được gọi sau khi giao dịch kết thúc. Bạn chỉ nên gửi địa chỉ này một lần cho chuỗi yêu cầu ValidateAddress cần thiết để xác thực địa chỉ đầy đủ.

Xác thực địa chỉ

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Xác thực địa chỉ.

Address (Địa chỉ)

Thông tin chi tiết về địa chỉ được phân tích cú pháp từ thông tin nhập vào.

Các trường
formatted_address

string

Địa chỉ đã sửa, được định dạng là địa chỉ một dòng tuân theo quy tắc định dạng địa chỉ của khu vực có địa chỉ đó.

postal_address

PostalAddress

Địa chỉ đã xác thực là địa chỉ gửi thư.

address_components[]

AddressComponent

Danh sách không theo thứ tự. Các thành phần địa chỉ riêng lẻ của địa chỉ được định dạng và sửa, cùng với thông tin xác thực. Điều này cung cấp thông tin về trạng thái xác thực của các thành phần riêng lẻ.

Các thành phần địa chỉ không được sắp xếp theo cách cụ thể. Đừng giả định về thứ tự của các thành phần địa chỉ trong danh sách.

missing_component_types[]

string

Những loại thành phần dự kiến có trong địa chỉ gửi thư được định dạng chính xác nhưng không thể tìm thấy trong dữ liệu đầu vào VÀ không thể dự đoán được. Các thành phần thuộc loại này không có trong formatted_address, postal_address hoặc address_components. Ví dụ: ['street_number', 'route'] cho dữ liệu đầu vào như "Boulder, Colorado, 80301, Hoa Kỳ". Bạn có thể xem danh sách các loại có thể sử dụng tại đây.

unconfirmed_component_types[]

string

Các loại thành phần có trong address_components nhưng không thể xác nhận là chính xác. Trường này được cung cấp để thuận tiện: nội dung của trường này tương đương với việc lặp lại thông qua address_components để tìm loại tất cả thành phần mà confirmation_level không phải là CONFIRMED hoặc cờ inferred không được đặt thành true. Bạn có thể xem danh sách các loại có thể sử dụng tại đây.

unresolved_tokens[]

string

Bất kỳ mã thông báo nào trong dữ liệu đầu vào không thể phân giải được. Đây có thể là dữ liệu đầu vào không được nhận dạng là một phần hợp lệ của địa chỉ (ví dụ: trong dữ liệu đầu vào như "123235253253 Main St, San Francisco, CA, 94105", các mã thông báo chưa được phân giải có thể trông giống như ["123235253253"] vì đó có vẻ như không phải là một số hợp lệ.

Thành phần địa chỉ

Biểu thị một thành phần địa chỉ, chẳng hạn như đường phố, thành phố hoặc tiểu bang.

Các trường
component_name

ComponentName

Tên cho thành phần này.

component_type

string

Loại thành phần địa chỉ. Xem Bảng 2: Các loại bổ sung mà dịch vụ Địa điểm trả về để biết danh sách các loại có thể áp dụng.

confirmation_level

ConfirmationLevel

Cho biết mức độ chắc chắn mà chúng tôi có để đảm bảo rằng thành phần này là chính xác.

inferred

bool

Cho biết rằng thành phần không phải là một phần của thông tin đầu vào, nhưng chúng tôi dự đoán thành phần đó ở vị trí địa chỉ và tin rằng thành phần này nên được cung cấp cho một địa chỉ đầy đủ.

spell_corrected

bool

Cho biết cách viết chính tả của tên thành phần bị sửa theo một cách nhỏ, ví dụ: bằng cách chuyển đổi hai ký tự xuất hiện theo thứ tự không chính xác. Điều này cho thấy một thay đổi thẩm mỹ.

replaced

bool

Cho biết tên của thành phần đã được thay thế bằng một tên hoàn toàn khác, ví dụ như một mã bưu chính sai được thay thế bằng một mã chính xác cho địa chỉ. Đây không phải là một thay đổi thẩm mỹ, thành phần đầu vào đã được thay đổi thành một thành phần khác.

unexpected

bool

Cho biết thành phần địa chỉ không có khả năng xuất hiện trong địa chỉ bưu điện cho khu vực nhất định. Chúng tôi chỉ giữ lại dữ liệu này vì đó là một phần của dữ liệu đầu vào.

Cấp xác nhận

Các giá trị khác nhau cho các cấp xác nhận.

Enum
CONFIRMATION_LEVEL_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
CONFIRMED Chúng tôi có thể xác minh rằng thành phần này tồn tại và có ý nghĩa trong ngữ cảnh của phần còn lại của địa chỉ.
UNCONFIRMED_BUT_PLAUSIBLE Không thể xác nhận thành phần này nhưng thành phần này hợp lý. Ví dụ: số nhà trong phạm vi số hợp lệ đã biết trên phố mà số nhà cụ thể không được biết.
UNCONFIRMED_AND_SUSPICIOUS Thành phần này không được xác nhận và có thể không chính xác. Ví dụ: vùng lân cận không phù hợp với phần còn lại của địa chỉ.

Siêu dữ liệu địa chỉ

Siêu dữ liệu cho địa chỉ. Chúng tôi không đảm bảo rằng metadata sẽ được điền đầy đủ cho mọi địa chỉ được gửi đến API Xác thực địa chỉ.

Các trường
business

bool

Cho biết rằng đây là địa chỉ của một doanh nghiệp. Nếu bạn không đặt chính sách này, thì tức là giá trị không xác định.

po_box

bool

Cho biết địa chỉ của hộp thư bưu điện. Nếu bạn không đặt chính sách này, thì tức là giá trị không xác định.

residential

bool

Cho biết rằng đây là địa chỉ cư trú. Nếu bạn không đặt chính sách này, thì tức là giá trị không xác định.

Tên thành phần

Trình bao bọc tên cho thành phần.

Các trường
text

string

Văn bản tên. Ví dụ: "5th Avenue" cho tên đường hoặc "1253" cho số nhà.

language_code

string

Mã ngôn ngữ BCP-47. Điều này sẽ không xuất hiện nếu tên thành phần không liên kết với một ngôn ngữ, chẳng hạn như số nhà.

Mã địa lý

Chứa thông tin về địa điểm chứa dữ liệu được mã hoá địa lý.

Các trường
location

LatLng

Vị trí được mã hoá địa lý của đầu vào.

Ưu tiên sử dụng mã địa điểm hơn là sử dụng địa chỉ, toạ độ vĩ độ/kinh độ hoặc mã cộng. Việc sử dụng toạ độ khi định tuyến hoặc tính toán chỉ đường lái xe sẽ luôn dẫn đến điểm được bám vào đường gần nhất với các toạ độ đó. Đây có thể không phải là đường sẽ dẫn tới điểm đến một cách nhanh chóng hoặc an toàn và có thể không ở gần điểm truy cập vào cơ sở lưu trú. Ngoài ra, khi một vị trí được mã hóa địa lý ngược, không có gì đảm bảo rằng địa chỉ trả về sẽ khớp với địa chỉ gốc.

plus_code

PlusCode

Plus code tương ứng với location.

bounds

Viewport

Giới hạn của địa điểm được mã hóa địa lý.

feature_size_meters

float

Kích thước của địa điểm được mã hóa địa lý, tính bằng mét. Đây là thước đo khác về độ nhám của vị trí được mã hóa địa lý, nhưng về kích thước thực tế chứ không phải về mặt ngữ nghĩa.

place_id

string

PlaceID của địa điểm mà mục nhập này mã hoá địa lý.

Để biết thêm thông tin về Mã địa điểm, hãy xem tại đây.

place_types[]

string

(Các) loại địa điểm mà đầu vào đã mã hoá địa lý. Ví dụ: ['locality', 'political']. Bạn có thể xem danh sách đầy đủ các loại tại đây.

Mã cộng

Plus code (http://plus.codes) là tham chiếu vị trí có hai định dạng: mã toàn cục xác định hình chữ nhật 14mx14m (1/8000 của độ) hoặc nhỏ hơn và mã phức hợp, thay thế tiền tố bằng vị trí tham chiếu.

Các trường
global_code

string

Mã toàn cầu (đầy đủ) của địa điểm, chẳng hạn như "9FWM33GV+HQ", đại diện cho khu vực 1/8000 x 1/8000 độ (~14 x 14 mét).

compound_code

string

Mã phức hợp của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Na Uy", chứa hậu tố của mã toàn cầu và thay thế tiền tố bằng tên được định dạng của thực thể tham chiếu.

Cung cấp Xác thực phản hồi yêu cầu

Yêu cầu gửi phản hồi xác thực.

Các trường
conclusion

ValidationConclusion

Bắt buộc. Kết quả của trình tự xác thực.

Nếu bạn đặt trường này thành VALIDATION_CONCLUSION_UNSPECIFIED, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.

response_id

string

Bắt buộc. Mã của phản hồi mà phản hồi này được gửi tới. Đây phải là [response_id][google.maps.addressvalidateation.v1.AuthenticationAddressRequest.response_id] trong phản hồi đầu tiên trong một loạt lần xác thực địa chỉ.

Kết luận xác thực

Kết quả cuối cùng có thể có của chuỗi yêu cầu xác thực địa chỉ cần thiết để xác thực địa chỉ.

Enum
VALIDATION_CONCLUSION_UNSPECIFIED Giá trị này không được sử dụng. Nếu bạn đặt trường ProvideValidationFeedbackRequest.conclusion thành VALIDATION_CONCLUSION_UNSPECIFIED, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
VALIDATED_VERSION_USED Phiên bản địa chỉ mà API Xác thực địa chỉ trả về đã được dùng cho giao dịch.
USER_VERSION_USED Phiên bản địa chỉ do người dùng cung cấp được dùng cho giao dịch
UNVALIDATED_VERSION_USED Phiên bản của địa chỉ đã được nhập sau lần xác thực gần nhất nhưng không được xác thực lại đã được sử dụng cho giao dịch.
UNUSED Giao dịch đã bị bỏ qua và địa chỉ không được sử dụng.

Cung cấp phản hồi xác thực

Phản hồi cho phản hồi xác thực.

Phản hồi trống nếu phản hồi được gửi thành công.

Địa chỉ Usps

USPS đại diện cho một địa chỉ ở Hoa Kỳ.

Các trường
first_address_line

string

Dòng địa chỉ đầu tiên.

firm

string

Tên công ty.

second_address_line

string

Dòng địa chỉ thứ hai.

urbanization

string

Tên đô thị Puerto Rico.

city_state_zip_address_line

string

Thành phố + tiểu bang + mã bưu chính.

city

string

Tên thành phố.

state

string

Mã trạng thái gồm 2 chữ cái.

zip_code

string

Mã bưu chính, ví dụ: 10009.

zip_code_extension

string

Mã bưu chính 4 chữ số, ví dụ: 5023.

Dataps

Dữ liệu của USPS cho địa chỉ. Chúng tôi không đảm bảo rằng uspsData sẽ được điền đầy đủ cho mỗi địa chỉ ở Hoa Kỳ hoặc PR được gửi đến API Xác thực địa chỉ. Bạn nên tích hợp các trường địa chỉ sao lưu trong phản hồi nếu sử dụng UspsData làm phần chính của phản hồi.

Các trường
standardized_address

UspsAddress

Địa chỉ chuẩn hoá USPS.

delivery_point_code

string

Mã điểm giao hàng gồm 2 chữ số

delivery_point_check_digit

string

Số kiểm tra của điểm giao hàng. Mã số này được thêm vào cuối mã Delivery_point_barcode cho thư được quét cơ học. Kết hợp tất cả các chữ số của mã item_point_barcode,delivery_point_check_letter, mã bưu chính và ZIP+4 sẽ tạo ra một số chia hết cho 10.

dpv_confirmation

string

Các giá trị có thể có để xác nhận DPV. Trả về một ký tự.

  • Y: Địa chỉ đã được xác nhận là DPV cho số chính và bất kỳ số phụ nào.
  • N: Không thể xác nhận thông tin về số chính và bất kỳ số phụ nào cho DPV để xác nhận.
  • S: Địa chỉ do DPV xác nhận chỉ dành cho số điện thoại chính và thông tin số phụ đã có sẵn do không được xác nhận.
  • D: Địa chỉ mà DPV đã xác nhận chỉ dành cho số điện thoại chính và thiếu thông tin số phụ.
dpv_footnote

string

Các chú thích cuối trang từ xác thực điểm phân phối. Nhiều chú thích cuối trang có thể được xâu chuỗi với nhau trong cùng một chuỗi.

  • AA: Địa chỉ nhập khớp với tệp ZIP+4
  • A1: Địa chỉ nhập không khớp với tệp ZIP+4
  • BB: Đã đối sánh với DPV (tất cả các thành phần)
  • CC: Số phụ không khớp (có nhưng không hợp lệ)
  • N1: Địa chỉ nhà cao tầng thiếu số phụ
  • M1: Thiếu số điện thoại chính
  • M3: Số chính không hợp lệ
  • P1: Thiếu số hộp địa chỉ đầu vào RR hoặc HC
  • P3: Địa chỉ nhập PO, RR hoặc Số hộp HC không hợp lệ
  • F1: Địa chỉ nhập vào khớp với địa chỉ quân sự
  • G1: Địa chỉ nhập vào khớp với địa chỉ giao hàng chung
  • U1: Địa chỉ nhập khớp với mã ZIP duy nhất
  • PB: Địa chỉ nhập vào khớp với bản ghi PBSA
  • RR: Địa chỉ xác nhận DPV có thông tin PMB
  • R1: Địa chỉ được xác nhận là DPV mà không có thông tin về PMB
  • R7: Bản ghi R777 hoặc R779 của nhà mạng
dpv_cmra

string

Cho biết địa chỉ có phải là CMRA (Cơ quan nhận thư thương mại) hay không – một doanh nghiệp tư nhân nhận thư cho khách hàng. Trả về một ký tự.

  • Y: Địa chỉ là CMRA
  • N: Địa chỉ này không phải là CMRA
dpv_vacant

string

Địa điểm này có trống không? Trả về một ký tự.

  • Y: Địa chỉ trống
  • N: Địa chỉ không trống
dpv_no_stat

string

Đây không phải là địa chỉ số liệu thống kê hay địa chỉ đang hoạt động? Không có địa chỉ trạng thái nào là địa chỉ không liên tục có người lưu trú hoặc địa chỉ mà USPS không phục vụ. Trả về một ký tự.

  • Y: Địa chỉ không hoạt động
  • N: Địa chỉ đang hoạt động
carrier_route

string

Mã tuyến của nhà mạng. Mã bốn ký tự bao gồm một tiền tố chữ cái và một mã chỉ định tuyến đường gồm ba chữ số.

Tiền tố:

  • C: Tuyến đường của hãng vận chuyển (hoặc tuyến thành phố)
  • R: Tuyến đường nông thôn
  • H: Tuyến đường hợp đồng trên đường cao tốc
  • B: Mục Hộp thư bưu điện
  • G: Đơn vị giao hàng chung
carrier_route_indicator

string

Chỉ báo sắp xếp cước phí của hãng vận chuyển.

ews_no_match

bool

Địa chỉ giao hàng có thể khớp, nhưng tệp FOLDER chỉ ra rằng địa chỉ này sẽ sớm khớp chính xác.

post_office_city

string

Bưu điện chính của thành phố.

post_office_state

string

Tiểu bang chính của bưu điện.

abbreviated_city

string

Thành phố viết tắt.

fips_county_code

string

Mã hạt FIPS.

county

string

Tên hạt.

elot_number

string

Số Chuyến đi nâng cao (eLOT).

elot_flag

string

eLOT Tăng/giảm cờ (A/D).

po_box_only_postal_code

bool

Chỉ mã bưu chính của PO Box.

pmb_designator

string

Nhà chỉ định đơn vị PMB (Hộp thư riêng).

pmb_number

string

Số PMB (Hộp thư riêng);

address_record_type

string

Loại bản ghi địa chỉ khớp với địa chỉ nhập.

  • F: FIRM. Đây là kết quả trùng khớp với Bản ghi công ty, đây là mức độ phù hợp nhất đối với một địa chỉ.
  • G: PHÂN PHỐI CHUNG. Đây là một kết quả trùng khớp với bản ghi Phân phối chung.
  • H: Xây dựng/căn hộ. Đây là kết quả trùng khớp với bản ghi của Toà nhà hoặc Căn hộ.
  • P: HỘP CHÍNH THỨC ĐĂNG. Đây là kết quả phù hợp với Hộp thư bưu điện.
  • R: HỢP ĐỒNG NGƯỢC ĐƯỜNG LIÊN KẾT hoặc HỢP ĐỒNG TẠO ĐƯỜNG LIÊN QUAN: Đây là kết quả trùng khớp với một Tuyến đường nông thôn hoặc hồ sơ Hợp đồng đường cao tốc, cả hai đều có phạm vi Số hộp được liên kết.
  • S: GHI đường phố: Đây là kết quả trùng khớp với bản ghi Đường phố có chứa phạm vi số chính hợp lệ.
default_address

bool

Chỉ báo cho biết một địa chỉ mặc định đã được tìm thấy, nhưng còn có địa chỉ cụ thể hơn.

error_message

string

Thông báo lỗi khi truy xuất dữ liệu USPS. Quy trình này được điền sẵn khi quá trình xử lý USPS bị tạm ngưng do phát hiện các địa chỉ được tạo giả tạo.

Các trường dữ liệu USPS có thể không được điền sẵn khi có lỗi này.

cass_processed

bool

Chỉ báo cho biết yêu cầu đã được xử lý CASS.

ValidationAddressRequest

Yêu cầu xác thực địa chỉ.

Các trường
address

PostalAddress

Bắt buộc. Địa chỉ đang được xác thực. Bạn phải gửi các địa chỉ chưa được định dạng qua address_lines.

Tổng độ dài của các trường trong dữ liệu nhập này không được vượt quá 280 ký tự.

Bạn có thể tìm thấy các khu vực được hỗ trợ trong phần Câu hỏi thường gặp.

Giá trị language_code trong địa chỉ nhập dành riêng cho việc sử dụng sau này và bị bỏ qua trong hôm nay. Kết quả xác thực địa chỉ sẽ được điền dựa trên ngôn ngữ ưa thích cho địa chỉ đã cung cấp, như được hệ thống xác định.

API Xác thực địa chỉ bỏ qua các giá trị trong recipientsorganization. Mọi giá trị trong các trường đó sẽ bị loại bỏ và không được trả về. Vui lòng không đặt.

previous_response_id

string

Trường này phải để trống cho yêu cầu xác thực địa chỉ đầu tiên. Nếu cần thêm nhiều yêu cầu để xác thực đầy đủ một địa chỉ (ví dụ: nếu những thay đổi mà người dùng thực hiện sau khi xác thực lại lần đầu cần được xác thực lại), thì mỗi yêu cầu tiếp theo phải điền response_id này vào trường này bằng phản hồi đầu tiên trong trình tự xác thực.

enable_usps_cass

bool

Bật chế độ tương thích với USPS CASS. Điều này chỉ ảnh hưởng đến trường google.maps.addressvalidation.v1.ValidationResult.usps_data của google.maps.addressvalidation.v1.ValidationResult. Lưu ý: đối với các yêu cầu hỗ trợ USPS CASS dành cho địa chỉ ở Puerto Rico, bạn phải cung cấp google.type.PostalAddress.region_code của address dưới dạng "PR" hoặc google.type.PostalAddress.administrative_area của address phải được cung cấp là "Puerto Rico" (không phân biệt chữ hoa chữ thường) hoặc "PR".

Bạn nên sử dụng address thành phần hoặc chỉ định ít nhất 2 google.type.PostalAddress.address_lines, trong đó dòng đầu tiên chứa số nhà và tên, còn dòng thứ hai chứa thành phố, tiểu bang và mã bưu chính.

Xác thực địa chỉ phản hồi

Phản hồi cho một yêu cầu xác thực địa chỉ.

Các trường
result

ValidationResult

Kết quả xác thực địa chỉ.

response_id

string

UUID xác định phản hồi này. Nếu cần xác thực lại địa chỉ, thì UUID này phải đi kèm với yêu cầu mới.

Xác thực kết quả

Kết quả xác thực địa chỉ.

Các trường
verdict

Verdict

Cờ kết quả chung

address

Address

Thông tin về chính địa chỉ đó thay vì mã hoá địa lý.

geocode

Geocode

Thông tin về vị trí và địa điểm mà địa chỉ được mã hóa địa lý.

metadata

AddressMetadata

Thông tin khác liên quan đến việc cung cấp nội dung. Chúng tôi không đảm bảo rằng metadata sẽ được điền đầy đủ cho mọi địa chỉ được gửi đến API Xác thực địa chỉ.

usps_data

UspsData

Cờ về khả năng phân phối bổ sung do USPS cung cấp. Chỉ được cung cấp ở khu vực USPR.

Kết quả

Thông tin tổng quan cấp cao về kết quả xác thực địa chỉ và mã địa lý.

Các trường
input_granularity

Granularity

Mức độ chi tiết của địa chỉ đầu vào. Đây là kết quả của việc phân tích cú pháp địa chỉ nhập và không cung cấp bất kỳ tín hiệu xác thực nào. Đối với các tín hiệu xác thực, hãy tham khảo validation_granularity bên dưới.

Ví dụ: nếu địa chỉ nhập bao gồm số căn hộ cụ thể thì input_granularity ở đây sẽ là SUB_PREMISE. Nếu chúng tôi không thể khớp số căn hộ trong cơ sở dữ liệu hoặc số căn hộ không hợp lệ, thì validation_granularity có thể sẽ là PREMISE hoặc thấp hơn.

validation_granularity

Granularity

Mức độ chi tiết mà API có thể xác thực hoàn toàn địa chỉ. Ví dụ: validation_granularity của PREMISE cho biết mọi thành phần địa chỉ ở cấp PREMISE trở lên có thể được xác thực.

Bạn có thể tìm thấy kết quả xác thực mỗi thành phần của địa chỉ trong google.maps.addressvalidation.v1.Address.address_components.

geocode_granularity

Granularity

Thông tin về độ chi tiết của geocode. Điều này có thể được hiểu là ý nghĩa ngữ nghĩa của vị trí được mã hóa hoặc mức độ thô.

Điều này đôi khi có thể khác với validation_granularity ở trên. Ví dụ: cơ sở dữ liệu của chúng tôi có thể ghi lại sự tồn tại của số căn hộ nhưng không có vị trí chính xác cho căn hộ trong khu phức hợp căn hộ lớn. Trong trường hợp đó, validation_granularity sẽ là SUB_PREMISE nhưng geocode_granularity sẽ là PREMISE.

address_complete

bool

Địa chỉ được coi là hoàn chỉnh nếu không có mã thông báo chưa được giải quyết, không có thành phần địa chỉ lạ hoặc bị thiếu. Xem các trường missing_component_types, unresolved_tokens hoặc unexpected để biết thêm thông tin chi tiết.

has_unconfirmed_components

bool

Không thể phân loại hay xác thực ít nhất một thành phần địa chỉ, hãy xem google.maps.addressvalidation.v1.Address.address_components để biết thông tin chi tiết.

has_inferred_components

bool

Ít nhất một thành phần địa chỉ được dự đoán (đã thêm) không có trong mục nhập, hãy xem google.maps.addressvalidation.v1.Address.address_components để biết thông tin chi tiết.

has_replaced_components

bool

Ít nhất một thành phần địa chỉ đã được thay thế, hãy xem google.maps.addressvalidation.v1.Address.address_components để biết thông tin chi tiết.

Độ chi tiết

Các chi tiết khác nhau mà địa chỉ hoặc mã địa lý có thể có. Khi dùng để chỉ báo mức độ chi tiết cho một địa chỉ, các giá trị này cho biết mức độ chi tiết mà địa chỉ nhận dạng đích đến gửi thư. Ví dụ: địa chỉ như "123 Main Street, Redwood City, CA, 94061" xác định PREMISE trong khi một cái gì đó như "Redwood City, CA, 94061" xác định LOCALITY. Tuy nhiên, nếu chúng tôi không thể tìm thấy một mã địa lý cho "123 Main Street" ở Thành phố Redwood, mã địa lý được trả về có thể có độ chi tiết LOCALITY mặc dù địa chỉ chi tiết hơn.

Enum
GRANULARITY_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
SUB_PREMISE Kết quả dưới cấp toà nhà, chẳng hạn như căn hộ.
PREMISE Kết quả cấp toà nhà.
PREMISE_PROXIMITY Một mã địa lý phải rất gần với vị trí của địa chỉ ở cấp toà nhà. Chỉ dùng cho mã địa lý và không dùng cho địa chỉ.
BLOCK Địa chỉ hoặc mã địa lý biểu thị một khối. Chỉ được sử dụng ở những khu vực có địa chỉ cấp khối, chẳng hạn như Nhật Bản.
ROUTE Mã địa lý hoặc địa chỉ chi tiết để định tuyến, chẳng hạn như đường phố, đường phố hoặc đường cao tốc.
OTHER Tất cả các chi tiết khác được nhóm lại với nhau vì không thể phân phối cùng lúc.