如何使用Google Places API搜索“我附近的公寓”

要使用 Google Places API 搜索“我附近的公寓”，您需要遵循以下步骤：

步骤 1: 获取 API 密钥

创建 Google Cloud 项目：
- 登录到 Google Cloud Console.
- 创建一个新项目或选择一个现有项目。
启用 Places API：
- 在 Google Cloud Console 中，导航到“API 和服务” > “库”。
- 搜索并启用 Places API。
获取 API 密钥：
- 在“API 和服务” > “凭据”中，创建一个新的 API 密钥。
- 记下这个密钥，您将在后续步骤中使用它。

步骤 2: 使用 Places API 进行搜索

Google Places API 提供了多种搜索功能，您可以使用 Nearby Search 来查找附近的公寓。以下是一个基本的 HTTP 请求示例，您可以使用它来搜索附近的公寓。

请求示例

GET https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=LATITUDE,LONGITUDE&radius=1500&type=apartment&key=YOUR_API_KEY

location: 您的当前位置的纬度和经度（例如 37.7749,-122.4194）。
radius: 搜索半径（以米为单位），例如 1500 表示 1.5 公里。
type: 设置为 apartment 以搜索公寓。
key: 您的 API 密钥。

示例请求

假设您在旧金山，纬度和经度为 37.7749,-122.4194，您的请求可能如下所示：

GET https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7749,-122.4194&radius=1500&type=apartment&key=YOUR_API_KEY

步骤 3: 处理响应

API 将返回一个 JSON 响应，其中包含附近公寓的详细信息。以下是响应的示例结构：

{
  "results": [
    {
      "geometry": {
        "location": {
          "lat": 37.7749,
          "lng": -122.4194
        }
      },
      "name": "Example Apartment",
      "vicinity": "123 Main St, San Francisco, CA",
      "place_id": "ChIJN1t_tDeuEmsR8w8g0g0g0g0"
    }
  ],
  "status": "OK"
}

results: 包含找到的公寓列表。
name: 公寓的名称。
vicinity: 公寓的地址。
geometry: 包含公寓的地理位置（纬度和经度）。

步骤 4: 错误处理

确保在代码中处理可能的错误，例如无效的 API 密钥、超出配额等。API 响应中会包含状态码，您可以根据状态码进行相应的处理。

示例代码

以下是一个使用 JavaScript 和 Fetch API 的简单示例，展示如何调用 Google Places API：

const fetchApartments = async (latitude, longitude) => {
  const apiKey = 'YOUR_API_KEY';
  const radius = 1500; // 1.5 km
  const type = 'apartment';
  
  const url = `https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=${latitude},${longitude}&radius=${radius}&type=${type}&key=${apiKey}`;
  
  try {
    const response = await fetch(url);
    const data = await response.json();
    
    if (data.status === 'OK') {
      console.log('Nearby Apartments:', data.results);
    } else {
      console.error('Error fetching data:', data.status);
    }
  } catch (error) {
    console.error('Error:', error);
  }
};

// 使用您的位置调用函数
fetchApartments(37.7749, -122.4194);