Places SDK для iOS версии 8.5.0 поддерживает две версии SDK: Places SDK для iOS — это существующий Places SDK для iOS (новый) — это версия SDK следующего поколения.
С выпуском Places SDK для iOS версии 8.5.0 ваша первая задача — решить, какой SDK использовать. Это верно, если вы новый клиент или существующий клиент, уже использующий SDK. Используйте это руководство, чтобы понять ключевые различия между двумя SDK.
Как выбрать версию SDK
Places SDK для iOS использует службу Places API . Прежде чем вы сможете использовать Places SDK для iOS, вам необходимо включить службу Places API в своем проекте Google Cloud.
Версия службы Places API, которую вы включаете, определяет версию SDK, используемую вашим приложением:
API Places : включает существующий SDK Places для iOS . Если для проекта, связанного с ключом API, используемым для вашего приложения, включен только API Places, ваше приложение не будет иметь доступа к новым функциям, добавленным в Places SDK для iOS версии 8.5.0 и более поздних версий.
API Places (новое) . Включает Places SDK для iOS (новое) , включая текстовый поиск и все новые функции, описанные в разделе Ключевые функции, добавленные в Places SDK для iOS (новое) . Не активируются существующие функции, такие как «Сведения о месте», «Фотографии места», «Текущее место» и «Автозаполнение места».
Оба : включает все функции Places SDK для iOS (новинка) и Places SDK для iOS .
Дополнительную информацию о выборе службы Places API см. в разделе Настройка проекта Google Cloud .
Какой SDK вы выберете?
Чтобы помочь решить, какую версию выбрать:
Если вы новый клиент и только начинаете работать с Places SDK для iOS, начните с Places API (новое) и Places API , чтобы получить доступ ко всем функциям.
Если вы уже являетесь клиентом , вы можете продолжать использовать существующий SDK. Однако, чтобы воспользоваться преимуществами повышения производительности и расширения функций Places SDK для iOS (новая версия), вы можете использовать новый SDK.
При переходе на новый SDK миграция не требуется. Вам нужно только включить Places SDK для iOS (новое) для ключа API, используемого в вашем приложении. Если вы используете как существующий Places SDK для iOS, так и Places SDK для iOS (новый) , включите обе версии в своем ключе API. Дополнительные сведения см. в разделе Использование ключей API .
Ключевые функции, добавленные в Places SDK для iOS (новинка)
В этом разделе описаны ключевые функции, добавленные в Places SDK для iOS (новинка) .
Реализовано на стандартной платформе Google Cloud.
Places SDK для iOS (новинка) реализован в инфраструктуре сервиса Google Cloud. Эта реализация обеспечивает более безопасную и надежную платформу. Этот стандартный дизайн обеспечивает уровень согласованности между SDK, что повышает эффективность разработки с помощью Places SDK для iOS (новинка) .
Улучшенная производительность
Places SDK для iOS (новый) обеспечивает повышенную производительность, поэтому стоит заменить приложения, использующие существующий SDK.
Новый сервис текстового поиска
Текстовый поиск возвращает информацию о наборе мест на основе строки — например, «пицца в Нью-Йорке», «обувные магазины недалеко от Оттавы» или «Мейн-стрит, 123». Служба отвечает списком мест, соответствующих текстовой строке, и любым установленным смещениям местоположения.
Упрощенное ценообразование
Благодаря Places SDK для iOS (новая версия) ценообразование упрощается, поэтому вы платите только за те данные, которые используете. Упрощенное ценообразование реализуется с помощью списков полей, также называемых масками полей .
С помощью Places SDK для iOS и текстового поиска вы используете списки полей для управления списком полей, возвращаемых в ответе. В этом случае вам будет выставлен счет только за запрошенные данные. Использование списка полей — это хорошая практика проектирования, позволяющая избежать запроса ненужных данных, что помогает избежать ненужного времени обработки и затрат на выставление счетов.
Подробную информацию о ценах на оба SDK см. в разделе « Использование и выставление счетов» .
Расширенные типы мест
Новый SDK добавляет типы мест, показанные в следующей таблице. Эти типы возвращаются как часть ответа о месте и текстовом поиске. Вы также можете использовать эти новые и существующие типы при поиске с помощью текстового поиска. Новые типы включены в Таблицу А.
Тип | |||
---|---|---|---|
американский_ресторан | скидка_магазин | магазин мороженого | сэндвич_магазин |
центр развлечений | собака_парк | индийский_ресторан | школьный округ |
спортивная площадка | electric_vehicle_charging_station | индонезийский_ресторан | ресторан морепродуктов |
auto_parts_store | событие_место проведения | Итальянский ресторан | лыжный курорт |
банкетный зал | расширенный_отель_отель | Японский ресторан | испанский_ресторан |
барбекю_ресторан | ферма | корейский_ресторан | магазин спортивных товаров |
парикмахерская | проживание на ферме | lebanese_restaurant | спортивный клуб |
кровать и завтрак | Ресторан быстрого питания | Марина | спортивный комплекс |
бразильский_ресторан | паромный терминал | рынок | стейк-хаус |
завтрак_ресторан | фитнес-центр | медицинская_лаборатория | суши_ресторан |
бранч_ресторан | французский ресторан | средиземноморский_ресторан | бассейн |
автобусная остановка | магазин подарков | мексиканский ресторан | портной |
кемпинг_кабина | поле для гольфа | middle_eastern_restaurant | поставщик_телекоммуникационных_услуг |
cell_phone_store | греческий_ресторан | мотель | тайский_ресторан |
child_care_agency | продуктовый магазин | Национальный парк | транзит_депо |
Китайский ресторан | гостевой дом | park_and_ride | грузовик_стоп |
кофейный магазин | парикмахерская | театр_исполнительского_искусства | турецкий_ресторан |
общественный центр | гамбургер_ресторан | пицца_ресторан | веганский_ресторан |
консультант | вертолетная площадка | детская площадка | вегетарианский_ресторан |
конференц-центр | зона походов | дошкольный | вьетнамский_ресторан |
коттедж | исторический_ориентир | Private_guest_room | посетитель_центр |
курьерская служба | home_improvement_store | ramen_restaurant | место свадьбы |
Центр культуры | общежитие | курортный отель | оптовик |
Стоматологическая клиника | Гостиница | привал |
-
country
-
administrative_area_level_1
-
administrative_area_level_2
-
postal_code
-
locality