Начало работы

В этом руководстве содержится информация для быстрого добавления карты в приложение Android. Для создания приложений с использованием Google Maps Android API рекомендуемой средой разработки является Android Studio.

Шаг 1. Загрузите Android Studio

Следуйте указаниям по загрузке и установке Android Studio.

Шаг 2. Установите Google Play Services SDK.

Добавьте пакет служб Google Play в Android Studio.

Шаг 3. Создайте проект Google Maps

Выполните следующие действия для создания проекта нового приложения, включая добавление операции с картой.

1. Запустите Android Studio.

2. Создайте новый проект, выполнив следующие действия.

   • Если вы видите окно Welcome to Android Studio, выберите Start a new Android Studio project в разделе 'Quick Start' с правой стороны окна.
   • В противном случае нажмите File в меню Android Studio, затем выберите последовательно New и New Project.

3. В открывшемся окне укажите имя своего приложения, домен компании и расположение проекта. Затем нажмите Next.

4. Выберите форм-факторы, необходимые для вашего приложения. Если вы не уверены в выборе, просто укажите Phone and Tablet. Затем нажмите Next.
5. Выберите Google Maps Activity в окне "Add an activity to Mobile". Затем нажмите Next.
6. В открывшемся окне укажите имя операции, имя шаблона и название. Вы можете оставить значения, указанные по умолчанию. Затем нажмите Finish.

Android Studio запустит Gradle и создаст ваш проект. Это может занять несколько секунд. Дополнительные сведения о создании проектов в Android Studio см. в документации Android Studio.

По завершении создания проекта Android Studio откроет в редакторе файлы google_maps_api.xml и MapsActivity.java. (Ваша операция может иметь другое название, указанное вами при настройке). Обратите внимание, что файл google_maps_api.xml содержит инструкции для получения ключа Google Maps API, что следует сделать перед запуском приложения. Процесс получения ключа API более подробно описывается в следующем разделе.

Шаг 4. Получите ключ Google Maps API

Для доступа к серверам Google Maps вашему приложению требуется ключ API. Вам нужен ключ API с ограничением для приложений Android. Ключ предоставляется бесплатно. Вы можете использовать его с любым из своих приложений, обращающихся к Google Maps Android API, без каких-либо ограничений по количеству пользователей.

Выберите один из следующих способов получить свой ключ API из Android Studio.

• Самый быстрый и простой способ: Используйте ссылку в файле google_maps_api.xml, созданном Android Studio.
  1. Скопируйте ссылку из файла google_maps_api.xml и вставьте ее в адресную строку своего браузера. Эта ссылка перенаправит вас в Google API Console и предоставит в Google API Console необходимую информацию через параметры URL, тем самым сократив объем данных, которые требуется вводить вручную.
  2. Выполните инструкции, чтобы создать новый проект в Google API Console, или выберите существующий проект.
  3. Создайте ключ API, ограниченный для Android, для своего проекта.
  4. Скопируйте созданный ключ API, вернитесь в Android Studio и вставьте ключ API в элемент <string> в файле google_maps_api.xml.
• Несколько менее быстрый способ: Используйте учетные данные в файле google_maps_api.xml, созданном Android Studio.
  1. Скопируйте учетные данные из файла google_maps_api.xml.
  2. Откройте Google API Console в браузере.
  3. Используйте скопированные учетные данные, чтобы добавить приложение в существующий ключ API или создать новый ключ API.

• Полный процесс получения ключа API: если в вашем случае ни один из приведенных способов не работает, следуйте описанию всего процесса.

Шаг 5. А вот и карта! Взгляните на код

Изучите код, содержащийся в шаблоне. В частности, просмотрите следующие файлы в проекте 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), чтобы настроить одно или несколько виртуальных устройств, которые можно использовать с Android Emulator в процессе создания и запуска приложения. При выборе эмулятора убедитесь, что вы используете Android версии 4.2.2 или более поздней. Необходимо выбрать образ, содержащий Google API, поскольку в противном случае у приложения не будет API-интерфейсов среды выполнения, необходимых для запуска. Также ознакомьтесь с инструкциями по настройке ускорения для виртуальных машин, которое вы должны использовать с целевым виртуальным устройством Android с архитектурой x86, как это описано в инструкциях. Это позволит сделать работу с эмулятором более удобной.

Шаг 7. Соберите и запустите приложение

В Android Studio выберите пункт меню Run (или значок кнопки воспроизведения), чтобы запустить свое приложение.

Когда откроется окно с предложением выбрать устройство, выберите один из следующих вариантов:

• Выберите устройство Android, подключенное к компьютеру.
• Выберите переключатель Launch emulator и укажите предварительно настроенное виртуальное устройство.

Нажмите OK. Android Studio запустит Gradle для сборки приложения, а затем отобразит результаты на устройстве или в эмуляторе. Для запуска приложения может понадобиться несколько минут.

Должна отобразиться карта с маркером на Сиднее в Австралии. Если эта карта не отображается, проверьте выполнение всех шагов, описанных на этой странице. В частности, проверьте, добавлен ли ключ API, как это описано выше.

Дальнейшие действия

Вас могут заинтересовать некоторые примеры кода.

Дополнительные сведения об объектах карты приведены в руководстве для разработчиков.