天地图接口Python代码详解

天地图是中国国家测绘地理信息局推出的一款权威、全面的在线地理信息系统，提供了丰富的卫星影像、地形、矢量图等地图资源。开发者可以通过天地图提供的API接口，实现地图的展示、搜索、定位等功能。本文将详细介绍如何使用Python调用天地图接口，包括理论概述和详细的代码示例。

一、理论概述

1. 天地图接口基础信息

坐标系统：天地图默认使用的坐标系统为WGS84坐标系。例如，经纬度坐标（116.35506,39.92277）代表北京的一个位置。
服务地址：天地图的外网服务地址为http://www.tianditu.com/，具体API接口的URL会根据不同的功能有所不同。
请求数据格式：天地图API的请求数据格式一般为JSON。

2. 常用接口类型

地理编码API：将结构化地址数据（如：北京市海淀区莲花池西路28号）转换为对应坐标点（经纬度）。
天气预报API：根据城市代码返回当前天气信息。
搜索接口：包括关键词搜索、周边搜索、拉框搜索等，返回地图上的相关信息。

3. 调用接口前的准备工作

注册账号：在天地图官网上注册账号，获取自己的API Key。
阅读文档：详细阅读天地图官方提供的API文档，了解各个接口的具体用法和参数。

二、代码示例

下面将通过几个具体的代码示例，展示如何使用Python调用天地图的接口。

1. 调用地理编码API

地理编码API可以将地址转换为经纬度坐标。以下是使用Python调用天地图地理编码API的示例代码：

import requests# 替换为你的天地图API Key
api_key = '你的API Key'# 地址信息
address = '北京市延庆区延庆镇莲花池村前街50夕阳红养老院'# 地理编码API接口URL
geocoder_url = f'http://api.tianditu.gov.cn/geocoder?ds={{"keyWord":"{address}"}}&tk={api_key}'# 发送HTTP GET请求
response = requests.get(geocoder_url)# 解析返回的JSON数据
geocoder_data = response.json()# 输出结果
print(geocoder_data)

在这个示例中，我们首先将地址信息和API Key拼接成请求的URL，然后发送HTTP GET请求，并解析返回的JSON数据。结果中包含了地址对应的经纬度坐标。

2. 调用天气预报API

天气预报API可以根据城市代码返回当前天气信息。以下是使用Python调用天地图天气预报API的示例代码：

import requests# 替换为你的天地图API Key
api_key = '你的API Key'# 城市代码，例如北京的城市代码是101010100
city_code = '101010100'# 注意：这里的URL示例可能有误，实际使用时请参考天地图官方文档
# 天气预报API接口URL（示例）
weather_url = f'https://api.map.baidu.com/telematics/v3/weather?location={city_code}&output=json&ak={api_key}'# 发送HTTP GET请求
response = requests.get(weather_url)# 解析返回的JSON数据
weather_data = response.json()# 输出结果
print(weather_data)

请注意，由于天地图的天气预报API可能与示例中的URL有所不同，实际使用时请参考天地图官方文档中的正确URL。

3. 调用搜索接口

搜索接口可以根据关键词、位置等条件返回地图上的相关信息。以下是使用Python调用天地图搜索接口的示例代码：

import requests
import json# 替换为你的天地图API Key
api_key = '你的API Key'# 搜索条件
search_params = {"keyWord": "银行","level": "15","mapBound": "116.37552,39.8935,116.42102,39.91804","queryType": "2","count": "20","start": "0"
}# 搜索接口URL
search_url = 'http://www.tianditu.com/query.shtml'# 将搜索条件转换为JSON格式
post_str = json.dumps(search_params)# 发送HTTP POST请求
response = requests.post(search_url, params={'type': 'query', 'postStr': post_str})# 解析返回的JSON数据
search_data = response.json()# 输出结果
print(search_data)