您已全部設定完成!

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

啟用 Google Maps Android API

為協助您開始,我們將先引導您使用 Google Developers Console 來執行一些動作:

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

開始使用

此指南是新增地圖到 Android 應用程式的快速入門指南。 Android Studio 是使用 Google Maps Android API 建置應用程式的建議開發環境。

步驟 1. 下載 Android Studio

依照指南下載安裝 Android Studio。

步驟 2. 安裝 Google Play Services SDK

Google Play 服務套件新增至 Android Studio。

步驟 3. 建立「Google 地圖」專案

依照這些步驟建立包括地圖活動的新應用程式專案:

  1. 啟動 Android Studio。
  2. 建立新專案,如下所示:

    • 如果您看見 [Welcome to Android Studio] 對話方塊,請在對話方塊右側的 [Quick Start] 下,選擇 [Start a new Android Studio project]。

    • 否則,在 Android Studio 中,依序按一下 [File]、[New]、[New Project]。

  3. 在系統提示時,輸入您的應用程式名稱、公司網域與專案位置。 接著,按一下 [Next]。

  4. 為您的應用程式選取所需的尺寸規格。 如果您不確定所需的規格,請選取 [Phone and Tablet]。 接著,按一下 [Next]。

  5. 在 [Add an activity to Mobile] 對話方塊中,選取 [Google Maps Activity]。 接著,按一下 [Next]。
  6. 在系統提示時,輸入活動名稱、版面配置名稱與標題。 使用預設值即可。 接著,按一下 [Finish]。

Android Studio 會啟動 Gradle 並建置您的專案。 這可能需要幾秒鐘。 如需在 Android Studio 中建立專案的詳細資訊,請參閱 Android Studio 文件

建置完成之後,Android Studio 會在編輯器中開啟 google_maps_api.xmlMapsActivity.java 檔案。 (請注意,您的活動可能會有不同的名稱,但是它就是您在設定期間設置的活動。) 請注意,在您嘗試執行應用程式之前,請依照 google_maps_api.xml 檔案所包含的操作說明執行,先取得 Google Maps API 金鑰。

下一節會更詳細說明取得 API 金鑰的方式。

步驟 4. 取得 Google Maps API 金鑰

您的應用程式需要 API 金鑰才能存取「Google 地圖」伺服器。 您需要的金鑰類型是僅限 Android 應用程式使用的 API 金鑰。 金鑰是免費的。 您可以搭配呼叫 Google Maps Android API 的應用程式使用它,而且它支援的使用者數目沒有限制。

選擇下列其中一種方式從 Android Studio 取得您的 API 金鑰:

  • 最快速、簡單的方式:使用 Android Studio 為您建立的 google_maps_api.xml 檔案中提供的連結:
    1. 複製 google_maps_api.xml 檔案中提供的連結,然後在您的瀏覽器中貼上。該連結會帶您前往 Google API Console,並透過 URL 參數提供前往 Google API Console 的必要資訊,進而減少需要您手動輸入的次數。
    2. 依照指示在 Google API Console 上建立新的專案,或選取現有的專案。
    3. 為您的專案建立 Android 限定 API 金鑰。
    4. 複製產生的 API 金鑰,返回 Android Studio,然後將 API 金鑰黏貼到 google_maps_api.xml 檔案中的 <string> 元素。
  • 稍微慢一點的方式:使用 Android Studio 為您建立的 google_maps_api.xml 檔案中提供的憑證:
    1. 複製 google_maps_api.xml 檔案中提供的憑證。
    2. 在您的瀏覽器中前往 Google API Console
    3. 使用複製的憑證,將您的應用程式新增至現有的 API 金鑰,或建立新的 API 金鑰。
  • 取得 API 金鑰的完整程序: 如果對您的情況而言,上述選項均不適用,請依照完整程序執行。

步驟 5. Hello Map! 看看這段程式碼

檢查範本提供的程式碼。 尤其是請查看您 Android Studio 專案中的下列檔案:

XML 版面配置檔案

根據預設,定義應用程式版面配置的 XML 檔案位於 res/layout/activity_maps.xml。 它包含下列程式碼:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/map"
    tools:context=".MapsActivity"
    android:name="com.google.android.gms.maps.SupportMapFragment" />

地圖活動 Java 檔案

根據預設,定義地圖活動的 Java 檔案稱為 MapsActivity.java。 它應該在您的套件名稱後面包含下列程式碼:

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;

public class MapsActivity extends FragmentActivity implements OnMapReadyCallback {

    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;

        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
    }
}

如果您的地圖活動檔案不包含上述程式碼,請在您的套件名稱後面,以上述程式碼取代該檔案的內容。

步驟 6. 連接 Android 裝置

查看應用程式運作情況最簡單的方法是,將 Android 裝置連接到您的電腦。 依照指示啟用 Android 裝置上的開發人員選項,然後設定您的應用程式與系統,以偵測該裝置。

或者,您也可以使用 Android Emulator 來執行您的應用程式。 使用 Android Virtual Device (AVD) Manager 設定一或多個虛擬裝置,以便在建置和執行您的應用程式時與 Android Emulator 搭配使用。

當您選擇模擬器時,請務必使用 Android 4.2.2 或更高版本並謹慎挑選包含 Google API 的映像,否則應用程式不會有執行所需的必要執行階段 API。

此外,請記下設定虛擬機器加速的操作說明,您應該如操作說明中所述,與 x86 目標 AVD 搭配使用。

這將可改善使用模擬器時的體驗。

步驟 7. 建置並執行您的應用程式

在 Android Studio 中,按一下 [Run] 選單選項(或執行按鈕圖示)以執行您的應用程式。

提示您選擇裝置時,選擇下列其中一個選項:

  • 選取與您的電腦連接的 Android 裝置。
  • 或者,選取 [Launch emulator] 選項按鈕,然後選擇您先前設定的虛擬裝置。

按一下 [OK]。 Android Studio 將會呼叫 Gradle 來建置您的應用程式,然後在裝置或模擬器上顯示結果。 需要數分鐘才會開啟應用程式。

您應該能看見有個標記放在澳洲雪梨的地圖。 如果您沒看到地圖,請確定您已完成此頁面所述的所有步驟。

特別是要檢查您已如上所述新增 API 金鑰。

後續步驟

您或許想要查看一些範例程式碼

您可以閱讀開發人員指南中地圖物件的詳細資訊。

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

這個網頁
Google Maps Android API
Google Maps Android API
需要協助嗎?請前往我們的支援網頁