GooglePlacesAPI调用教程全解析

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Google Places API调用教程详解》，聊聊，希望可以帮助到正在努力赚钱的你。

在Laravel PHP项目中，若需获取除基础地址信息外的更丰富地点详情，如商家评论、营业时间、联系方式和照片，仅依赖Google Maps Geocoding API是不够的。本教程将指导您如何通过Google Places API，特别是其“地点详情”服务，来获取这些商业相关的深度数据，从而实现更全面的地点信息展示与应用。

深入理解Google地图服务：Geocoding与Places API的区别

在开发基于地理位置的应用时，我们经常需要获取地点的详细信息。然而，Google提供了多个API来满足不同的需求，理解它们之间的区别是获取所需数据的关键。

最初，开发者可能倾向于使用Google Maps Geocoding API（或通过相关封装库，如lodge/postcode-lookup）来根据地址或邮政编码获取地理坐标和基础地址信息。例如，通过邮政编码查询，您可能得到以下结构的数据：

array:9 [▼
  "postcode" => "M5G1M7"
  "street_number" => "641"
  "street" => "Bay Street"
  "sublocality" => "Old Toronto"
  "town" => "Toronto"
  "county" => "Toronto"
  "country" => "Canada"
  "latitude" => 43.6569641
  "longitude" => -79.3839517
]

这类数据主要侧重于地理位置的解析，提供的是结构化的地址组件和经纬度。但当您需要更深层次的商业或地点相关信息时，例如餐厅的总评论数、每周营业时间、照片、电话号码、网站以及用户评论详情等，Geocoding API是无法提供的。这些丰富的数据属于Google Places API的范畴。

Google Places API专门用于提供关于全球数百万个地点的详细信息，包括但不限于商家、地标、地理特征等。它能够返回如营业状态、联系方式、评分、评论、照片等商业属性，这正是实现完整地点信息展示所必需的。

利用Google Places API获取地点详情

要获取一个地点的详细信息，您需要使用Google Places API的Place Details服务。这个服务需要一个place_id作为输入参数，place_id是Google用来唯一标识一个地点的字符串。

获取Place ID：

如果您只有地址或邮政编码，您首先需要通过其他Places API服务（如“Find Place”或“Place Search”）来获取目标地点的place_id。例如，您可以使用“Find Place”服务通过文本查询（如“某某餐厅，邮编M5G1M7”）来获取place_id。

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=某某餐厅%20M5G1M7&inputtype=textquery&fields=place_id&key=YOUR_API_KEY

Place Details请求：

一旦获得了place_id，就可以调用Place Details API来获取所有详细信息。请求的基本结构如下：

https://maps.googleapis.com/maps/api/place/details/json?place_id=YOUR_PLACE_ID&fields=name,formatted_address,formatted_phone_number,website,opening_hours,reviews,user_ratings_total,photos,geometry,business_status,icon&key=YOUR_API_KEY

请注意，fields参数非常重要。它允许您指定需要返回的数据字段，这不仅可以减少响应数据的大小，还能帮助您控制API的使用成本，因为某些字段的请求会产生额外的费用。

Laravel/PHP中实现Google Places API调用

在Laravel或任何PHP项目中，您可以通过HTTP客户端（如Guzzle或原生的cURL）来调用Google Places API。

步骤一：启用Google Places API

1. 访问Google Cloud Console。
2. 确保您已创建一个项目并启用结算功能。
3. 在API库中搜索并启用“Places API”。
4. 创建或使用现有的API密钥，并确保其具有访问Places API的权限。

步骤二：编写PHP代码调用API

以下是一个使用cURL进行API调用的示例：

<?php

function getPlaceDetails(string $placeId, string $apiKey): array
{
    $fields = [
        'name', 'formatted_address', 'formatted_phone_number', 'website',
        'opening_hours', 'reviews', 'user_ratings_total', 'photos',
        'geometry', 'business_status', 'icon', 'plus_code', 'rating',
        'address_components', 'international_phone_number', 'url', 'vicinity'
    ];
    $fieldsString = implode(',', $fields);

    $url = "https://maps.googleapis.com/maps/api/place/details/json?" .
           "place_id=" . urlencode($placeId) .
           "&fields=" . urlencode($fieldsString) .
           "&key=" . urlencode($apiKey);

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode !== 200) {
        // 错误处理
        error_log("Google Places API request failed with HTTP code: " . $httpCode . " Response: " . $response);
        return ['error' => 'API request failed', 'http_code' => $httpCode];
    }

    $data = json_decode($response, true);

    if (json_last_error() !== JSON_ERROR_NONE) {
        error_log("Failed to decode JSON response: " . json_last_error_msg());
        return ['error' => 'Failed to decode JSON response'];
    }

    if ($data['status'] === 'OK') {
        return $data['result'];
    } else {
        error_log("Google Places API returned status: " . $data['status'] . " Error message: " . ($data['error_message'] ?? 'N/A'));
        return ['error' => 'API returned non-OK status', 'status' => $data['status'], 'message' => ($data['error_message'] ?? '')];
    }
}

