地點類型 (新品)

歐洲經濟區 (EEA) 開發人員

簡介

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

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

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

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

關於型別資料表

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

  • 在 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 的回應中使用。請求必須在欄位遮罩中,至少指定 places.typesplaces.primaryType 欄位的其中之一。表 A 中的值將會填入相關欄位。
  • 在 Nearby Search (新版) 的請求中,做為 includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes 參數的值。表 B 中的值將會填入相關欄位。
  • 在 Text Search (新版) 的請求中,做為 includedType 參數的值。
  • 在 Autocomplete (新版) 的請求中,做為 includedPrimaryTypes 參數的值。
  • 做為 Autocomplete (新版) 回應的一部分。

表 B 列出可能在 Place Details (新版)、Nearby Search (新版)、Text Search (新版) 和 Autocomplete (新版) 回應中傳回的其他地點類型值。請求必須在欄位遮罩中,至少指定 places.typesplaces.primaryType 欄位的其中之一。除了在 Autocomplete (新版) 請求中做為 includedPrimaryTypes 參數的值以外,「不得」在請求中使用表 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
Natural Features
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
Google 購物
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 中的地點類型值可能會在 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 陣列表示「地址類型」。地址類型包括街道地址、國家/地區或政治實體。AddressComponent 欄位中的 types 陣列會指出地址各部分的類型。例如門牌號碼或國家/地區。

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

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

地址類型 說明
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_1sublocality_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 地理區域分組 (例如 localitysublocality),在部分國家/地區用於郵寄地址。
room 建築物地址的房號。
street_number 精確的門牌號碼。
bus_station」、「train_station」和「transit_station 公車、火車或大眾運輸站牌的位置。