地點類型 (新品)

地點類型是指出地點特徵的類別。 一個地點可以有一或多個指派的地點類型。

地點的類型會納入 Place Details (新版)、Nearby Search (新版)、Text Search (新版) 和 Autocomplete (新版) 要求的回應中：

• 地點只能有一個主要類型，且必須與類型表 A 或類型表 B 相關聯。舉例來說，主要類型可能是 mexican_restaurant 或 steak_house。如果地點的主要類型不受支援，主要類型可能會遺失。如果存在主要類型，則一律為 types 欄位中的類型之一。
• 一個地點可以有多個類型值，這些值來自類型表 A 或類型表 B。舉例來說，餐廳可能具有下列類型： seafood_restaurant、restaurant、food、 point_of_interest、establishment。
• 地點的地址和地址元件可以標記「地址類型和地址元件類型」表格中的特定類型。舉例來說，地址可能會標記為 street_address，而地址的元件可能會標記為 street_number。

您也可以在要求中指定地點類型。在要求中指定類型時，該類型會做為篩選器，限制回應只包含符合指定類型的地點。

關於型別表格

表 A 列出以下用途的類型：

• 在 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 的回應中，表 A 中的值會用於填入 Place 執行個體的 types 屬性。要求必須在欄位清單中指定 Place.Field.TYPES 或 Place.Field.PRIMARY_TYPE。
• 在 Nearby Search (新版) 的請求中，做為 included types、excluded types、included primary types 和 excluded primary types 參數的值。
• 在 Text Search (新版) 的請求中，做為所含類型參數的值。
• 在 Place Autocomplete (新版) 的請求中，做為主要類型參數的值。
• 在 Place Autocomplete (新版) 回應中，用於填入 AutocompletePrediction 執行個體的 types 屬性。

表 B 列出可能在 Place Details (新版)、Nearby Search (新版)、Text Search (新版) 和 Place Autocomplete (新版) 回應中傳回的其他地點類型值。要求必須在欄位清單中指定 Place.Field.TYPES 或 Place.Field.PRIMARY_TYPE。除了在 Place Autocomplete (新版) 請求中做為主要類型參數的值以外，「不得」在請求中使用表 B 中的值。

地址類型和地址元件類型會列出可能出現在回應主體中地址類型和地址元件類型陣列的類型。地址元件類型可能會有變動。

表 A

汽車 商業 文化 教育 娛樂休閒場所 設施 * 金融 餐飲 地理區域 政府機關

健康與保健 房屋 * 住宿地點 自然特徵 * 宗教場所 服務 購物 運動 交通運輸

汽車
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
Natural Features
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

表 B

表 B 中的地點類型值可能會在 Place Details (新版)、Nearby Search (新版)、Text Search (新版) 或 Autocomplete (新版) 回應中傳回。這些類型也支援 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

地址類型和地址元件類型

回應中的 getPlaceTypes 列舉表示「地址類型」。地址類型包括街道地址、國家/地區或政治實體。AddressComponent 類別中的 types 陣列會指出地址各部分的類型。例如門牌號碼或國家/地區。

地址可能有多種類型。這些類型可視為「標記」。 舉例來說，許多城市都會加上 political 和 locality 類型標記。

在地址類型和地址元件類型陣列中，系統會支援及傳回下列類型：

地址類型	說明
street_address	精確的街道地址。
route	具名道路 (例如「國道一號」)。
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」	公車、火車或大眾運輸站牌的位置。