天地图接口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)

在这个示例中，我们将搜索条件转换为JSON格式，并通过HTTP POST请求发送到天地图的搜索接口。结果中包含了符合条件的地点信息。

三、注意事项

API Key：在使用天地图API之前，必须在天地图官网上注册账号并获取API Key。在代码中替换为你的实际API Key。
URL正确性：由于天地图的API可能会更新或变更，实际使用时请参考天地图官方文档中的正确URL。
请求频率：请注意API的请求频率限制，避免因为频繁请求导致API被封禁。
错误处理：在代码中添加适当的错误处理逻辑，以应对网络问题、API返回错误等情况。

四、总结

本文详细介绍了如何使用Python调用天地图接口，包括地理编码API、天气预报API和搜索接口。通过示例代码展示了如何发送HTTP请求、解析返回的JSON数据，并输出结果。这些示例代码具有一定的参考价值和实际意义，可以帮助开发者快速上手天地图API的开发工作。

在实际应用中，开发者可以根据具体需求进一步扩展和完善代码，例如添加用户输入、处理返回数据、展示在地图上等。希望本文对你有所帮助，祝你开发顺利！