// 示例用法
$yourPlaceId = "ChIJN1t_tDeuEmsRUsoyG83frY4"; // 替换为您的Place ID
$yourApiKey = "YOUR_GOOGLE_API_KEY"; // 替换为您的Google API Key

$placeDetails = getPlaceDetails($yourPlaceId, $yourApiKey);

if (isset($placeDetails['error'])) {
    echo "Error: " . $placeDetails['error'];
    if (isset($placeDetails['message'])) {
        echo " - " . $placeDetails['message'];
    }
} else {
    echo "<h2>" . ($placeDetails['name'] ?? 'N/A') . "</h2>";
    echo "<p>地址: " . ($placeDetails['formatted_address'] ?? 'N/A') . "</p>";
    echo "<p>电话: " . ($placeDetails['formatted_phone_number'] ?? 'N/A') . "</p>";
    echo "<p>网站: <a href='" . ($placeDetails['website'] ?? '#') . "'>" . ($placeDetails['website'] ?? 'N/A') . "</a></p>";
    echo "<p>评分: " . ($placeDetails['rating'] ?? 'N/A') . " (" . ($placeDetails['user_ratings_total'] ?? '0') . " 评论)</p>";

    if (isset($placeDetails['opening_hours']['weekday_text'])) {
        echo "<h3>营业时间:</h3><ul>";
        foreach ($placeDetails['opening_hours']['weekday_text'] as $dayHours) {
            echo "<li>" . $dayHours . "</li>";
        }
        echo "</ul>";
    }

    if (isset($placeDetails['reviews'])) {
        echo "<h3>最新评论:</h3><ul>";
        foreach ($placeDetails['reviews'] as $review) {
            echo "<li><strong>" . ($review['author_name'] ?? '匿名') . ":</strong> " . ($review['text'] ?? 'N/A') . " (评分: " . ($review['rating'] ?? 'N/A') . ")</li>";
        }
        echo "</ul>";
    }

    // 更多数据处理...
}

?>

示例响应数据结构解析：

当API调用成功后，您将获得一个包含丰富数据的JSON响应。以下是其中一些关键字段的说明：

• name: 地点名称，如“Google Workplace 6”。
• formatted_address: 格式化的完整地址。
• formatted_phone_number / international_phone_number: 电话号码。
• website: 官方网站链接。
• opening_hours: 营业时间信息，包括weekday_text（人类可读的每周营业时间）和periods（结构化的开闭时间）。
• reviews: 用户评论数组，每条评论包含作者、评分、文本内容等。
• user_ratings_total: 总评论数。
• rating: 平均评分。
• photos: 地点照片数组，包含photo_reference（用于获取照片的引用）。
• geometry: 包含location（经纬度）和viewport信息。
• business_status: 商家运营状态（如“OPERATIONAL”）。
• place_id: 该地点的唯一标识符。

注意事项与最佳实践

1. API Key 安全： 永远不要将您的API Key直接暴露在前端代码中。在后端进行API调用，并通过服务器端处理数据。
2. 费用管理： Google Places API是付费服务，不同的请求类型和返回字段会产生不同的费用。务必仔细阅读Google的计费文档，并通过fields参数精确控制所需数据，以优化成本。
3. 错误处理： 在您的代码中加入健壮的错误处理机制，检查API响应状态（status字段），并处理可能的网络错误或API限制。
4. 速率限制： Google API有请求速率限制。如果您的应用需要进行大量请求，考虑实现请求队列、缓存机制或使用批量请求（如果API支持）。
5. 数据本地化： 可以通过在请求中添加language参数来获取特定语言的地点信息。
6. Place ID 缓存： 如果您频繁查询同一个地点，可以考虑将place_id及其详细信息缓存起来，以减少API调用和提高响应速度。

总结

通过本教程，您应该已经掌握了如何利用Google Places API获取比Geocoding API更详细、更丰富的地点信息。从获取place_id到调用Place Details服务，再到解析返回的JSON数据，这些步骤将使您能够构建出功能更强大、信息更全面的地理位置相关应用。记住，合理利用API密钥、管理费用和处理错误是成功集成Google服务的关键。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。