地点类型是用于标识地点特征的类别。 一个地点可以分配有一个或多个地点类型。
地点的类型包含在“地点详情(新)”“附近搜索(新)”“文本搜索(新)”和“自动补全(新)”请求的响应中:
- 一个地点可以有一个来自类型 Table A 或类型 Table B 的主要类型。例如,主要类型可能是
mexican_restaurant或steak_house。如果地点的主要类型是不受支持的类型,则可能缺少主要类型。如果存在主要类型,则该类型始终是types字段中的类型之一。 - 一个地点可以有多个与类型表 A 或类型表 B 关联的类型值。
例如,某餐厅可能具有以下类型:
seafood_restaurant、restaurant、food、point_of_interest、establishment。 - 地点及其地址组成部分可以标记为地址类型和地址组成部分类型表中的某些类型。例如,某个地址可能被标记为
street_address,而该地址的某个组成部分可能被标记为street_number。
您还可以将地点类型指定为请求的一部分。如果在请求中指定,该类型将充当过滤器,以限制响应仅包含与指定类型匹配的地点。
关于类型表
表 A 列出了各种地点类型支持的值:
- 作为“地点详情(新)”“附近搜索(新)”和“文本搜索(新)”响应的一部分返回。然后,系统将使用表 A 中的值来填充这些字段。
- 在“附近搜索(新)”请求中用作
includedTypes、excludedTypes、includedPrimaryTypes和excludedPrimaryTypes参数的值。然后,系统将使用表 B 中的值来填充这些字段。 - 在“文本搜索(新)”请求中用作
includedType参数的值。 - 在“地点自动补全微件(新)”请求中用作
includedPrimaryTypes参数的值。 - 作为“地点自动补全微件(新)”响应的一部分返回。
表 B 列出了也可以在“地点详情(新)”“附近搜索(新)”“文本搜索(新)”和“地点自动补全 widget(新)”响应中返回的其他地点类型值。请求必须在字段掩码中指定 places.types 或 places.primaryType 字段中的至少一个。除了在“地点自动补全 widget(新)”请求中作为 includedPrimaryTypes 参数的值以外,表 B 中的值不能在请求中使用。
地址类型和地址组成部分类型:可能会出现在响应正文中的地址类型和地址组成部分类型数组中的类型列表。地址组成部分类型可能会发生变化。
表 A
| 汽车 | ||
|---|---|---|
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
表 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 数组表示地址类型。地址类型的示例包括街道地址、国家/地区或政治实体。google.maps.places.AddressComponent 类中的 types 数组表示地址每个部分的类型。示例包括门牌号码或国家/地区。
地址可能具有多种类型。这些类型可能会被视为“标记”。
例如,许多城市都带有 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 |
经过编码的位置引用,衍生自纬度和经度。Plus Codes 可用于在没有街道地址的地点(例如建筑物未编号,或者街道未命名)取代街道地址。如需了解详情,请参阅 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 |
公交车站、火车站或公共交通站的位置。 |