您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Places API for Android

為協助您開始,我們將先引導您使用「Google 開發人員控制台」來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Places API for Android
  3. 建立適當的金鑰
繼續

開始使用

本指南介紹 Google Places API for Android 中的功能,並說明如何設定您的應用程式以使用 API。

  1. 簡介和概念
  2. API 總覽
  3. 支援的 Android 平台版本
  4. 設定應用程式
    1. 設定 Google Play 服務
    2. 新增您的 API 金鑰
    3. 要求提高使用限制
  5. 連線到 Places API

簡介和概念

Google Places API for Android 的主要進入點是 PlacePicker UI 小工具、Autocomplete UI 小工具、GeoDataApiPlaceDetectionApi

使用 Google Places API for Android,您可以建置位置感知應用程式,可根據周遭環境來回應裝置附近的本地商家和其他地點。這表示您可以根據對使用者有意義的地方資訊來建置豐富的應用程式,補足 Android 位置服務所提供的簡單地理位置服務。

「地點」定義為具有名稱的實體空間。另一個思考「地點」的方式是您可以在地圖上找到的任何事物。這些範例包括本地商家、搜尋點和地理位置。在 API 中,地點是由 Place 介面表示。它包括如地點的名稱及其地址、地理位置、地點 ID、電話號碼、地點類型與網站 URL 等資訊。

API 總覽

協助您的客戶探索他們的所在位置,以及位於周遭的事物:

  • 使用內建的地點挑選器 UI 小工具,讓使用者在互動式地圖上選取地點。
  • 取得目前地點,也就是裝置最後已知位置的地點。API 會傳回可能的地點清單,以及針對每個地點的相對可能性指示。
  • 輕鬆輸入地點名稱與地址 - 在使用者輸入的同時自動完成使用者的查詢。使用自動完成 UI 小工具,或呼叫 API 進行地點預測。
  • 擷取並顯示豐富的地點相關資訊
  • 存取高品質的地點相片

提供最新的在地資訊,凸顯您的應用程式:

  • 新增地點到「Google 地方資訊」資料庫,可立即從您自己的應用程式擷取,通過仲裁後也能對其他應用程式顯示。
  • 回報地點,指出裝置目前位於特定地點。
  • 針對一或多個地點儲存唯一的地點 ID,並且視需要使用 ID 來擷取地點資訊。

API 的其他重點包括:

  • 透過低功率的 WiFi 掃描,精確地偵測地點。
  • 裝置快取:Google Places API for Android 的大多數要求都會傳送至 Google 伺服器,但是您也可以在本機上快取資料 30 天。

支援的 Android 平台版本

Google Play 服務支援的所有 Android 版本都能使用 Google Places API for Android。請參閱支援不同平台版本的 Android 指南。

設定應用程式

使用 Google Places API for Android 的所有應用程式都必須進行下列設定步驟。

設定 Google Play 服務

如果要存取 Google Places API for Android,您的應用程式開發專案必須包括 Google Play 服務。請透過 SDK Manager 下載並安裝 Google Play 服務元件,然後將程式庫新增到您的專案。如需詳細資訊,請參閱設定 Google Play 服務的 Android 指南。

新增您的 API 金鑰



如果您尚未取得 API 金鑰並啟用 Google Places API for Android,請依照註冊指南中的指示立即取得。

依照下列程式碼範例,使用您自己的 API 金鑰取代 YOUR_API_KEY,將您的 API 金鑰新增到應用程式宣示說明:

<application>
  ...
  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="YOUR_API_KEY"/>
</application>

要求提高使用限制

所有應用程式使用 Google Places API for Android 完全免費,而且沒有限制。然而,為了確保讓所有應用程式都能公平使用,某些方法需受分層查詢限制規範。

Google Places API for Android 會強制套用每 24 小時期間 1,000 個要求的預設限制。如果您的應用程式超過此限制,應用程式將會開始失敗。

當應用程式達到每 24 小時期間 150,000 個要求時,還會有一個檢查點。如果您的應用程式超過此限制,應用程式將會再次開始失敗。

如果預期會超過允許的預設要求數目,請儘早採取步驟以增加您的限制。請參閱使用限制指南。

連線到 Places API

下列介面提供 Google Places API for Android 的主要進入點:

  • GeoDataApi 提供對 Google 資料庫中本地地點與商家資訊的存取。
  • PlaceDetectionApi 可以快速存取裝置的目前位置,並且可以報告裝置位於某個特定地點。

如果要連線到 API,您必須建立 Google Play 服務 API 用戶端實例。在片段或活動的 onCreate() 方法中,使用 GoogleApiClient.Builder 建立 Google API 用戶端的實例。使用製作工具新增必要的 API,如下列程式碼範例所示:

import com.google.android.gms.common.api.GoogleApiClient;
import com.google.android.gms.common.api.GoogleApiClient.OnConnectionFailedListener;
import android.support.v4.app.FragmentActivity;

public class MyActivity extends FragmentActivity 
        implements OnConnectionFailedListener {
    private GoogleApiClient mGoogleApiClient;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mGoogleApiClient = new GoogleApiClient
                .Builder(this)
                .addApi(Places.GEO_DATA_API)
                .addApi(Places.PLACE_DETECTION_API)
                .enableAutoManage(this, this)
                .build();
    }

    // TODO: Please implement GoogleApiClient.OnConnectionFailedListener to
    // handle connection failures.
}

如程式碼範例中所示,Places 類別提供的語彙基元,可用來傳遞 GoogleApiClient.Builder 以啟用 GeoDataApiPlaceDetectionApi

如需有關使用用戶端的詳細資訊,請參閱存取 Google API 的 Android 指南。尤其,請參閱啟動連線處理連線失敗的指南,瞭解有關 addConnectionCallbacks()addOnConnectionFailedListener() 的詳細資訊。

傳送您對下列選項的寶貴意見...

這個網頁
location_on
Google Places API for Android