Geoapify地点详情API开发指南

概述

本API提供了一系列功能，旨在为用户提供地点的详细信息、周边设施以及可达性分析。以下是各个功能模块的概述及代码示例。

功能模块

1. 地点详情

• 详细信息：获取指定地点的详细信息和几何形状。
• 人口数据：提供按年份的人口信息（需额外请求）。
• 国际名称：添加地点的国际名称（需额外请求）。
• 原始几何：返回地点的原始几何信息（需额外请求）。

代码示例：

import requests

# 获取地点详细信息
def get_location_details(location_id):
    response = requests.get(f"https://api.example.com/details/{location_id}")
    return response.json()

# 获取人口数据
def get_population_data(location_id):
    response = requests.get(f"https://api.example.com/details/{location_id}/population")
    return response.json()

# 获取国际名称
def get_international_names(location_id):
    response = requests.get(f"https://api.example.com/details/{location_id}/names")
    return response.json()

# 获取原始几何
def get_full_geometry(location_id):
    response = requests.get(f"https://api.example.com/details/{location_id}/full_geometry")
    return response.json()

2. 建筑信息

• 建筑详情：根据指定地点或坐标查找建筑，并返回建筑的详细信息和几何形状。
• 建筑内设施：获取建筑内的商业、住宿、体育、服务、租赁、医疗、儿童、娱乐和餐饮等类别的地点信息。

代码示例：

# 获取建筑详情
def get_building_details(location_id):
    response = requests.get(f"https://api.example.com/building/{location_id}")
    return response.json()

# 获取建筑内的商业设施
def get_building_commercial(location_id):
    response = requests.get(f"https://api.example.com/building/{location_id}/commercial")
    return response.json()

3. 半径查询

• 半径100米：获取指定地点周围100米内的设施信息，如超市、餐厅、咖啡馆和公共厕所。
• 半径500米：获取指定地点周围500米内的设施信息，包括学校、酒店、游乐场、ATM等。
• 半径1000米：获取指定地点周围1000米内的设施信息，涵盖更广泛的类别。

代码示例：

# 获取半径100米内的超市
def get_radius_100_supermarket(location_id):
    response = requests.get(f"https://api.example.com/radius_100/{location_id}/supermarket")
    return response.json()

# 获取半径500米内的学校
def get_radius_500_school(location_id):
    response = requests.get(f"https://api.example.com/radius_500/{location_id}/school")
    return response.json()

# 获取半径1000米内的公园
def get_radius_1000_park(location_id):
    response = requests.get(f"https://api.example.com/radius_1000/{location_id}/park")
    return response.json()

4. 步行可达性

• 步行5分钟：获取在5分钟步行范围内的设施信息。
• 步行10分钟：获取在10分钟步行范围内的设施信息。
• 步行15分钟：获取在15分钟步行范围内的设施信息。
• 步行30分钟：获取在30分钟步行范围内的设施信息。

代码示例：

# 获取步行5分钟内的超市
def get_walk_5_supermarket(location_id):
    response = requests.get(f"https://api.example.com/walk_5/{location_id}/supermarket")
    return response.json()

5. 驾车可达性

• 驾车5分钟：获取在5分钟驾车范围内的设施信息。
• 驾车10分钟：获取在10分钟驾车范围内的设施信息。
• 驾车15分钟：获取在15分钟驾车范围内的设施信息。

代码示例：

# 获取驾车5分钟内的超市
def get_drive_5_supermarket(location_id):
    response = requests.get(f"https://api.example.com/drive_5/{location_id}/supermarket")
    return response.json()

注意事项

• 某些功能需要额外的请求来获取更详细的信息，如人口数据、国际名称和原始几何。
• 用户在使用API时，应注意请求的频率和数量，以避免超出限额。

结论

本API提供了全面的地点和周边设施的信息，适用于需要进行地点分析和可达性研究的应用场景。用户可以根据需求选择相应的功能模块进行集成。