開始使用

此指南是新增地圖到 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 地圖」伺服器。 您需要的金鑰類型是 Key for Android applications。金鑰是免費提供。 您可以搭配呼叫 Google Maps Android API 的應用程式使用它,而且支援的使用者數目沒有限制。

選擇下列其中一種方式來取得 API 金鑰:

  • 最快速、簡單的方式:使用 Android Studio 為您建立的 google_maps_api.xml 檔案中提供的連結:

    1. 複製 google_maps_api.xml 檔案中提供的連結,然後在您的瀏覽器中貼上。該連結會帶您前往 Google Developers Console,並透過 URL 參數提供資訊,進而減少需要您手動輸入的次數。
    2. 依照指示在控制台上建立新的專案,或選取現有的專案。
    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 Developers Console
    3. 使用複製的認證,將您的應用程式新增至現有的 API 金鑰,或建立新的 API 金鑰。 如需更多詳細資料,請參閱完整程序
  • 取得 API 金鑰的完整程序:如果對您的情況而言,上述選項均不適用,請依照完整程序執行。

注意:如果您正在使用 Google Maps Mobile SDK for Work,您必須針對 Google Developers Console 上的 API 專案另外啟用 Google Maps Mobile SDK for Work

步驟 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 {
    @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 map) {
        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        map.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        map.moveCamera(CameraUpdateFactory.newLatLng(sydney));
    }
}

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

步驟 6.連接 Android 裝置

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

或者,您也可以使用 Android 模擬器來執行您的應用程式。 使用 Android Virtual Device (AVD) Manager 設定一或多個虛擬裝置,以便在建置和執行您的應用程式時與 Android 模擬器搭配使用。您需要具有 Google API 平台 (以 Android 4.2.2 或更高版本為基礎) 的模擬器映像。請記下設定虛擬機器加速的指示,您應該如指示中所述,與 x86 目標 AVD 搭配使用。這將可改善使用模擬器時的體驗。

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

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

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

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

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

您應該能看見有個標記放在澳洲雪梨的地圖。 如果您沒看到地圖,請確定您已完成此頁面所述的所有步驟。特別是要檢查您已如上所述新增 API 金鑰。

後續步驟

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

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

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

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