纬度和经度查询位置 API 接口

概述

本文档描述了用于查询地理位置的 API 接口，该接口根据提供的纬度和经度值返回对应的地理位置信息。

接口端点

该接口使用以下端点：/api/location

请求方法

该接口支持以下请求方法：GET

请求参数

该接口需要以下请求参数：

• latitude

  (必填)：纬度值，浮点数。

• longitude

  (必填)：经度值，浮点数。

示例请求 URL：/api/location?latitude=34.0522&longitude=118.2437

响应格式

该接口返回 JSON 格式的数据，包含以下字段：

• status

  ：状态码，200 表示成功，其他值表示失败。

• message

  ：错误信息，成功时为空字符串。

• location周易算命网

  ：地理位置信息，包含以下字段：

  • city

    ：城市名称。

  • state

    ：省份名称。

  • country

    ：国家名称。

  • address

    ：详细地址。

  • latitude

    ：纬度值。

  • longitude

    ：经度值。

示例响应：

json

{"status": 200,"message": "","location": {"city": "北京","state": "北京市","country": "中国","address": "北京市海淀区上地十街","latitude": 34.0522,"longitude": 118.2437}

}

错误处理

如果请求参数无效或查询失败，接口将返回非 200 的状态码和相应的错误信息。

• status = 400

  ：请求参数错误。

• status = 500

  ：服务器内部错误。

示例错误响应 (400):

json

{

"status": 400,"message": "Invalid latitude or longitude value."

}

API 调用示例 (JavaScript)

javascript

fetch('/api/location?latitude=34.0522&longitude=118.2437').then(response => {if (!response.ok) {throw new Error('Network response was not ok');}return response.json();}).then(data => {console.log(data);if(data.status === 200){console.log(data.location.city);}}).catch(error => {console.error('Error:', error);});

限制

该接口可能存在请求频次限制，请遵守 API 使用协议。

版本号

版本 1.0

注意事项

请确保请求参数

latitude

和

longitude

的值正确。 请根据实际情况调整错误处理机制。 API 使用需遵循相应的协议和服务条款。

宝宝起名 在线起名