Функции Places SDK для iOS, доступные в вашем приложении, определяются комбинацией номера версии SDK (например, 9.0.0), который вы указываете в зависимостях вашего пакета, и API, включенных в вашем ключе API. В этом руководстве объясняются различия между версиями и способы выбора версий, которые будут включены в вашем приложении.
Номера версий SDK
Номер версии SDK, который вы указываете в зависимостях вашего пакета, определяет, имеет ли ваше приложение доступ к функциям, которые были добавлены в определенном выпуске. Например, автозаполнение (новое) доступно только в SDK версии 9.0.0 или более поздней.
Дополнительную информацию об изменениях, внесенных в каждую версию SDK, см. в примечаниях к выпуску Places SDK для iOS .
Версии Places API для Places SDK для iOS
Помимо указания номера версии SDK, вам также необходимо выбрать службу Places API, которую SDK вызывает в Google Cloud Console: либо Places API, либо Places API (новый). Вместе с номером версии SDK выбранная вами служба API определяет, какая версия определенных функций доступна в вашем приложении, например автозаполнение или автозаполнение (новая). Хотя вы можете указать только один номер версии SDK, вы можете одновременно включить API Places и Places API (новый) в своем ключе API. Однако в большинстве случаев вам потребуется включить Places API (новый) и использовать (новые) версии функций SDK в своем приложении.
Выберите версию SDK и сервисы API.
Чтобы выбрать, какие функции SDK доступны в вашем приложении, выполните следующие действия:
- В своем проекте Google Cloud включите Places API, Places API (новый) или оба. Дополнительную информацию см. в разделе Включение API.
- В ограничениях ключей API включите Places API, Places API (новый) или оба. Дополнительную информацию см. в разделе Ограничение ключей API .
- При установке SDK укажите номер версии. Дополнительные сведения см. в разделе Настройка проекта Xcode .
Дополнительную информацию о выборе службы Places API см. в разделе Настройка проекта Google Cloud .
Функции SDK, доступные в каждой версии
В следующей таблице показано, какие версии SDK и API необходимы для каждой функции SDK:
| Places SDK для iOS (новинка) | Минимальная версия SDK | SDK Адресов для iOS | Минимальная версия SDK |
|---|---|---|---|
| Детали места (новое) | 9.0.0 | Детали места | 3.0.0 |
| Разместить фото (новое) | 9.0.0 | Разместить фото | 3.0.0 |
| Текстовый поиск (новинка) | 8.5.0 | ||
| Поиск поблизости (новинка) | 9.0.0 | ||
| Автозаполнение (новое) | 9.0.0 | Автозаполнение | 3.0.0 |
| Текущее место | 3.0.0 |
Рекомендации по выбору версий для включения
- Если вы новый клиент и только начинаете работать с Places SDK для iOS, начните с Places API (нового) и нового SDK.
- Если вы уже являетесь клиентом, вы можете продолжать использовать существующий SDK. Однако, чтобы воспользоваться преимуществами повышения производительности и расширения функций Places SDK для iOS (новая версия), вам следует включить Places API (новая версия) и использовать новый SDK. При переходе на новый SDK миграция не требуется, просто следуйте инструкциям в разделе «Выбор версии SDK и служб API» .
- API Places (новый) не поддерживает некоторые существующие функции, такие как Current Place ,
GMSPlace.isOpenиGMSPlace.isOpenAtDate.
Использование Places Swift SDK для iOS (предварительная версия)
Для использования Places Swift SDK для iOS (предварительная версия) необходимо выполнить следующие действия:
- Включите Places API (новое) .
- Добавьте Places Swift SDK для iOS (предварительная версия) в свои зависимости.
- Инициализируйте клиент Places с помощью
PlacesClient.
Чтобы узнать больше о Places Swift SDK для iOS (предварительная версия), ознакомьтесь с обзором или руководством по миграции .
Переход на новые API
Если вы используете существующий API и хотите перейти на новый API, ознакомьтесь со следующими руководствами по миграции для каждого API:
- Перенос в сведения о месте (новинка)
- Миграция для размещения фотографии (новая версия)
- Переход на автозаполнение (новое)
Улучшения в Places SDK для iOS (новинка)
В этом разделе описаны ключевые функции, добавленные в Places SDK для iOS (новинка).
Реализовано на стандартной платформе Google Cloud.
Places SDK для iOS (новинка) реализован в инфраструктуре сервиса Google Cloud. Эта реализация обеспечивает более безопасную и надежную платформу. Этот стандартный дизайн обеспечивает уровень согласованности между SDK, что повышает эффективность разработки с помощью Places SDK для iOS (новинка).
Улучшенная производительность
Places SDK для iOS (новый) обеспечивает повышенную производительность, поэтому стоит заменить приложения, использующие существующий SDK.
Новые возможности
Places SDK для iOS (новинка) включает в себя последние версии всех функций SDK:
- Автозаполнение (новое)
- Детали места (новое)
- Поиск поблизости (новинка)
- Фотографии мест (новинка)
- Текстовый поиск (новинка)
Упрощенное ценообразование
Благодаря Places SDK для iOS (новинка) ценообразование упрощается, поэтому вы платите только за те данные, которые используете. Упрощенное ценообразование реализуется с помощью списков полей, также называемых масками полей .
С помощью Places SDK для iOS и текстового поиска вы используете списки полей для управления списком полей, возвращаемых в ответе. В этом случае вам будет выставлен счет только за запрошенные данные. Использование списка полей — это хорошая практика проектирования, позволяющая избежать запроса ненужных данных, что помогает избежать ненужного времени обработки и затрат на выставление счетов.
Подробную информацию о ценах на оба пакета SDK см. в разделе «Использование и выставление счетов» .
Расширенные типы мест
Новый SDK добавляет типы мест, показанные в следующей таблице. Эти типы возвращаются как часть ответа о месте и текстовом поиске. Вы также можете использовать эти новые и существующие типы при поиске с помощью текстового поиска. Новые типы включены в Таблицу А.
| Тип | |||
|---|---|---|---|
| американский_ресторан | скидка_магазин | Ice_cream_shop | сэндвич_магазин |
| центр развлечений | собака_парк | индийский_ресторан | школьный_район |
| спортивное_поле | electric_vehicle_charging_station | индонезийский_ресторан | ресторан_морепродуктов |
| auto_parts_store | событие_место проведения | итальянский_ресторан | лыжный_курорт |
| банкетный_зал | Extended_stay_hotel | японский_ресторан | испанский_ресторан |
| барбекю_ресторан | ферма | корейский_ресторан | магазин_спортивных_товаров |
| парикмахерская | проживание на ферме | lebanese_restaurant | спортивный_клуб |
| кровать_и_завтрак | fast_food_restaurant | пристань для яхт | спортивный_комплекс |
| бразильский_ресторан | паромный_терминал | рынок | стейк_хаус |
| завтрак_ресторан | фитнес_центр | медицинская_лаборатория | суши_ресторан |
| бранч_ресторан | французский_ресторан | средиземноморский_ресторан | бассейн |
| автобусная_остановка | магазин подарков | мексиканский_ресторан | портной |
| кемпинг_кабина | поле для гольфа | middle_eastern_restaurant | поставщик_телекоммуникационных_услуг |
| cell_phone_store | греческий_ресторан | мотель | тайский_ресторан |
| child_care_agency | продуктовый магазин | национальный_парк | транзит_депо |
| китайский_ресторан | гостевой дом | park_and_ride | грузовик_стоп |
| кофейный магазин | парикмахерский_салон | театр_исполнительского_искусства | турецкий_ресторан |
| центр_сообщества | гамбургер_ресторан | пицца_ресторан | веганский_ресторан |
| консультант | вертолетная площадка | детская площадка | вегетарианский_ресторан |
| конференц-центр | зона походов | дошкольный | вьетнамский_ресторан |
| коттедж | исторический_ориентир | Private_guest_room | посетитель_центр |
| курьерская_служба | home_improvement_store | рамэн_ресторан | свадьба_место проведения |
| культурный_центр | общежитие | курорт_отель | оптовик |
| стоматологическая_клиника | отель | rest_stop |
Наряду с этими новыми типами API Places (новый) переместил следующие типы из таблицы 2 API Places в таблицу A API Places (новый). Это означает, что теперь вы можете использовать эти типы как часть поиска:
-
country -
administrative_area_level_1 -
administrative_area_level_2 -
postal_code -
locality
Функции Places SDK для iOS, доступные в вашем приложении, определяются комбинацией номера версии SDK (например, 9.0.0), который вы указываете в зависимостях вашего пакета, и API, включенных в вашем ключе API. В этом руководстве объясняются различия между версиями и способы выбора версий, которые будут включены в вашем приложении.
Номера версий SDK
Номер версии SDK, который вы указываете в зависимостях вашего пакета, определяет, имеет ли ваше приложение доступ к функциям, которые были добавлены в определенном выпуске. Например, автозаполнение (новое) доступно только в SDK версии 9.0.0 или более поздней.
Дополнительную информацию об изменениях, внесенных в каждую версию SDK, см. в примечаниях к выпуску Places SDK для iOS .
Версии Places API для Places SDK для iOS
Помимо указания номера версии SDK, вам также необходимо выбрать службу Places API, которую SDK вызывает в Google Cloud Console: либо Places API, либо Places API (новый). Вместе с номером версии SDK выбранная вами служба API определяет, какая версия определенных функций доступна в вашем приложении, например автозаполнение или автозаполнение (новая). Хотя вы можете указать только один номер версии SDK, вы можете одновременно включить в своем ключе API как Places API, так и Places API (новый). Однако в большинстве случаев вам потребуется включить Places API (новый) и использовать (новые) версии функций SDK в своем приложении.
Выберите версию SDK и сервисы API.
Чтобы выбрать, какие функции SDK доступны в вашем приложении, выполните следующие действия:
- В своем проекте Google Cloud включите Places API, Places API (новый) или оба. Дополнительную информацию см. в разделе Включение API.
- В ограничениях ключей API включите Places API, Places API (новый) или оба. Дополнительную информацию см. в разделе Ограничение ключей API .
- При установке SDK укажите номер версии. Дополнительные сведения см. в разделе Настройка проекта Xcode .
Дополнительную информацию о выборе службы Places API см. в разделе Настройка проекта Google Cloud .
Функции SDK, доступные в каждой версии
В следующей таблице показано, какие версии SDK и API необходимы для каждой функции SDK:
| Places SDK для iOS (новинка) | Минимальная версия SDK | SDK Адресов для iOS | Минимальная версия SDK |
|---|---|---|---|
| Детали места (новое) | 9.0.0 | Детали места | 3.0.0 |
| Разместить фото (новое) | 9.0.0 | Разместить фото | 3.0.0 |
| Текстовый поиск (новинка) | 8.5.0 | ||
| Поиск поблизости (новинка) | 9.0.0 | ||
| Автозаполнение (новое) | 9.0.0 | Автозаполнение | 3.0.0 |
| Текущее место | 3.0.0 |
Рекомендации по выбору версий для включения
- Если вы новый клиент и только начинаете работать с Places SDK для iOS, начните с Places API (нового) и нового SDK.
- Если вы уже являетесь клиентом, вы можете продолжать использовать существующий SDK. Однако, чтобы воспользоваться преимуществами повышения производительности и расширения функций Places SDK для iOS (новая версия), вам следует включить Places API (новая версия) и использовать новый SDK. При переходе на новый SDK миграция не требуется, просто следуйте инструкциям в разделе «Выбор версии SDK и служб API» .
- API Places (новый) не поддерживает некоторые существующие функции, такие как Current Place ,
GMSPlace.isOpenиGMSPlace.isOpenAtDate.
Использование Places Swift SDK для iOS (предварительная версия)
Для использования Places Swift SDK для iOS (предварительная версия) необходимо выполнить следующие действия:
- Включите Places API (новое) .
- Добавьте Places Swift SDK для iOS (предварительная версия) в свои зависимости.
- Инициализируйте клиент Places с помощью
PlacesClient.
Чтобы узнать больше о Places Swift SDK для iOS (предварительная версия), ознакомьтесь с обзором или руководством по миграции .
Переход на новые API
Если вы используете существующий API и хотите перейти на новый API, ознакомьтесь со следующими руководствами по миграции для каждого API:
- Перенос в сведения о месте (новинка)
- Миграция для размещения фотографии (новая версия)
- Переход на автозаполнение (новое)
Улучшения в Places SDK для iOS (новинка)
В этом разделе описаны ключевые функции, добавленные в Places SDK для iOS (новинка).
Реализовано на стандартной платформе Google Cloud.
Places SDK для iOS (новинка) реализован в инфраструктуре сервиса Google Cloud. Эта реализация обеспечивает более безопасную и надежную платформу. Этот стандартный дизайн обеспечивает уровень согласованности между SDK, что повышает эффективность разработки с помощью Places SDK для iOS (новинка).
Улучшенная производительность
Places SDK для iOS (новый) обеспечивает повышенную производительность, поэтому стоит заменить приложения, использующие существующий SDK.
Новые возможности
Places SDK для iOS (новинка) включает в себя последние версии всех функций SDK:
- Автозаполнение (новое)
- Детали места (новое)
- Поиск поблизости (новинка)
- Фотографии мест (новинка)
- Текстовый поиск (новинка)
Упрощенное ценообразование
Благодаря Places SDK для iOS (новая версия) ценообразование упрощается, поэтому вы платите только за те данные, которые используете. Упрощенное ценообразование реализуется с помощью списков полей, также называемых масками полей .
С помощью Places SDK для iOS и текстового поиска вы используете списки полей для управления списком полей, возвращаемых в ответе. В этом случае вам будет выставлен счет только за запрошенные данные. Использование списка полей — это хорошая практика проектирования, позволяющая избежать запроса ненужных данных, что помогает избежать ненужного времени обработки и затрат на выставление счетов.
Подробную информацию о ценах на оба SDK см. в разделе «Использование и выставление счетов» .
Расширенные типы мест
Новый SDK добавляет типы мест, показанные в следующей таблице. Эти типы возвращаются как часть ответа о месте и текстовом поиске. Вы также можете использовать эти новые и существующие типы при поиске с помощью текстового поиска. Новые типы включены в Таблицу А.
| Тип | |||
|---|---|---|---|
| американский_ресторан | скидка_магазин | Ice_cream_shop | сэндвич_магазин |
| центр развлечений | собака_парк | индийский_ресторан | школьный_район |
| спортивное_поле | electric_vehicle_charging_station | индонезийский_ресторан | ресторан_морепродуктов |
| auto_parts_store | событие_место проведения | итальянский_ресторан | лыжный_курорт |
| банкетный_зал | расширенный_отель_отель | японский_ресторан | испанский_ресторан |
| барбекю_ресторан | ферма | корейский_ресторан | магазин_спортивных_товаров |
| парикмахерская | проживание на ферме | lebanese_restaurant | спортивный_клуб |
| кровать_и_завтрак | fast_food_restaurant | пристань для яхт | спортивный_комплекс |
| бразильский_ресторан | паромный_терминал | рынок | стейк_хаус |
| завтрак_ресторан | фитнес_центр | медицинская_лаборатория | суши_ресторан |
| бранч_ресторан | французский_ресторан | средиземноморский_ресторан | бассейн |
| автобусная_остановка | магазин подарков | мексиканский_ресторан | портной |
| кемпинг_кабина | поле для гольфа | middle_eastern_restaurant | поставщик_телекоммуникационных_услуг |
| cell_phone_store | греческий_ресторан | мотель | тайский_ресторан |
| child_care_agency | продуктовый магазин | национальный_парк | транзит_депо |
| китайский_ресторан | гостевой дом | park_and_ride | грузовик_стоп |
| кофейный магазин | парикмахерский_салон | театр_исполнительского_искусства | турецкий_ресторан |
| центр_сообщества | гамбургер_ресторан | пицца_ресторан | веганский_ресторан |
| консультант | вертолетная площадка | детская площадка | вегетарианский_ресторан |
| конференц-центр | зона походов | дошкольный | вьетнамский_ресторан |
| коттедж | исторический_ориентир | Private_guest_room | посетитель_центр |
| курьерская_служба | home_improvement_store | рамэн_ресторан | свадьба_место проведения |
| культурный_центр | общежитие | курорт_отель | оптовик |
| стоматологическая_клиника | отель | rest_stop |
Наряду с этими новыми типами API Places (новый) переместил следующие типы из таблицы 2 API Places в таблицу A API Places (новый). Это означает, что теперь вы можете использовать эти типы как часть поиска:
-
country -
administrative_area_level_1 -
administrative_area_level_2 -
postal_code -
locality