Типы мест — это категории, определяющие характеристики места. Месту может быть присвоен один или несколько типов мест.
Типы мест включаются в ответ на запрос «Сведения о месте (новое)», «Поиск поблизости (новое)», «Текстовый поиск (новое)» и «Автозаполнение (новое)»:
- С местом может быть связан один основной тип из списка «Таблица A» или « Таблица B» . Например, основным типом может быть
mexican_restaurantилиsteak_house. Основной тип может отсутствовать, если основной тип места не поддерживается. Если основной тип присутствует, он всегда соответствует одному из типов, указанных в полеtypes. - Место может иметь несколько значений типа из таблицы A или таблицы B, связанных с ним. Например, ресторан может иметь следующие типы :
seafood_restaurant,restaurant,food,point_of_interest,establishment. - Адрес и компоненты адреса места можно пометить определёнными типами из таблицы «Типы адресов и типы компонентов адреса» . Например, адрес может быть помечен как
street_address, а компонент адреса — какstreet_number.
Вы также можете указать типы мест в запросе . Указанный в запросе тип действует как фильтр, ограничивая ответ только местами, соответствующими указанным типам.
О таблицах типов
В таблице А перечислены поддерживаемые значения типов мест:
- В качестве части ответа от функций «Информация о месте (новое)», «Поиск поблизости (новое)» и «Текстовый поиск (новое)». Значения из таблицы A затем используются для заполнения этих полей.
- В рамках запроса «Поиск поблизости (новый)» используется в качестве значения параметров
includedTypes,excludedTypes,includedPrimaryTypesиexcludedPrimaryTypes. Значения из таблицы B затем используются для заполнения этих полей. - В рамках запроса текстового поиска (нового) используется в качестве значения параметра
includedType. - В качестве части запроса Place Autocomplete Widget (New) используйте в качестве значений параметр
includedPrimaryTypes. - В рамках ответа виджета автозаполнения мест (новый).
В таблице B перечислены дополнительные значения типов мест, которые также могут быть возвращены в ответах «Информация о месте (новое)», «Поиск рядом (новое)», «Текстовый поиск (новое)» и «Виджет автозаполнения места (новое)». В запросе должно быть указано как минимум одно из полей places.types или places.primaryType в маске поля. Значения из таблицы B НЕЛЬЗЯ использовать в запросе, за исключением значений параметра includedPrimaryTypes для запроса «Виджет автозаполнения места (новое)».
Типы адресов и типы компонентов адреса содержат список типов, которые могут присутствовать в одном или обоих массивах типов адресов и компонентов адреса в теле ответа. Типы компонентов адреса могут изменяться.
Таблица А
| Автомобильная промышленность | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_wash | electric_vehicle_charging_stationgas_stationparkingrest_stop | |
| Бизнес | ||
corporate_office *farmranch * | ||
| Культура | ||
art_galleryart_studio *auditorium *cultural_landmark *historical_place * | monument *museumperforming_arts_theatersculpture * | |
| Образование | ||
librarypreschoolprimary_school | schoolsecondary_schooluniversity | |
| Развлечения и отдых | ||
adventure_sports_center *amphitheatre *amusement_centeramusement_parkaquariumbanquet_hallbarbecue_area *botanical_garden *bowling_alleycasinochildrens_camp *comedy_club *community_centerconcert_hall *convention_centercultural_centercycling_park *dance_hall *dog_parkevent_venue | ferris_wheel *garden *hiking_area *historical_landmarkinternet_cafe *karaoke *marinamovie_rentalmovie_theaternational_parknight_clubobservation_deck *off_roading_area *opera_house *parkphilharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * | skateboard_park *state_park *tourist_attractionvideo_arcade *visitor_centerwater_park *wedding_venuewildlife_park *wildlife_refuge *zoo |
| Удобства | ||
public_bath *public_bathroom *stable * | ||
| Финансы | ||
accountingatmbank | ||
| Еда и напитки | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurantasian_restaurant *bagel_shop *bakerybarbar_and_grill *barbecue_restaurantbrazilian_restaurantbreakfast_restaurantbrunch_restaurantbuffet_restaurant *cafecafeteria *candy_store *cat_cafe *chinese_restaurantchocolate_factory *chocolate_shop *coffee_shopconfectionery * | deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurantfine_dining_restaurant *food_court *french_restaurantgreek_restauranthamburger_restaurantice_cream_shopindian_restaurantindonesian_restaurantitalian_restaurantjapanese_restaurantjuice_shop *korean_restaurant *lebanese_restaurantmeal_deliverymeal_takeawaymediterranean_restaurant | mexican_restaurantmiddle_eastern_restaurantpizza_restaurantpub *ramen_restaurantrestaurantsandwich_shopseafood_restaurantspanish_restaurantsteak_housesushi_restauranttea_house *thai_restaurantturkish_restaurantvegan_restaurantvegetarian_restaurantvietnamese_restaurantwine_bar * |
| Географические районы | ||
administrative_area_level_1administrative_area_level_2country | localitypostal_codeschool_district | |
| Правительство | ||
city_hallcourthouseembassyfire_stationgovernment_office * | local_government_officeneighborhood_police_station (только Япония)policepost_office | |
| Здоровье и благополучие | ||
chiropractor *dental_clinicdentistdoctordrugstorehospitalmassage *medical_lab * | pharmacyphysiotherapistsauna *skin_care_clinic *spatanning_studio *wellness_center *yoga_studio * | |
| Жилье | ||
apartment_building *apartment_complex *condominium_complex *housing_complex * | ||
| Проживание | ||
bed_and_breakfastbudget_japanese_inn *campgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostel *hotel * | inn *japanese_inn *lodgingmobile_home_park *motelprivate_guest_roomresort_hotelrv_park | |
| Природные особенности | ||
beach * | ||
| Места поклонения | ||
churchhindu_templemosquesynagogue | ||
| Услуги | ||
astrologer *barber_shopbeautician *beauty_salonbody_art_service *catering_service *cemeterychild_care_agencyconsultantcourier_serviceelectricianfloristfood_delivery *foot_care *funeral_homehair_carehair_saloninsurance_agencylaundry * | lawyerlocksmithmakeup_artist *moving_companynail_salon *painterplumberpsychic *real_estate_agencyroofing_contractorstoragesummer_camp_organizer *tailortelecommunications_service_providertour_agency *tourist_information_center *travel_agencyveterinary_care | |
| Покупки | ||
asian_grocery_store *auto_parts_storebicycle_storebook_storebutcher_shop *cell_phone_storeclothing_storeconvenience_storedepartment_storediscount_storeelectronics_storefood_store *furniture_storegift_shopgrocery_storehardware_storehome_goods_store | home_improvement_storejewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storestoresupermarketwarehouse_store *wholesaler | |
| Спорт | ||
arena *athletic_fieldfishing_charter *fishing_pond *fitness_centergolf_coursegymice_skating_rink * | playground *ski_resortsports_activity_location *sports_clubsports_coaching *sports_complexstadiumswimming_pool | |
| Транспорт | ||
airportairstrip *bus_stationbus_stopferry_terminalheliportinternational_airport *light_rail_station | park_and_ride *subway_stationtaxi_standtrain_stationtransit_depottransit_stationtruck_stop | |
Таблица Б
Значения типа «Место» в таблице B могут быть возвращены в ответах типа «Информация о месте (новое)», «Поиск поблизости (новое)», «Текстовый поиск (новое)» или «Автозаполнение (новое)». Эти типы также поддерживаются типом includedPrimaryTypes для запросов «Автозаполнение (новое)».
| Дополнительные значения типа места | ||
|---|---|---|
administrative_area_level_3administrative_area_level_4administrative_area_level_5administrative_area_level_6administrative_area_level_7archipelagocolloquial_areacontinentestablishmentfinancefoodgeneral_contractorgeocodehealthintersectionlandmarknatural_featureneighborhoodplace_of_worshipplus_code | point_of_interestpoliticalpostal_code_prefixpostal_code_suffixpostal_townpremiseroutestreet_addresssublocalitysublocality_level_1sublocality_level_2sublocality_level_3sublocality_level_4sublocality_level_5subpremisetown_square | |
Типы адресов и типы компонентов адреса
Массив types в ответе указывает тип адреса . Примеры типов адресов включают почтовый адрес, страну или политическое образование. Массив types в классе google.maps.places.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 | Местоположение остановки автобуса, поезда или общественного транспорта. |