Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Типы мест (новая версия)

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

Разработчики из Европейской экономической зоны (ЕЭЗ)

Введение

Типы мест – это категории, которые определяют характеристики места. Месту может быть присвоен один или несколько типов.

Типы мест включены в ответ на запросы информации о местах (New), поиск поблизости (New), текстовый поиск (New) и автозаполнение (New).

У места может быть один основной тип из таблицы А или таблицы Б. Например, основной тип может быть mexican_restaurant или steak_house.Основной тип может отсутствовать, если основной тип места не поддерживается. Если указан основной тип, он всегда совпадает с одним из типов в поле types.
Место может иметь несколько значений типа из таблицы A или таблицы B. Например, у ресторана могут быть следующие типы: seafood_restaurant, restaurant, food, point_of_interest, establishment.
Адрес и компоненты адреса места можно пометить определенными типами из таблицы Типы адресов и их компонентов. Например, адрес может быть помечен как street_address, а компонент адреса – как street_number.

Вы также можете указать типы мест в запросе. Если в запросе указан тип, он действует как фильтр, ограничивающий ответ только местами, которые соответствуют указанным типам.

О таблицах типов

В Таблице А перечислены типы, которые используются следующим образом:

в ответах на запросы от новых функций Place Details, Nearby Search и Text Search В запросе должно быть указано хотя бы одно значение в маске поля places.types или places.primaryType. (эти поля заполняются значениями из Таблицы А);
в новых запросах Nearby Search, в качестве значений параметров includedTypes, excludedTypes, includedPrimaryTypes и excludedPrimaryTypes (эти поля заполняются значениями из Таблицы Б);
в новых запросах Text Search, в качестве значений параметра includedType;
в составе новых запросов Autocomplete, в качестве значений параметра includedPrimaryTypes;
в составе ответов на новые запросы автозаполнения.

В Таблице Б перечислены дополнительные значения для типа мест, которые могут быть возвращены в составе ответа на новые запросы информация о местах (New), поиск поблизости (New), текстовый поиск (New) и Autocomplete (New). В запросе должно быть указано хотя бы одно значение в маске поля places.types или places.primaryType. Значения из Таблицы Б НЕЛЬЗЯ использовать в самих запросах (кроме значений параметра includedPrimaryTypes в новых запросах Autocomplete).

В таблице В перечислены коллекции типов, которые можно использовать в качестве значения параметра includedPrimaryTypes в запросе Autocomplete (New). Коллекции типов нельзя указывать вместе с другими значениями типов.

Типы адресов и их компонентов – список типов, которые могут быть указаны в массивах типов адресов и их компонентов в теле ответа. Типы компонентов адреса могут меняться.

Таблица А

Автомобили
Бизнес
Культура
Образование
Культура и отдых
Удобства
Финансы
Еда и напитки
Географические области
Государственные учреждения

Здоровье и благополучие
Жилье
Жилье
Природные объекты
Храмы и молельные дома
Услуги
Покупки
Спорт
Транспорт

