您已全部設定完成!

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

啟用 Google Places API for Android

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

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

地點挑選器

地點挑選器 UI 小工具

地點挑選器是一個簡單而富彈性的內建 UI 小工具,屬於 Google Places API for Android 的一部分。

地點挑選器簡介

PlacePicker 會提供 UI 對話方塊,顯示互動式地圖和附近地點的清單,包括對應地理地址和本地商家的地點。使用者可以選擇某個地點,然後您的應用程式就可以擷取所選取之地點的詳細資料。

地點挑選器在開發您自己的 UI 小工具時提供下列優點:

  1. 使用者體驗與使用地點挑選器的其他應用程式(包括 Google 應用程式和第三方)一致。這表示您應用程式的使用者已經知道如何與地點挑選器互動。
  2. 地圖已經整合到地點挑選器。
  3. 內建輔助工具。
  4. 節省開發時間。

地點挑選器具有自動完成功能,會根據使用者搜索輸入而顯示地點預測。所有地點挑選器整合中都有此功能,因此您不需要執行額外操作即可啟用自動完成。如需自動完成的詳細資訊,請參閱地點自動完成

權限

如果您的應用程式使用地點挑選器,就必須要求 ACCESS_FINE_LOCATION 權限。

Android 6.0 Marshmallow 中的新權限模型



Android 6.0 Marshmallow 引進新的權限處理模型,簡化使用者安裝及升級應用程式的程序。假設您使用 8.1 版或更新的 Google Play 服務,您可以設定您的應用程式以使用 Android 6.0 Marshmallow SDK 做為目標,並使用新的權限模型。

如果您的應用程式支援新的權限模型,則使用者安裝或升級應用程式時,不需要授予任何權限。反之,當應用程式在執行階段需要權限時,則必須要求權限,而且系統會對使用者顯示要求權限的對話方塊。

如果要深入了解,請參閱 Android 6.0 Marshmallow 以及必須針對新的權限模型為您的應用程式所做的變更之相關文件。

新增地點挑選器

以下是啟動地點挑選器所需的步驟摘要:

  1. 使用 PlacePicker.IntentBuilder() 建構 Intent
  2. 如果您想要變更地點挑選器的預設行為,您可以使用製作工具來設定地點挑選器所顯示之地圖的初始緯度與經度邊界。在製作工具上呼叫 setLatLngBounds(),傳入 LatLngBounds 以設定初始緯度與經度邊界。這些邊界定義的區域稱為「檢視點」。根據預設,檢視點位於裝置位置的中間,以城市街區的層級縮放。
  3. 呼叫 startActivityForResult(),傳遞意圖和預先定義的要求代碼,以便您可以在結果傳回時識別要求。

下列程式碼片段會啟動地點挑選器:

int PLACE_PICKER_REQUEST = 1;
PlacePicker.IntentBuilder builder = new PlacePicker.IntentBuilder();

startActivityForResult(builder.build(this), PLACE_PICKER_REQUEST);

當使用者選取某個地點時,您可以透過呼叫 PlacePicker.getPlace() 來擷取該地點。如果使用者沒有選取地點,該方法將會傳回 null。

您也可以透過呼叫 PlacePicker.getLatLngBounds() 來擷取地圖的最近邊界。

下列程式碼片段會擷取使用者已選取的地點:

protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  if (requestCode == PLACE_PICKER_REQUEST) {
    if (resultCode == RESULT_OK) {
        Place place = PlacePicker.getPlace(data, this);
        String toastMsg = String.format("Place: %s", place.getName());
        Toast.makeText(this, toastMsg, Toast.LENGTH_LONG).show();
    }
  }
}

使用材料設計風格設定自訂色彩

如果您使用材料設計風格在應用程式中設定自訂色彩,地點挑選器會從風格主題繼承 colorPrimarycolorPrimaryDark 屬性。這可以方便您在應用程式和地點挑選器之間維持一致的風格。

在應用程式中顯示資料引用標示

當您的應用程式顯示透過地點挑選器所取得的資訊時,應用程式也必須顯示資料引用標示。請參閱有關資料引用標示的文件。

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

這個網頁
location_on
Google Places API for Android