Типы мест — это категории, которые определяют характеристики места. Место может иметь один или несколько типов мест, назначенных ему.
Типы мест включаются в ответ на запрос «Сведения о месте (новое)», «Поиск поблизости (новое)», «Текстовый поиск (новое)» и «Автозаполнение (новое)»:
- Место может иметь один основной тип из типа 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). В запросе должно быть указано по крайней мере одно из полей
places.types
илиplaces.primaryType
в маске поля. Затем значения в таблице A используются для заполнения этих полей. - Как часть запроса Nearby Search (New), используется как значение параметра
includedTypes
,excludedTypes
,includedPrimaryTypes
иexcludedPrimaryTypes
. Значения в таблице B затем используются для заполнения этих полей. - В рамках запроса текстового поиска (новый) используется в качестве значения параметра
includedType
. - В рамках запроса Autocomplete (New) используйте в качестве значений параметр
includedPrimaryTypes
. - Как часть ответа автозаполнения (нового).
Таблица B содержит дополнительные значения типа места, которые также могут быть возвращены как часть ответа Place Details (New), Nearby Search (New), Text Search (New) и Autocomplete (New). В запросе должно быть указано по крайней мере одно из полей places.types
или places.primaryType
в маске поля. Значения из таблицы B НЕ могут использоваться как часть запроса, за исключением значений параметра includedPrimaryTypes
для запроса 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 |
Таблица Б
Значения типа Place в Таблице B могут быть возвращены как часть ответа Place Details (New), Nearby Search (New), Text Search (New) или Autocomplete (New). Эти типы также поддерживаются includedPrimaryTypes
для запросов Autocomplete (New).
Дополнительные значения типа места | ||
---|---|---|
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
в ответе указывает тип адреса . Примеры типов адресов включают почтовый адрес, страну или политическую единицу. Массив 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 | Местоположение остановки автобуса, поезда или общественного транспорта. |