Автомобили
`car_dealer` `car_rental` `car_repair` `car_wash` `ebike_charging_station` * `electric_vehicle_charging_station` `gas_station`	`parking` `parking_garage` * `parking_lot` * `rest_stop` `tire_shop` * `truck_dealer` *
Компания
`business_center` * `corporate_office` `coworking_space` * `farm` `manufacturer` * `ranch` `supplier` * `television_studio` *
Культура
`art_gallery` `art_museum` * `art_studio` `auditorium` `castle` * `cultural_landmark` `fountain` * `historical_place` `history_museum` *	`monument` `museum` `performing_arts_theater` `sculpture`
Образование
`academic_department` * `educational_institution` * `library` `preschool` `primary_school`	`research_institute` * `school` `secondary_school` `university`
Культура и отдых
`adventure_sports_center` `amphitheatre` `amusement_center` `amusement_park` `aquarium` `banquet_hall` `barbecue_area` `botanical_garden` `bowling_alley` `casino` `childrens_camp` `city_park` * `comedy_club` `community_center` `concert_hall` `convention_center` `cultural_center` `cycling_park` `dance_hall` `dog_park` `event_venue` `ferris_wheel` `garden` `go_karting_venue` *	`hiking_area` `historical_landmark` `indoor_playground` * `internet_cafe` `karaoke` `live_music_venue` * `marina` `miniature_golf_course` * `movie_rental` `movie_theater` `national_park` `night_club` `observation_deck` `off_roading_area` `opera_house` `paintball_center` * `park` `philharmonic_hall` `picnic_ground` `planetarium` `plaza` `roller_coaster` `skateboard_park` `state_park`	`tourist_attraction` `video_arcade` `vineyard` * `visitor_center` `water_park` `wedding_venue` `wildlife_park` `wildlife_refuge` `zoo`
Комфорт
`public_bath` `public_bathroom` `stable`
Финансы
`accounting` `atm` `bank`
Продукты питания и напитки
`acai_shop` `afghani_restaurant` `african_restaurant` `american_restaurant` `argentinian_restaurant` * `asian_fusion_restaurant` * `asian_restaurant` `australian_restaurant` * `austrian_restaurant` * `bagel_shop` `bakery` `bangladeshi_restaurant` * `bar` `bar_and_grill` `barbecue_restaurant` `basque_restaurant` * `bavarian_restaurant` * `beer_garden` * `belgian_restaurant` * `bistro` * `brazilian_restaurant` `breakfast_restaurant` `brewery` * `brewpub` * `british_restaurant` * `brunch_restaurant` `buffet_restaurant` `burmese_restaurant` * `burrito_restaurant` * `cafe` `cafeteria` `cajun_restaurant` * `cake_shop` * `californian_restaurant` * `cambodian_restaurant` * `candy_store` `cantonese_restaurant` * `caribbean_restaurant` * `cat_cafe` `chicken_restaurant` * `chicken_wings_restaurant` * `chilean_restaurant` * `chinese_noodle_restaurant` * `chinese_restaurant` `chocolate_factory` `chocolate_shop` `cocktail_bar` * `coffee_roastery` * `coffee_shop` `coffee_stand` * `colombian_restaurant` * `confectionery` `croatian_restaurant` * `cuban_restaurant` * `czech_restaurant` * `danish_restaurant` * `deli`	`dessert_restaurant` `dessert_shop` `dim_sum_restaurant` * `diner` `dog_cafe` `donut_shop` `dumpling_restaurant` * `dutch_restaurant` * `eastern_european_restaurant` * `ethiopian_restaurant` * `european_restaurant` * `falafel_restaurant` * `family_restaurant` * `fast_food_restaurant` `filipino_restaurant` * `fine_dining_restaurant` `fish_and_chips_restaurant` * `fondue_restaurant` * `food_court` `french_restaurant` `fusion_restaurant` * `gastropub` * `german_restaurant` * `greek_restaurant` `gyro_restaurant` * `halal_restaurant`* `hamburger_restaurant` `hawaiian_restaurant` * `hookah_bar` * `hot_dog_restaurant` * `hot_dog_stand` * `hot_pot_restaurant` * `hungarian_restaurant` * `ice_cream_shop` `indian_restaurant` `indonesian_restaurant` `irish_pub` * `irish_restaurant` * `israeli_restaurant` * `italian_restaurant` `japanese_curry_restaurant` * `japanese_izakaya_restaurant` * `japanese_restaurant` `juice_shop` `kebab_shop` * `korean_barbecue_restaurant` * `korean_restaurant` `latin_american_restaurant` * `lebanese_restaurant` `lounge_bar` * `malaysian_restaurant` * `meal_delivery` `meal_takeaway` `mediterranean_restaurant` `mexican_restaurant` `middle_eastern_restaurant` `mongolian_barbecue_restaurant` *	`moroccan_restaurant` * `noodle_shop` * `north_indian_restaurant` * `oyster_bar_restaurant` * `pakistani_restaurant` * `pastry_shop` * `persian_restaurant` * `peruvian_restaurant` * `pizza_delivery` * `pizza_restaurant` `polish_restaurant` * `portuguese_restaurant` * `pub` `ramen_restaurant` `restaurant` `romanian_restaurant` * `russian_restaurant` * `salad_shop` * `sandwich_shop` `scandinavian_restaurant` * `seafood_restaurant` `shawarma_restaurant` * `snack_bar` * `soul_food_restaurant` * `soup_restaurant` * `south_american_restaurant` * `south_indian_restaurant` * `southwestern_us_restaurant` * `spanish_restaurant` `sports_bar` * `sri_lankan_restaurant` * `steak_house` `sushi_restaurant` `swiss_restaurant` * `taco_restaurant` * `taiwanese_restaurant` * `tapas_restaurant` * `tea_house` `tex_mex_restaurant` * `thai_restaurant` `tibetan_restaurant` * `tonkatsu_restaurant` * `turkish_restaurant` `ukrainian_restaurant` * `vegan_restaurant` `vegetarian_restaurant` `vietnamese_restaurant` `western_restaurant` * `wine_bar` `winery` * `yakiniku_restaurant` * `yakitori_restaurant` *
Географические области
`administrative_area_level_1` `administrative_area_level_2` `country`	`locality` `postal_code` `school_district`
Государственное управление
`city_hall` `courthouse` `embassy` `fire_station` `government_office`	`local_government_office` `neighborhood_police_station` (только в Японии) `police` `post_office`
Здоровье и благополучие
`chiropractor` `dental_clinic` `dentist` `doctor` `drugstore` `general_hospital` * `hospital` `massage` `massage_spa` * `medical_center` * `medical_clinic` * `medical_lab`	`pharmacy` `physiotherapist` `sauna` `skin_care_clinic` `spa` `tanning_studio` `wellness_center` `yoga_studio`
Жилье
`apartment_building` `apartment_complex` `condominium_complex` `housing_complex`
Жилье
`bed_and_breakfast` `budget_japanese_inn` `campground` `camping_cabin` `cottage` `extended_stay_hotel` `farmstay` `guest_house` `hostel` `hotel`	`inn` `japanese_inn` `lodging` `mobile_home_park` `motel` `private_guest_room` `resort_hotel` `rv_park`
Природные объекты
`beach` `island` * `lake` * `mountain_peak` * `nature_preserve` * `river` * `scenic_spot` * `woods` *
Храмы и молельные дома
`buddhist_temple` * `church` `hindu_temple` `mosque` `shinto_shrine` * `synagogue`
Сервисы
`aircraft_rental_service` * `association_or_organization` * `astrologer` `barber_shop` `beautician` `beauty_salon` `body_art_service` `catering_service` `cemetery` `chauffeur_service` * `child_care_agency` `consultant` `courier_service` `electrician` `employment_agency` * `florist` `food_delivery` `foot_care` `funeral_home` `hair_care` `hair_salon` `insurance_agency` `laundry` `lawyer` `locksmith`	`makeup_artist` `marketing_consultant` * `moving_company` `nail_salon` `non_profit_organization` * `painter` `pet_boarding_service` * `pet_care` * `plumber` `psychic` `real_estate_agency` `roofing_contractor` `service` * `shipping_service` * `storage` `summer_camp_organizer` `tailor` `telecommunications_service_provider` `tour_agency` `tourist_information_center` `travel_agency` `veterinary_care`
Покупки
`asian_grocery_store` `auto_parts_store` `bicycle_store` `book_store` `building_materials_store` * `butcher_shop` `cell_phone_store` `clothing_store` `convenience_store` `cosmetics_store` * `department_store` `discount_store` `discount_supermarket` * `electronics_store` `farmers_market` * `flea_market` * `food_store` `furniture_store` `garden_center` * `general_store` * `gift_shop` `grocery_store` `hardware_store` `health_food_store` * `home_goods_store`	`home_improvement_store` `hypermarket` * `jewelry_store` `liquor_store` `market` `pet_store` `shoe_store` `shopping_mall` `sporting_goods_store` `sportswear_store` * `store` `supermarket` `tea_store` * `thrift_store` * `toy_store` * `warehouse_store` `wholesaler` `womens_clothing_store` *
Спорт
`arena` `athletic_field` `fishing_charter` `fishing_pier` * `fishing_pond` `fitness_center` `golf_course` `gym` `ice_skating_rink` `indoor_golf_course` *	`playground` `race_course` * `ski_resort` `sports_activity_location` `sports_club` `sports_coaching` `sports_complex` `sports_school` * `stadium` `swimming_pool` * `tennis_court` *
Транспорт
`airport` `airstrip` `bike_sharing_station` * `bridge` * `bus_station` `bus_stop` `ferry_service` * `ferry_terminal` `heliport` `international_airport` `light_rail_station` `park_and_ride`	`subway_station` `taxi_service` * `taxi_stand` `toll_station` * `train_station` `train_ticket_office` * `tram_stop` * `transit_depot` `transit_station` `transit_stop` * `transportation_service` * `truck_stop`

