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

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

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

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

  • Для каждого заведения может быть связан только один основной тип из таблицы типов 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 .
  • В рамках запроса на поиск поблизости (новый) используется в качестве значения параметров включенных типов, исключенных типов, включенных основных типов и исключенных основных типов.
  • В рамках запроса текстового поиска (нового типа) используется в качестве значения включенного параметра типа.
  • В рамках запроса на добавление автозаполнения (нового) используйте эти значения в качестве параметров основных типов.
  • В рамках ответа Place Autocomplete (New) используется для заполнения свойства types экземпляра AutocompletePrediction .

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

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

Таблица А

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

Значения типов мест, указанные в таблице 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 Местоположение остановки автобуса, поезда или другого общественного транспорта.