Обзор

Выберите платформу: Android iOS Веб-служба JavaScript

Прежде чем начать. Прежде чем начать использовать Places SDK для Android, вам понадобится проект с платежным аккаунтом и включенным Places API . Мы рекомендуем создать несколько владельцев проектов и администраторов по выставлению счетов, чтобы в вашей команде всегда был кто-то с этими ролями. Дополнительные сведения см. в разделе Настройка в Cloud Console .

Введение

Places SDK для Android позволяет создавать приложения с учетом местоположения, которые контекстуально реагируют на местные компании и другие места рядом с устройством пользователя. Это означает, что вы можете создавать многофункциональные приложения на основе мест, которые что-то значат для пользователя, в дополнение к простым географическим службам, предлагаемым службами определения местоположения Android .

Примечание. Платформа Google Maps предоставляет отдельные версии библиотеки Адресов для Android , iOS , JavaScript и веб-служб . Мы рекомендуем вам использовать версию библиотеки Places, соответствующую вашей платформе. То есть, если вы разрабатываете приложение для Android, вам следует использовать версию Places для Android.

Концепции

Следующие интерфейсы предоставляют основные точки входа в Places SDK для Android:

• Places обеспечивают программный доступ к базе данных Google с информацией о местных местах и ​​​​компаниях, а также к текущему местоположению устройства.
• Autocomplete предоставляет готовые виджеты для возврата подсказок мест в ответ на поисковые запросы пользователей.

Место определяется как физическое пространство, имеющее имя. Другой способ представления о месте — это все, что вы можете найти на карте. Примеры включают местные предприятия, достопримечательности и географические местоположения. В API место представлено интерфейсом Place . Он включает в себя такую ​​информацию, как название места и его адрес, географическое положение, идентификатор места, номер телефона, тип места, URL-адрес веб-сайта и многое другое.

Примечание. Всякий раз, когда ваше приложение отображает информацию о местах, полученную из Places SDK для Android, оно также должно отображать все соответствующие сведения об атрибуции, возвращаемые API. См. документацию по отображению авторства .

Выберите версию SDK

Функции Places SDK для Android, доступные в вашем приложении, определяются комбинацией номера версии SDK (например, 3.5.0), указанного вами в конфигурации приложения, API, включенных в вашем ключе API, и способа инициализации приложения. . Дополнительную информацию о различиях между Places SDK для Android и Places SDK для Android (новая версия) см. в разделе Выбор версии SDK .

Ваша первая задача — решить, какой SDK использовать. Это верно, если вы новый клиент или существующий клиент, уже использующий SDK. Чтобы узнать ключевые различия между двумя версиями SDK, см. раздел «Выбор версии SDK» .

Цены на каждую версию SDK

Стоимость использования SDK зависит от версии SDK, которую вы включаете. Places SDK для Android (новинка) поддерживает упрощенную модель ценообразования: вы платите только за те данные, которые используете. Подробную информацию о ценах на Places SDK для Android и Places SDK для Android (новая версия) см. в разделе «Использование и выставление счетов» .

Обзор API

Помогите своим клиентам узнать, где они находятся и что их окружает:

• Функция автозаполнения мест автоматически заполняет название и/или адрес места по мере ввода пользователем.
• Текущее место возвращает список мест, где в последний раз находилось устройство пользователя, а также указание относительной вероятности для каждого места.
• Функция «Сведения о месте» возвращает и отображает более подробную информацию о месте.
• Текстовый поиск возвращает места на основе текстовой строки поиска. Текстовый поиск является частью Places SDK для Android (новая версия).
• Place Photos возвращает высококачественные изображения места.
• Идентификаторы мест хранят уникальный идентификатор одного или нескольких мест для получения информации о месте по запросу.

Примечание. Google собирает анонимную статистику использования.

Политика и условия

Все приложения, использующие Places SDK для Android, должны соответствовать требованиям, описанным в Условиях обслуживания платформы Google Maps , использовании и выставлении счетов , а также отображении авторства .