Таблица Б

Значения типа места из таблицы Б могут быть возвращены в составе ответа на новые запросы информации о местах, поиска поблизости, текстового поиска или Autocomplete. Эти типы также поддерживаются в запросах includedPrimaryTypes для автозаполнения (новая версия).

Дополнительные значения для типа мест
`administrative_area_level_3` `administrative_area_level_4` `administrative_area_level_5` `administrative_area_level_6` `administrative_area_level_7` `archipelago` `colloquial_area` `continent` `establishment` `finance` `food` `general_contractor` `geocode` `health` `intersection` `landmark` `natural_feature` `neighborhood` `place_of_worship` `plus_code`	`point_of_interest` `political` `postal_code_prefix` `postal_code_suffix` `postal_town` `premise` `route` `street_address` `sublocality` `sublocality_level_1` `sublocality_level_2` `sublocality_level_3` `sublocality_level_4` `sublocality_level_5` `subpremise` `town_square`

Таблица В

Коллекции типов можно использовать в качестве значения параметра includedPrimaryTypes в новых запросах Autocomplete. При использовании коллекции типов возвращаются все результаты, соответствующие любому из связанных типов. Коллекции типов нельзя указывать вместе с другими типами.

Тип коллекции	Включенные типы
`(regions)`	Фильтры для районов или административных единиц, например почтовых индексов.
`(cities)`	Фильтры для мест, которые Google определяет как города.

