地点类型(新)

请选择平台: Android iOS JavaScript 网络服务

欧洲经济区 (EEA) 开发者

地点类型是用于标识地点特征的类别。 一个地点可以分配有一个或多个地点类型。

地点的类型包含在“地点详情(新)”“附近搜索(新)”“文本搜索(新)”和“自动补全(新)”请求的响应中:

  • 一个地点可以有一个关联的主要类型,该类型来自表 A表 B。例如,主要类型可能是 mexican_restaurantsteak_house。如果地点的主要类型是不受支持的类型,则可能会缺少主要类型。如果存在主要类型,则该类型始终是 types 字段中的类型之一。
  • 一个地点可以有多个与类型表 A 或类型表 B 关联的类型值。 例如,某餐厅可能具有以下类型seafood_restaurantrestaurantfoodpoint_of_interestestablishment
  • 地点及其地址组成部分可以标记为地址类型和地址组成部分类型表中的某些类型。例如,某个地址可能被标记为 street_address,而该地址的某个组成部分可能被标记为 street_number

您还可以将地点类型指定为请求的一部分。如果在请求中指定,则该类型会充当过滤条件,以将响应限制为仅包含与指定类型匹配的地点。

您必须在 Google Cloud 项目中启用 Places API(新)才能访问这些类型。 如需了解详情,请参阅设置您的 Google Cloud 项目

关于类型表

表 A 列出了以下使用方式的类型:

  • 作为“地点详情(新)”“附近搜索(新)”和“文本搜索(新)”响应的一部分,表 A 中的值用于填充 GMSPlace 实例的 types 属性。请求必须在字段列表中指定 GMSPlacePropertyTypes
  • 在“附近搜索(新)”请求中用作所含类型、排除类型、所含主要类型和排除主要类型参数的值。
  • 在“文本搜索(新)”请求中用作所含类型参数的值。
  • 在“地点自动补全(新)”请求中用作 types 参数的值。
  • 作为“地点自动补全(新)”响应的一部分,用于填充 GMSAutocompletePlaceSuggestion 实例的类型属性。

表 B 列出了也可以在“地点详情(新)”“附近搜索(新)”“文本搜索(新)”和“地点自动补全(新)”响应中返回的其他地点类型值。请求必须在字段列表中指定 GMSPlacePropertyTypes。除了在“地点自动补全(新)”请求中作为 types 参数的值以外,表 B 中的值不能在请求中使用。

地址类型和地址组成部分类型列出了可能会出现在响应正文中的地址类型和地址组成部分类型数组中的类型。地址组成部分类型可能会发生变化。

表 A

