地點類型

選取平台： Android iOS JavaScript 網頁服務

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

地點的類型會納入 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 中的值將會填入相關欄位。
  • 在 Nearby Search (新版) 的請求中，做為 includedTypes、excludedTypes、includedPrimaryTypes 和 excludedPrimaryTypes 參數的值。表 B 中的值將會填入相關欄位。
  • 在 Text Search (新版) 的請求中，做為 includedType 參數的值。
  • 在 Place Autocomplete 小工具 (新版) 的請求中，做為 includedPrimaryTypes 參數的值。
  • 在 Place Autocomplete 小工具 (新版) 的回應中使用。

表 B 列出可能在 Place Details (新版)、Nearby Search (新版)、Text Search (新版) 和 Place Autocomplete 小工具 (新版) 回應中傳回的其他地點類型值。請求必須在欄位遮罩中，至少指定 places.types 或 places.primaryType 欄位的其中之一。除了在 Place Autocomplete 小工具 (新版) 請求中做為 includedPrimaryTypes 參數的值以外，「不得」在請求中使用表 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

地址類型和地址元件類型

回應中的 types 陣列表示「地址類型」。地址類型包括街道地址、國家/地區或政治實體。google.maps.places.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」 公車、火車或大眾運輸站牌的位置。