如何配置Google Places Autocomplete仅返回南非可配送完整真实地址

1. 精准过滤地址类型，剔除非配送类结果 #

你当前的allowedTypes包含route（仅街道，无门牌号）和geocode（可能包含非精准地址），这是导致缺失门牌号的核心原因。调整为仅保留带精准门牌号的可配送类型：

const allowedTypes = [
  "street_address", // 带门牌号的完整街道地址
  "premise",        // 独立建筑（如办公楼、商铺）
  "subpremise"      // 建筑内单元（如公寓、办公室房间号）
];

无需保留blockedTypes，精准的allowedTypes已足够过滤城市、省份等非目标结果。

2. 强制限定南非境内结果 #

通过components参数严格锁定南非（国家代码za），避免其他地区的地址混入：

const autocomplete = new google.maps.places.Autocomplete(inputElement, {
  types: allowedTypes,
  components: { country: "za" }, // 仅返回南非地址
  fields: ["place_id", "formatted_address"] // 仅请求必要字段，减少开销
});

3. 启用严格地理边界约束 #

结合location和strictBounds，将搜索范围严格限制在南非境内，进一步过滤异常结果：

// 南非大致地理边界
const southAfricaBounds = new google.maps.LatLngBounds(
  new google.maps.LatLng(-35.0, 16.0), // 西南角
  new google.maps.LatLng(-22.0, 33.0)  // 东北角
);

const autocomplete = new google.maps.places.Autocomplete(inputElement, {
  types: allowedTypes,
  components: { country: "za" },
  bounds: southAfricaBounds,
  strictBounds: true, // 强制结果在设定边界内
  fields: ["place_id", "formatted_address"]
});

4. 选中地点后验证地址完整性 #

仅靠Autocomplete无法保证字段齐全，必须通过Place Details API获取完整地址组件，然后校验必填字段是否存在：

autocomplete.addListener("place_changed", () => {
  const place = autocomplete.getPlace();
  if (!place.place_id) return;

  // 调用Place Details API获取完整地址组件
  const service = new google.maps.places.PlacesService(document.createElement('div'));
  service.getDetails({
    placeId: place.place_id,
    fields: ["address_components"]
  }, (details, status) => {
    if (status !== google.maps.places.PlacesServiceStatus.OK) return;

    // 解析地址组件，映射到配送公司要求的字段
    const addressParts = {
      streetNumber: null,
      streetName: null,
      city: null,
      localArea: null,
      state: null,
      zipCode: null
    };

    details.address_components.forEach(component => {
      switch (true) {
        case component.types.includes("street_number"):
          addressParts.streetNumber = component.long_name;
          break;
        case component.types.includes("route"):
          addressParts.streetName = component.long_name;
          break;
        case component.types.includes("locality"):
          addressParts.city = component.long_name;
          break;
        case component.types.includes("sublocality") || component.types.includes("sublocality_level_1"):
          addressParts.localArea = component.long_name;
          break;
        case component.types.includes("administrative_area_level_1"):
          addressParts.state = component.long_name;
          break;
        case component.types.includes("postal_code"):
          addressParts.zipCode = component.long_name;
          break;
      }
    });

    // 校验必填字段：门牌号、邮政编码、城市是配送核心字段
    const requiredFields = ["streetNumber", "zipCode", "city"];
    const missingFields = requiredFields.filter(field => !addressParts[field]);

    if (missingFields.length > 0) {
      // 提示用户地址不完整，无法用于配送
      alert(`地址缺失必要信息：${missingFields.join(", ")}，请重新选择或补充`);
      return;
    }

    // 地址校验通过，提交给配送公司
    console.log("可配送地址：", addressParts);
  });
});

5. 补充说明 #

• 南非的localArea可能对应sublocality或sublocality_level_1，需同时匹配这两个类型
• 若某些偏远地区确实缺少邮政编码，可考虑允许用户手动补充，但需提前和配送公司确认规则
• 确保你的API密钥已启用Places API和Places Details API权限

内容的提问来源于stack exchange，提问作者Stav Cohen