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

Выберите платформу: Android iOS JavaScript Web Service

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

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

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

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

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

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

  • В ответе от функций «Сведения о месте (новое)», «Поиск рядом (новое)» и «Текстовый поиск (новое)» значения из таблицы A используются для заполнения свойства types экземпляра Place . В запросе необходимо указать Place.Field.TYPES или Place.Field.PRIMARY_TYPE в списке полей.
  • В рамках запроса Nearby Search (New) используется в качестве значения параметров включенных типов, исключенных типов, включенных основных типов и исключенных основных типов.
  • В рамках запроса текстового поиска (нового) используется в качестве значения включенного параметра типа.
  • В качестве части запроса Place Autocomplete (New) используйте значения для параметра primary types.
  • Как часть ответа Place Autocomplete (New), используемого для заполнения свойства types экземпляра AutocompletePrediction .

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

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

Таблица А

Автомобильная промышленность
car_dealer
car_rental
car_repair
car_wash
 electric_vehicle_charging_station
gas_station
parking
rest_stop
Бизнес
corporate_office *
farm
ranch *
Культура
art_gallery
art_studio *
auditorium *
cultural_landmark *
historical_place *
 monument *
museum
performing_arts_theater
sculpture *
Образование
library
preschool
primary_school		 school
secondary_school
university
Развлечения и отдых
adventure_sports_center *
amphitheatre *
amusement_center
amusement_park
aquarium
banquet_hall
barbecue_area *
botanical_garden *
bowling_alley
casino
childrens_camp *
comedy_club *
community_center
concert_hall *
convention_center
cultural_center
cycling_park *
dance_hall *
dog_park
event_venue
 ferris_wheel *
garden *
hiking_area *
historical_landmark
internet_cafe *
karaoke *
marina
movie_rental
movie_theater
national_park
night_club
observation_deck *
off_roading_area *
opera_house *
park
philharmonic_hall *
picnic_ground *
planetarium *
plaza *
roller_coaster *
 skateboard_park *
state_park *
tourist_attraction
video_arcade *
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
asian_restaurant *
bagel_shop *
bakery
bar
bar_and_grill *
barbecue_restaurant
brazilian_restaurant
breakfast_restaurant
brunch_restaurant
buffet_restaurant *
cafe
cafeteria *
candy_store *
cat_cafe *
chinese_restaurant
chocolate_factory *
chocolate_shop *
coffee_shop
confectionery *
 deli *
dessert_restaurant *
dessert_shop *
diner *
dog_cafe *
donut_shop *
fast_food_restaurant
fine_dining_restaurant *
food_court *
french_restaurant
greek_restaurant
hamburger_restaurant
ice_cream_shop
indian_restaurant
indonesian_restaurant
italian_restaurant
japanese_restaurant
juice_shop *
korean_restaurant *
lebanese_restaurant
meal_delivery
meal_takeaway
mediterranean_restaurant
 mexican_restaurant
middle_eastern_restaurant
pizza_restaurant
pub *
ramen_restaurant
restaurant
sandwich_shop
seafood_restaurant
spanish_restaurant
steak_house
sushi_restaurant
tea_house *
thai_restaurant
turkish_restaurant
vegan_restaurant
vegetarian_restaurant
vietnamese_restaurant
wine_bar *
Географические районы
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
hospital
massage *
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 *
Места поклонения
church
hindu_temple
mosque
synagogue
Услуги
astrologer *
barber_shop
beautician *
beauty_salon
body_art_service *
catering_service *
cemetery
child_care_agency
consultant
courier_service
electrician
florist
food_delivery *
foot_care *
funeral_home
hair_care
hair_salon
insurance_agency
laundry *
 lawyer
locksmith
makeup_artist *
moving_company
nail_salon *
painter
plumber
psychic *
real_estate_agency
roofing_contractor
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
butcher_shop *
cell_phone_store
clothing_store
convenience_store
department_store
discount_store
electronics_store
food_store *
furniture_store
gift_shop
grocery_store
hardware_store
home_goods_store		 home_improvement_store
jewelry_store
liquor_store
market
pet_store
shoe_store
shopping_mall
sporting_goods_store
store
supermarket
warehouse_store *
wholesaler
Спорт
arena *
athletic_field
fishing_charter *
fishing_pond *
fitness_center
golf_course
gym
ice_skating_rink *
 playground *
ski_resort
sports_activity_location *
sports_club
sports_coaching *
sports_complex
stadium
swimming_pool
Транспорт
airport
airstrip *
bus_station
bus_stop
ferry_terminal
heliport
international_airport *
light_rail_station
 park_and_ride *
subway_station
taxi_stand
train_station
transit_depot
transit_station
truck_stop

Таблица Б

Значения типа «Место» в таблице 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

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

Перечисление getPlaceTypes в ответе указывает тип адреса . Примерами типов адреса являются почтовый адрес, страна или политическая единица. Массив 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 Код местоположения, полученный из широты и долготы. Плюс-коды могут использоваться для замены уличных адресов в местах, где их нет (где дома не пронумерованы или улицы не имеют названий). Подробнее см. 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 Местоположение остановки автобуса, поезда или общественного транспорта.