name: amap_geocode
desc: 高德地图地理编码/逆地理编码 API。将结构化地址转换为经纬度坐标(geo)，或将经纬度转换为详细地址(regeo)。支持地标性建筑名称解析。
params:
  - name: type
    type: string
    required: true
    description: 操作类型。geo=地址转经纬度（地理编码），regeo=经纬度转地址（逆地理编码）
  - name: address
    type: string
    required: false
    description: 结构化地址信息，type=geo 时必填。如"北京市朝阳区阜通东大街6号"。支持地标性建筑名称如"天安门"
  - name: location
    type: string
    required: false
    description: 经纬度坐标，type=regeo 时必填。格式"经度,纬度"，小数点后不超过 6 位
  - name: city
    type: string
    required: false
    description: 指定查询城市，type=geo 时可选。支持中文/全拼/citycode/adcode。为空则全国搜索
  - name: radius
    type: integer
    required: false
    default: "1000"
    description: type=regeo 时搜索附近 POI 的半径，0~3000 米，默认 1000
  - name: extensions
    type: string
    required: false
    default: "base"
    description: type=regeo 时返回结果控制。base=基本地址信息，all=含附近 POI、道路、交叉口信息
  - name: poitype
    type: string
    required: false
    description: type=regeo 且 extensions=all 时，限定附近 POI 类型，多个用 | 分隔
env:
  - AMAP_API_KEY
steps:
  - url: https://restapi.amap.com/v3/geocode/${param:type}
    method: GET
    query:
      - [key, "${env:AMAP_API_KEY}"]
      - [address, "${param:address}"]
      - [location, "${param:location}"]
      - [city, "${param:city}"]
      - [radius, "${param:radius}"]
      - [extensions, "${param:extensions}"]
      - [poitype, "${param:poitype}"]
    timeout: 15
    var:
      - name: status
        extract: status
      - name: info
        extract: info
      - name: count
        extract: count
        default: "0"
      - name: geocodes
        extract: geocodes
        default: ""
      - name: regeocode
        extract: regeocode
        default: ""
    result: |
      status=${step0:status}, info=${step0:info}
      count=${step0:count}
      geocodes=${step0:geocodes}
      regeocode=${step0:regeocode}