# Generated by ShowAPI OpenAPI generator
# source: market/238
# generated-at: 2026-09-11T08:57:00.426Z
openapi: 3.0.3
info:
  title: 地址与经纬度互转
  description: 该接口专为解决地址与经纬度之间的转换问题而设计，能便捷地在线上发货地址、收货地时间预测、GPS定位以及各大地图服务（如Google地图、Sogou地图、百度地图等）中实现地理位置与经纬度的互换。适用于需要地理位置信息的多种场景，帮助用户实现较为准确的地理定位。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /238-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 60
    x-connect-timeout: 60
    post:
      summary: 经纬度转地址
      description: 支持由经纬度查询结构化地址，可处理多种坐标类型：GPS角度坐标、GPS米制坐标（含搜狗）、谷歌、阿里、MapABC、高德、百度、Mapbar、51地图等，以及谷歌等坐标对应的米制坐标。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          addressComponent:
                            type: object
                            properties:
                              direction:
                                type: string
                                description: 和当前坐标点的方向
                              street:
                                type: string
                                description: 街道名（行政区划中的街道层级）
                              country_code_iso2:
                                type: string
                                description: 国家英文缩写（两位）
                              country_code:
                                type: number
                                description: 国家编码
                              city_level:
                                type: number
                                description: 城市所在级别（仅国外有参考意义。国外行政区划与中国有差异，城市对应的层级不一定为『city』。country、province、city、district、town分别对应0-4级，若city_level=3，则district层级为该国家的city层级）
                              country:
                                type: string
                                description: 国家
                              city:
                                type: string
                                description: 城市名
                              distance:
                                type: string
                                description: 相对当前坐标点的距离，当有门牌号的时候返回数据
                              province:
                                type: string
                                description: 省
                              adcode:
                                type: string
                                description: 行政区划代码
                              street_number:
                                type: string
                                description: 街道门牌号
                              country_code_iso:
                                type: string
                                description: 国家英文缩写（三位）
                              town:
                                type: string
                                description: 乡镇名，需设置extensions_town=true时才会返回
                              district:
                                type: string
                                description: 区县名
                            description: 城市所在级别（仅国外有参考意义。国外行政区划与中国有差异，城市对应的层级不一定为『city』。country、province、city、district、town分别对应0-4级，若city_level=3，则district层级为该国家的city层级）
                          ret_code:
                            type: number
                            description: 0为成功，其余为失败
                          location:
                            type: object
                            properties:
                              lng:
                                type: number
                                description: 经度值
                              lat:
                                type: number
                                description: 纬度值
                            description: 经纬度坐标
                          formatted_address:
                            type: string
                            description: 结构化地址信息
                          business:
                            type: string
                            description: 坐标所在商圈信息，如 "人民大学,中关村,苏州街"。最多返回3个。
                        description: 业务返回体
      operationId: 238_3_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                lng:
                  type: string
                  description: 经度
                lat:
                  type: string
                  description: 维度
                from:
                  type: string
                  description: |-
                    经纬度类型 输入的坐标类型：
                    1：GPS设备获取的角度坐标; 
                    2：GPS获取的米制坐标、sogou地图所用坐标; 
                    3：google地图、soso地图、aliyun地图、mapabc地图和amap地图所用坐标 
                    4：3中列表地图坐标对应的米制坐标 5：百度地图采用的经纬度坐标 
                    6：百度地图采用的米制坐标 
                    7：mapbar地图坐标; 
                    8：51地图坐标
              required:
                - lng
                - lat
                - from
  /238-1:
    x-pointCode: 1
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 地址转经纬度
      description: 通过地址查询可获得结构化坐标，通常返回较高精确度结果，默认采用GCJ-02坐标系。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          confidence:
                            type: number
                            description: 可信度
                          level:
                            type: string
                            description: 地址类型
                          precise:
                            type: number
                            description: 位置的附加信息，是否精确查找。1为精确查找，0为不精确。
                          location:
                            type: object
                            properties:
                              lat:
                                type: number
                                description: 纬度
                              lng:
                                type: number
                                description: 经度
                            description: 位置座标（GCJ-02坐标系）
                        description: 业务返回体
      operationId: 238_1_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                address:
                  type: string
                  description: 要转换的地址
                city:
                  type: string
                  description: 所在城市
              required:
                - address
components:
  securitySchemes:
    AppKeyAuth:
      type: apiKey
      in: query
      name: appKey
      description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp
  schemas:
    ShowapiResEnvelope:
      type: object
      description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）
      properties:
        showapi_res_code:
          type: integer
          description: API 返回的状态码
        showapi_res_error:
          type: string
          description: API 返回的错误信息
        showapi_res_id:
          type: string
          description: API 请求的唯一标识
        showapi_fee_num:
          type: integer
          description: API 调用计费次数
security:
  - AppKeyAuth: []
externalDocs:
  url: https://www.showapi.com/apiGateway/view/238?tab=book
x-apiCode: "238"
x-is-own: false
x-is-op: false