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提供了全面的地點和周邊設施的信息，適用于需要進行地點分析和可達性研究的應用場景。用戶可以根據需求選擇相應的功能模塊進行集成。