Типы мест — это категории, которые определяют характеристики места. Место может иметь один или несколько типов мест, назначенных ему.
Типы мест включаются в ответ на запрос «Сведения о месте (новое)», «Поиск поблизости (новое)», «Текстовый поиск (новое)» и «Автозаполнение (новое)»:
- Место может иметь один основной тип из типа Table A или типа Table B, связанный с ним. Например, основным типом может быть
mexican_restaurant
илиsteak_house
. - Место может иметь несколько значений типа из таблицы A или таблицы B, связанных с ним. Например, ресторан может иметь следующие типы :
seafood_restaurant
,restaurant
,food
,point_of_interest
,establishment
. - Адрес и компоненты адреса места могут быть помечены определенными типами из таблицы Типы адресов и типы компонентов адреса . Например, адрес может быть помечен как
street_address
, а компонент адреса может быть помечен какstreet_number
.
Вы также можете указать типы мест как часть запроса . При указании в запросе тип действует как фильтр, ограничивая ответ только теми местами, которые соответствуют указанным типам.
О таблицах типов
В таблице А перечислены типы, которые используются следующими способами:
- В качестве части ответа от Place Details (New), Nearby Search (New) и Text Search (New) значения в таблице A используются для заполнения свойства types экземпляра
Place
. В запросе необходимо указатьPlace.Field.TYPES
илиPlace.Field.PRIMARY_TYPE
в списке полей. - В рамках запроса Nearby Search (New) используется в качестве значения параметров включенных типов, исключенных типов, включенных основных типов и исключенных основных типов.
- В рамках запроса текстового поиска (новый) используется в качестве значения включенного параметра типа.
- В рамках запроса Place Autocomplete (New) используйте в качестве значений параметр основных типов.
- Как часть ответа Place Autocomplete (New), используемого для заполнения свойства types экземпляра
AutocompletePrediction
.
Таблица B содержит дополнительные значения типа места, которые также могут быть возвращены как часть ответа Place Details (New), Nearby Search (New), Text Search (New) и Place Autocomplete (New). В запросе необходимо указать Place.Field.TYPES
или Place.Field.PRIMARY_TYPE
в списке полей. Значения из таблицы B НЕ могут использоваться как часть запроса, за исключением значений параметра primary types для запроса Place Autocomplete (New).
Типы адресов и типы компонентов адресов перечисляют типы, которые могут появляться в одном или обоих массивах типа адреса и типа компонента адреса в теле ответа. Типы компонентов адреса могут изменяться.
Таблица А
Автомобильный | ||
---|---|---|
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 |
Таблица Б
Дополнительные значения типа места | ||
---|---|---|
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 to sublocality_level_5 . Каждый уровень населенного пункта является гражданской сущностью. Большие числа указывают на меньшую географическую область. |
neighborhood | Названный район. |
premise | Имеющее название место, обычно здание или группа зданий с общим названием. |
subpremise | Адресуемая сущность, расположенная ниже уровня помещения, например, квартира, блок или апартаменты. |
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 | Местоположение остановки автобуса, поезда или общественного транспорта. |