Типы адресов и их компонентов

Массив types в ответе указывает тип адреса. Примеры типов адресов: почтовый адрес, страна или политическая единица. Массив types в поле AddressComponent указывает тип каждой части адреса. Примеры включают в себя номер дома или название страны.

Адреса могут иметь несколько типов. Эти типы можно считать тегами. Например, для многих городов используются теги типов political и locality.

В массивах типов адреса и типов компонентов адреса поддерживаются и возвращаются следующие типы:

Тип адреса	Описание
`street_address`	точный почтовый адрес;
`route`	Шоссе с названием (например, "US 101").
`intersection`	Крупный перекресток, как правило, двух крупных дорог.
`political`	Политическая организация. Чаще всего такой тип используется для обозначения некоторых административных объектов.
`country`	Страна. Обычно это тип наивысшего порядка, который возвращает геокодер.
`administrative_area_level_1`	Первый уровень национального административного деления. В США такими административными уровнями являются штаты. Эти административные уровни используются не во всех странах. В большинстве случаев краткие имена `administrative_area_level_1` будут близко соответствовать подразделениям в стандарте ISO 3166-2 и других широко распространенных списках. Тем не менее, поскольку геокодирование зависят от разных сигналов и данных о местоположении, его результаты могут быть разными.
`administrative_area_level_2`	Второй уровень национального административного деления. В США такими административными уровнями являются округи. Эти административные уровни используются не во всех странах.
`administrative_area_level_3`	Третий уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
`administrative_area_level_4`	Четвертый уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
`administrative_area_level_5`	Пятый уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
`administrative_area_level_6`	Шестой уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
`administrative_area_level_7`	Седьмой уровень национального административного деления. Это малая единица гражданского деления. Эти административные уровни используются не во всех странах.
`colloquial_area`	Часто используемое альтернативное название объекта.
`locality`	Городская административная единица.
`sublocality`	Первый уровень городского административного деления. Для некоторых местоположений можно получить один из дополнительных типов от `sublocality_level_1` до `sublocality_level_5`. Каждый уровень ниже населенного пункта является гражданской единицей. Большее значение указывает меньшую географическую область.
`neighborhood`	Именованный район.
`premise`	Место с собственным названием, обычно строение или группа строений с общим именем.
`subpremise`	Адресуемый объект, находящийся на территории, например квартира, блок или офис.
`plus_code`	Код местоположения на основе широты и долготы. Коды Plus Code можно использовать в качестве замены почтовым адресам там, где эти адреса не существуют (здания не пронумерованы или улицам не присвоены названия). Подробную информацию можно найти на сайте https://plus.codes.
`postal_code`	Почтовый округ (соответствует почтовому индексу).
`natural_feature`	Заметный природный объект.
`airport`	Аэропорт.
`park`	Парк, имеющий название.
`point_of_interest`	Объект инфраструктуры, имеющий название. Как правило, эти POI представляют собой крупные местные объекты, которые сложно отнести к другой категории, например "Эмпайр-стейт-билдинг" или "Эйфелева башня".

Пустой список типов указывает, что для того или иного элемента адреса нет известных типов, например lieu-dit во Франции.

Помимо вышеперечисленных, компоненты адреса могут иметь типы, указанные ниже.

Тип компонента адреса	Описание
`floor`	Этаж в адресе здания.
`establishment`	Чаще всего указывает место, для которого категория ещё не выбрана.
`landmark`	Место рядом, которое используется в качестве ориентира для навигации.
`point_of_interest`	Объект инфраструктуры, имеющий название.
`parking`	Парковка или многоэтажный гараж-стоянка.
`post_box`	Определенный почтовый ящик.
`postal_town`	Группа географических объектов, например `locality` и `sublocality`, которые в некоторых странах используются в почтовых адресах.
`room`	Комната в адресе здания.
`street_number`	Точный номер дома.
`bus_station`, `train_station` и `transit_station`	Местоположение остановки автобуса, поезда или другого общественного транспорта.