Python采用高德api实现地图功能

ddclare 2024-10-05 11:05:16 阅读 75

前言

        最近打算做一些地图可视化的工作,然后发现可以借助高德api来在地图上进行批量标记、画多边形。

介绍

        高德地图为个人开发者开放了一定免费次数的api,包括地理/逆地理编码、路径规划、行政区域查询、交通事件、IP定位、坐标转换等服务。(详情可见高德开放平台高德开放平台 | 高德地图API (amap.com))

准备工作

1. 申请高德地图api服务

    搜索“高德地图开放平台”或者“高德地图api”,进入官网,登录账号。

2. 进入控制台(右上方),点击应用管理-我的应用,然后添加key

3. 添加key,服务平台选择Web服务,其他的自己随意填写咯

4. 记下key,后面的每次调用都需要这个key

开冲

1.地理/逆地理编码

    

        地理编码/逆地理编码 API 是通过 HTTP/HTTPS 协议访问远程服务的接口,提供结构化地址与经纬度之间的相互转化的能力。

适用场景

    地理编码:将详细的结构化地址转换为高德经纬度坐标。且支持对地标性名胜景区、建筑物名称解析为高德经纬度坐标。    逆地理编码:将经纬度转换为详细结构化的地址,且返回附近周边的POI、AOI信息。


I. 地理编码

地理api服务地址

URL https://restapi.amap.com/v3/geocode/geo?parameters
请求方式 GET

        parameters代表可选参数,参数间使用符号“&”连接,参数见下表。

请求参数

参数名 含义 是否必须 缺省值
key 高德key,用户在官网申请Web服务API类型的key 必须
address 结构化的地址信息 必须
city 指定查询的城市,可选输入内容包括:指定城市的中文(如北京)、指定城市的中文全拼(beijing)、citycode(010)、adcode(110000) 可选 无,会进行全国范围内的搜索
sig 数字签名 可选
output 返回数据格式类型,json或xml 可选 json
callback 回调函数,只在 output 参数设置为 JSON 时有效 可选

返回参数

参数名 含义 规则说明
status 返回结果状态值 返回值为0或1,0表示请求失败,1表示请求成功
count 返回结果数目 返回结果个数
info 返回状态说明 当 status 为 0 时,info 会返回具体错误原因,否则返回“OK”(info详情见官网)
geocodes 地理编码信息列表 返回结果对象列表

country 国家 默认返回中国
province 例如:北京市。此处需要注意的是,中国的四大直辖市也算作省级单位。
city 例如:北京市
citycode 城市编码 例如:010
district 行政区 例如:朝阳区
street 街道 例如:阜通东大街
number 门牌 例如:6号
adcode 区域编码 例如:110101
location 坐标点 经度,纬度
level 匹配级别

示例

查询北京市朝阳区阜通东大街6号的地址信息

import requests

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区阜通东大街6号&key=<your key>'

response = requests.get(url)

json_response = response.json()

使用特定浏览器查询

headers = {

'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36',

}

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区阜通东大街6号&key=<your key>'

response = requests.get(url, headers=headers)

json_response = response.json()

模糊查找

        全国有很多同名街道,当地址不规范的时候,往往会返回很多个结果,此时添加限定条件将提高搜索的准确性。                                                                                                                         

添加城市

headers = {

'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36',

}

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京路&key=<your key>'

response = requests.get(url, headers=headers)

json_response = response.json()

           如果仅仅搜索北京路,会返回多个地方的信息,例如白银市的北京路、金昌市的北京路。   

        若要查找广州市的北京路,则需加上city=广州的限定条件。以下几种写法均可:

<code># 拼音

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京路&city=guangzhou&key=<your key>'

# 中文字符

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京路&city=广州&key=<your key>'

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京路&city=广州市&key=<your key>'

# 区号

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京路&city=020&key=<your key>'

# adcode

url = 'https://restapi.amap.com/v3/geocode/geo?address=北京路&city=440100&key=<your key>'

       

II.逆地理编码                                                                                  

逆地理api服务地址

URL https://restapi.amap.com/v3/geocode/regeo?parameters
请求方式 GET

        parameters代表可选参数,参数间使用符号“&”连接,参数见下表。

请求参数

参数名 含义 是否必须 缺省值
key 高德key,用户在官网申请Web服务API类型的key 必须
location 经纬度坐标,经度在前,纬度在后,经纬度间以“,”分割,经纬度小数点后不要超过 6 位。 必须
poitype POI类型,逆地理编码在进行坐标解析之后不仅可以返回地址描述,也可以返回经纬度附近符合限定要求的 POI 内容(在 extensions 字段值为 all 时才会返回 POI 内容)。设置 POI 类型参数相当于为上述操作限定要求。 可选
radius 搜索半径,radius 取值范围:0~3000,默认值:1000。单位:米 可选 1000
extensions 返回结果控制,取值为base时返回基本地址信息,取值为all时返回基本地址信息、附近POI内容、道路信息以及道路交叉口信息 可选 base
roadlevel 道路等级,该参数需要extensions为all时生效。可选值:0或1,当roadlevel为0显示所有道路,当roadlevel为1时过滤非主干路,仅输出主干路信息 可选
sig 数字签名,详情参考官网 可选
output 返回数据类型格式,可选输入json或xml。设置 JSON 返回结果数据将会以 JSON 结构构成;如果设置 XML 返回结果数据将以 XML 结构构成 可选 json
callback 回调函数,callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效 可选
homeorcorp 是否优化poi的返回顺序,以下内容需要 extensions 参数为 all 时才生效。

homeorcorp 参数的设置可以影响召回 POI 内容的排序策略,目前提供三个可选参数:

0:不对召回的排序策略进行干扰。

1:综合大数据分析将居家相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi 顺序。

2:综合大数据分析将公司相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi 顺序

可选 0

返回参数

示例

查询特定坐标的地址信息

<code>import requests

headers = {

'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36',

}

url = 'https://restapi.amap.com/v3/geocode/regeo?location=116.310003,39.991957&key=<your key>'

response = requests.get(url, headers=headers)

json_response = response.json()

print(json_response)

查询特定坐标方圆三公里内的地址信息

<code>import requests

headers = {

'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Safari/537.36',

}

url = 'https://restapi.amap.com/v3/geocode/regeo?location=116.310003,39.991957&radius=3000&key=<your key>'

response = requests.get(url, headers=headers)

json_response = response.json()

print(json_response)

返回详细的道路信息、附近POI等

url = 'https://restapi.amap.com/v3/geocode/regeo?location=116.310003,39.991957&extensions=all&key=<your key>'

仅返回主干路

url = 'https://restapi.amap.com/v3/geocode/regeo?location=116.310003,39.991957&roadlevel=1&key=<your key>'

一些小问题

如何知道headers的值

不输入headers的话自动使用默认浏览器进行,而如果我想要指定浏览器就需要输入相应的headers。本人用的是火狐浏览器,就以这个作为例子,其他浏览器也是这种操作。先随便打开一个网页

然后打开开发者模式(按F12)

        等左边的事务加载完成后,随便点击一个

接着右边往下拉,找到User-Agent这一项,这个就是headers啦。



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。