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

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

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

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

Типы мест включаются в ответ на запросы «Подробная информация о месте» (новая функция), «Поиск поблизости» (новая функция), «Текстовый поиск» (новая функция) и «Автозаполнение» (новая функция):

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

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

Для доступа к этим типам данных необходимо включить Places API (новый) в вашем проекте Google Cloud. Дополнительную информацию см. в разделе «Настройка проекта Google Cloud» .

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

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

  • В ответ на запросы от функций «Подробная информация о месте» (новая функция), «Поиск поблизости» (новая функция) и «Текстовый поиск» (новая функция) значения из таблицы A используются для заполнения свойства types экземпляра GMSPlace . В списке полей запроса необходимо указать GMSPlacePropertyTypes .
  • В рамках запроса на поиск поблизости (новый) используется в качестве значения параметра, содержащего информацию о включенных типах, исключенных типах, включенных основных типах и исключенных основных типах.
  • В рамках запроса текстового поиска (нового типа) используется в качестве значения включенного параметра типа.
  • В рамках запроса на добавление автозаполнения (нового) используйте эти значения для параметра types.
  • В рамках ответа функции автозаполнения места (новое) используется для заполнения свойства types экземпляра GMSAutocompletePlaceSuggestion .

В таблице B перечислены дополнительные значения типов мест, которые также могут быть возвращены в ответах запросов «Подробная информация о месте» (новое), «Поиск поблизости» (новое), «Текстовый поиск» (новое) и «Автозаполнение места» (новое). В списке полей запроса необходимо указать GMSPlacePropertyTypes . Значения из таблицы B НЕ могут быть использованы в запросе, за исключением значений параметра types для запроса «Автозаполнение места» (новое).

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

Таблица А

Автомобильная промышленность
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
winery *
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
yakitori_restaurant *
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

Таблица B

Значения типов мест, указанные в таблице B, могут возвращаться в ответе на запросы «Подробная информация о месте» (новое), «Поиск поблизости» (новое), «Текстовый поиск» (новое) или «Автозаполнение» (новое). Эти типы также поддерживаются параметром 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

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

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

Адреса могут иметь несколько типов. Эти типы можно рассматривать как «теги». Например, многие города помечены тегами 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 Кодированная координата местоположения, полученная на основе широты и долготы. Плюс-коды могут использоваться вместо уличных адресов в местах, где они отсутствуют (где здания не нумеруются или улицы не имеют названий). Подробнее см. https://plus.codes .
postal_code Почтовый индекс, используемый для адресации почтовых отправлений внутри страны.
natural_feature Выдающаяся природная особенность.
airport Аэропорт.
park Парк, имеющий своё название.
point_of_interest Названная достопримечательность. Как правило, это известные местные объекты, которые сложно отнести к какой-либо другой категории, например, «Эмпайр-стейт-билдинг» или «Эйфелева башня».

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

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

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