Google Geocode API国际地址组件映射通用规则咨询

核心原则 #

不要硬绑定单一address_component类型，而是针对每个表单字段，基于全球地址层级的通用逻辑，列出该字段可能对应的多类型匹配列表，并按优先级排序匹配；同时结合返回的country组件类型，做针对性微调。

各字段具体映射规则 #

1. Address（主地址行）

主地址行用于填写街道、门牌号等核心定位信息，匹配优先级：

• 优先组合street_number + route（注意部分国家顺序相反，比如欧洲部分国家是route在前、street_number在后）
• 无上述类型时，取premise（独立建筑名）或subpremise（建筑内单元，若主建筑信息已明确）
• 亚洲部分国家（如日本、印度）优先匹配thoroughfare、sub_thoroughfare
• 兜底：选取types中不含行政类（如locality、administrative_area_*）的第一个组件的long_name

2. Address Line 2（次要地址行）

用于补充主地址未涵盖的信息（如单元号、楼层、小区名），匹配优先级：

• 优先匹配subpremise（若主地址已使用premise）
• 其次是floor、room、apartment等细分空间类型
• 部分国家可选取neighborhood、sublocality_level_1（若主地址未包含该层级）
• 补充类信息：post_box（邮箱号）、building（楼栋号）

3. Zip Code（邮编）

全球邮编类型相对统一，匹配规则：

• 优先取postal_code，若存在postal_code_suffix（如美国邮编后缀），拼接为完整格式（如90210-1234）
• 部分国家使用postal_code_prefix，直接取用该值

4. City（城市/城镇）

针对不同国家的行政层级差异，匹配优先级：

• 优先匹配locality（通用城市级行政区）
• 无locality时，取sublocality_level_1（如印度、巴西的城市级区域）
• 欧洲部分国家（如英国）优先使用postal_town
• 日本直接匹配city类型组件

5. State（州/省/大区）

对应国家一级行政区或次一级行政区，匹配优先级：

• 优先匹配administrative_area_level_1（通用最高级行政区，如美国州、中国省、法国大区）
• 英国、部分欧洲国家优先匹配administrative_area_level_2（对应郡/州级）
• 确保选取的组件types包含political，避免非行政类区域

关键处理技巧 #

• 按国家微调：先提取返回结果中的country组件，针对特定国家（如美国、日本、印度）复用已验证的专属规则，其余国家用通用规则
• 多类型匹配：每个address_component的types是数组，优先匹配目标类型（比如某个组件同时是locality和political，优先认定为城市）
• 留空兜底：若某字段无匹配组件，直接留空，不要强行填充无关信息，避免误导用户

内容的提问来源于stack exchange，提问作者soul true