汽车
car_dealer
car_rental
car_repair
car_wash
ebike_charging_station *
electric_vehicle_charging_station
gas_station
parking
parking_garage *
parking_lot *
rest_stop
tire_shop *
truck_dealer *
企业
business_center *
corporate_office
coworking_space *
farm
manufacturer *
ranch
supplier *
television_studio *
文化
art_gallery
art_museum *
art_studio
auditorium
castle *
cultural_landmark
fountain *
historical_place
history_museum *
monument
museum
performing_arts_theater
sculpture
教育
academic_department *
educational_institution *
library
preschool
primary_school
research_institute *
school
secondary_school
university
休闲娱乐场所
adventure_sports_center
amphitheatre
amusement_center
amusement_park
aquarium
banquet_hall
barbecue_area
botanical_garden
bowling_alley
casino
childrens_camp
city_park *
comedy_club
community_center
concert_hall
convention_center
cultural_center
cycling_park
dance_hall
dog_park
event_venue
ferris_wheel
garden
go_karting_venue *
hiking_area
historical_landmark
indoor_playground *
internet_cafe
karaoke
live_music_venue *
marina
miniature_golf_course *
movie_rental
movie_theater
national_park
night_club
observation_deck
off_roading_area
opera_house
paintball_center *
park
philharmonic_hall
picnic_ground
planetarium
plaza
roller_coaster
skateboard_park
state_park
tourist_attraction
video_arcade
vineyard *
visitor_center
water_park
wedding_venue
wildlife_park
wildlife_refuge
winery *
zoo
设施
public_bath
public_bathroom
stable
财经
accounting
atm
bank
餐饮
acai_shop
afghani_restaurant
african_restaurant
american_restaurant
argentinian_restaurant *
asian_fusion_restaurant *
asian_restaurant
australian_restaurant *
austrian_restaurant *
bagel_shop
bakery
bangladeshi_restaurant *
bar
bar_and_grill
barbecue_restaurant
basque_restaurant *
bavarian_restaurant *
beer_garden *
belgian_restaurant *
bistro *
brazilian_restaurant
breakfast_restaurant
brewery *
brewpub *
british_restaurant *
brunch_restaurant
buffet_restaurant
burmese_restaurant *
burrito_restaurant *
cafe
cafeteria
cajun_restaurant *
cake_shop *
californian_restaurant *
cambodian_restaurant *
candy_store
cantonese_restaurant *
caribbean_restaurant *
cat_cafe
chicken_restaurant *
chicken_wings_restaurant *
chilean_restaurant *
chinese_noodle_restaurant *
chinese_restaurant
chocolate_factory
chocolate_shop
cocktail_bar *
coffee_roastery *
coffee_shop
coffee_stand *
colombian_restaurant *
confectionery
croatian_restaurant *
cuban_restaurant *
czech_restaurant *
danish_restaurant *
deli
dessert_restaurant
dessert_shop
dim_sum_restaurant *
diner
dog_cafe
donut_shop
dumpling_restaurant *
dutch_restaurant *
eastern_european_restaurant *
ethiopian_restaurant *
european_restaurant *
falafel_restaurant *
family_restaurant *
fast_food_restaurant
filipino_restaurant *
fine_dining_restaurant
fish_and_chips_restaurant *
fondue_restaurant *
food_court
french_restaurant
fusion_restaurant *
gastropub *
german_restaurant *
greek_restaurant
gyro_restaurant *
halal_restaurant*
hamburger_restaurant
hawaiian_restaurant *
hookah_bar *
hot_dog_restaurant *
hot_dog_stand *
hot_pot_restaurant *
hungarian_restaurant *
ice_cream_shop
indian_restaurant
indonesian_restaurant
irish_pub *
irish_restaurant *
israeli_restaurant *
italian_restaurant
japanese_curry_restaurant *
japanese_izakaya_restaurant *
japanese_restaurant
juice_shop
kebab_shop *
korean_barbecue_restaurant *
korean_restaurant
latin_american_restaurant *
lebanese_restaurant
lounge_bar *
malaysian_restaurant *
meal_delivery
meal_takeaway
mediterranean_restaurant
mexican_restaurant
middle_eastern_restaurant
mongolian_barbecue_restaurant *
moroccan_restaurant *
noodle_shop *
north_indian_restaurant *
oyster_bar_restaurant *
pakistani_restaurant *
pastry_shop *
persian_restaurant *
peruvian_restaurant *
pizza_delivery *
pizza_restaurant
polish_restaurant *
portuguese_restaurant *
pub
ramen_restaurant
restaurant
romanian_restaurant *
russian_restaurant *
salad_shop *
sandwich_shop
scandinavian_restaurant *
seafood_restaurant
shawarma_restaurant *
snack_bar *
soul_food_restaurant *
soup_restaurant *
south_american_restaurant *
south_indian_restaurant *
southwestern_us_restaurant *
spanish_restaurant
sports_bar *
sri_lankan_restaurant *
steak_house
sushi_restaurant
swiss_restaurant *
taco_restaurant *
taiwanese_restaurant *
tapas_restaurant *
tea_house
tex_mex_restaurant *
thai_restaurant
tibetan_restaurant *
tonkatsu_restaurant *
turkish_restaurant
ukrainian_restaurant *
vegan_restaurant
vegetarian_restaurant
vietnamese_restaurant
western_restaurant *
wine_bar
winery *
yakiniku_restaurant *
yakitori_restaurant *
地理区域
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
general_hospital *
hospital
massage
massage_spa *
medical_center *
medical_clinic *
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
island *
lake *
mountain_peak *
nature_preserve *
river *
scenic_spot *
woods *
礼拜场所
buddhist_temple *
church
hindu_temple
mosque
shinto_shrine *
synagogue
服务
aircraft_rental_service *
association_or_organization *
astrologer
barber_shop
beautician
beauty_salon
body_art_service
catering_service
cemetery
chauffeur_service *
child_care_agency
consultant
courier_service
electrician
employment_agency *
florist
food_delivery
foot_care
funeral_home
hair_care
hair_salon
insurance_agency
laundry
lawyer
locksmith
makeup_artist
marketing_consultant *
moving_company
nail_salon
non_profit_organization *
painter
pet_boarding_service *
pet_care *
plumber
psychic
real_estate_agency
roofing_contractor
service *
shipping_service *
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
building_materials_store *
butcher_shop
cell_phone_store
clothing_store
convenience_store
cosmetics_store *
department_store
discount_store
discount_supermarket *
electronics_store
farmers_market *
flea_market *
food_store
furniture_store
garden_center *
general_store *
gift_shop
grocery_store
hardware_store
health_food_store *
home_goods_store
home_improvement_store
hypermarket *
jewelry_store
liquor_store
market
pet_store
shoe_store
shopping_mall
sporting_goods_store
sportswear_store *
store
supermarket
tea_store *
thrift_store *
toy_store *
warehouse_store
wholesaler
womens_clothing_store *
体育
arena
athletic_field
fishing_charter
fishing_pier *
fishing_pond
fitness_center
golf_course
gym
ice_skating_rink
indoor_golf_course *
playground
race_course *
ski_resort
sports_activity_location
sports_club
sports_coaching
sports_complex
sports_school *
stadium
swimming_pool *
tennis_court *
交通
airport
yakitori_restaurant *
airstrip
bike_sharing_station *
bridge *
bus_station
bus_stop
ferry_service *
ferry_terminal
heliport
international_airport
light_rail_station
park_and_ride
subway_station
taxi_service *
taxi_stand
toll_station *
train_station
train_ticket_office *
tram_stop *
transit_depot
transit_station
transit_stop *
transportation_service *
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

地址类型和地址组成部分类型

响应中 GMSPlace 类中的 types 枚举表示地址类型。地址类型的示例包括街道地址、国家/地区或政治实体。GMSAddressComponent 对象中的 types 数组表示地址每个部分的类型。示例包括门牌号码或国家/地区。

地址可能具有多种类型。这些类型可以视为“标记”。 例如,许多城市都带有 politicallocality 类型的标记。

对于地址类型和地址组成部分类型数组,地理编码器都支持并返回以下类型:

地址类型 说明
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_1sublocality_level_5。每个子级市行政区级别都是一个行政实体。数字越大,表示的地理区域越小
neighborhood 表示已命名的街区。
premise 已命名的位置,通常是具有常见名称的建筑或建筑群。
subpremise 营业场所级别以下的地址实体,例如公寓、单元或套房。
plus_code 经过编码的位置引用,衍生自纬度和经度。在没有街道地址的地点(例如建筑物未编号,或者街道未命名),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 地理区域分组(例如 localitysublocality),在某些国家/地区用于邮寄地址。
room 建筑物地址的房间。
street_number 精确的门牌号。
bus_stationtrain_stationtransit_station 公交车站、火车站或公共交通站的位置。