簡介
地點類型是指出地點特徵的類別。 一個地點可以有一或多個指派的地點類型。
地點的類型會納入 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 (新版) 的回應中使用。請求必須在欄位遮罩中,至少指定
places.types或places.primaryType欄位的其中之一。表 A 中的值將會填入相關欄位。 - 在 Nearby Search (新版) 的請求中,做為
includedTypes、excludedTypes、includedPrimaryTypes和excludedPrimaryTypes參數的值。表 B 中的值將會填入相關欄位。 - 在 Text Search (新版) 的請求中,做為
includedType參數的值。 - 在 Autocomplete (新版) 的請求中,做為
includedPrimaryTypes參數的值。 - 做為 Autocomplete (新版) 回應的一部分。
表 B 列出可能在 Place Details (新版)、Nearby Search (新版)、Text Search (新版) 和 Autocomplete (新版) 回應中傳回的其他地點類型值。請求必須在欄位遮罩中,至少指定 places.types 或 places.primaryType 欄位的其中之一。除了在 Autocomplete (新版) 請求中做為 includedPrimaryTypes 參數的值以外,「不得」在請求中使用表 B 中的值。
地址類型和地址元件類型 清單類型可能會出現在回應主體的地址類型和地址元件類型陣列中。地址元件類型可能會變更。
表 A
| 汽車 | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| 業務 | ||
business_center *corporate_officecoworking_space *farmmanufacturer *ranchsupplier *television_studio * |
||
| 文化 | ||
art_galleryart_museum *art_studioauditoriumcastle *cultural_landmarkfountain *historical_placehistory_museum * |
monumentmuseumperforming_arts_theatersculpture |
|
| 教育 | ||
academic_department *educational_institution *librarypreschoolprimary_school |
research_institute *schoolsecondary_schooluniversity |
|
| 娛樂休閒場所 | ||
adventure_sports_centeramphitheatreamusement_centeramusement_parkaquariumbanquet_hallbarbecue_areabotanical_gardenbowling_alleycasinochildrens_campcity_park *comedy_clubcommunity_centerconcert_hallconvention_centercultural_centercycling_parkdance_halldog_parkevent_venueferris_wheelgardengo_karting_venue * |
hiking_areahistorical_landmarkindoor_playground *internet_cafekaraokelive_music_venue *marinaminiature_golf_course *movie_rentalmovie_theaternational_parknight_clubobservation_deckoff_roading_areaopera_housepaintball_center *parkphilharmonic_hallpicnic_groundplanetariumplazaroller_coasterskateboard_parkstate_park |
tourist_attractionvideo_arcadevineyard *visitor_centerwater_parkwedding_venuewildlife_parkwildlife_refugewinery *zoo
|
| 設施 | ||
public_bathpublic_bathroomstable
|
||
| 財經 | ||
accountingatmbank
|
||
| 餐飲 | ||
acai_shopafghani_restaurantafrican_restaurantamerican_restaurantargentinian_restaurant *asian_fusion_restaurant *asian_restaurantaustralian_restaurant *austrian_restaurant *bagel_shopbakerybangladeshi_restaurant *barbar_and_grillbarbecue_restaurantbasque_restaurant *bavarian_restaurant *beer_garden *belgian_restaurant *bistro *brazilian_restaurantbreakfast_restaurantbrewery *brewpub *british_restaurant *brunch_restaurantbuffet_restaurantburmese_restaurant *burrito_restaurant *cafecafeteriacajun_restaurant *cake_shop *californian_restaurant *cambodian_restaurant *candy_storecantonese_restaurant *caribbean_restaurant *cat_cafechicken_restaurant *chicken_wings_restaurant *chilean_restaurant *chinese_noodle_restaurant *chinese_restaurantchocolate_factorychocolate_shopcocktail_bar *coffee_roastery *coffee_shopcoffee_stand *colombian_restaurant *confectionerycroatian_restaurant *cuban_restaurant *czech_restaurant *danish_restaurant *deli |
dessert_restaurantdessert_shopdim_sum_restaurant *dinerdog_cafedonut_shopdumpling_restaurant *dutch_restaurant *eastern_european_restaurant *ethiopian_restaurant *european_restaurant *falafel_restaurant *family_restaurant *fast_food_restaurantfilipino_restaurant *fine_dining_restaurantfish_and_chips_restaurant *fondue_restaurant *food_courtfrench_restaurantfusion_restaurant *gastropub *german_restaurant *greek_restaurantgyro_restaurant *halal_restaurant* hamburger_restauranthawaiian_restaurant *hookah_bar *hot_dog_restaurant *hot_dog_stand *hot_pot_restaurant *hungarian_restaurant *ice_cream_shopindian_restaurantindonesian_restaurantirish_pub *irish_restaurant *israeli_restaurant *italian_restaurantjapanese_curry_restaurant *japanese_izakaya_restaurant *japanese_restaurantjuice_shopkebab_shop *korean_barbecue_restaurant *korean_restaurantlatin_american_restaurant *lebanese_restaurantlounge_bar *malaysian_restaurant *meal_deliverymeal_takeawaymediterranean_restaurantmexican_restaurantmiddle_eastern_restaurantmongolian_barbecue_restaurant * |
moroccan_restaurant *noodle_shop *north_indian_restaurant *oyster_bar_restaurant *pakistani_restaurant *pastry_shop *persian_restaurant *peruvian_restaurant *pizza_delivery *pizza_restaurantpolish_restaurant *portuguese_restaurant *pubramen_restaurantrestaurantromanian_restaurant *russian_restaurant *salad_shop *sandwich_shopscandinavian_restaurant *seafood_restaurantshawarma_restaurant *snack_bar *soul_food_restaurant *soup_restaurant *south_american_restaurant *south_indian_restaurant *southwestern_us_restaurant *spanish_restaurantsports_bar *sri_lankan_restaurant *steak_housesushi_restaurantswiss_restaurant *taco_restaurant *taiwanese_restaurant *tapas_restaurant *tea_housetex_mex_restaurant *thai_restauranttibetan_restaurant *tonkatsu_restaurant *turkish_restaurantukrainian_restaurant *vegan_restaurantvegetarian_restaurantvietnamese_restaurantwestern_restaurant *wine_barwinery *yakiniku_restaurant *yakitori_restaurant * |
| 地理區域 | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| 政府機關 | ||
city_hallcourthouseembassyfire_stationgovernment_office
|
local_government_officeneighborhood_police_station (僅限日本)policepost_office
|
|
| 健康與保健 | ||
chiropractordental_clinicdentistdoctordrugstoregeneral_hospital *hospitalmassagemassage_spa *medical_center *medical_clinic *medical_lab
|
pharmacyphysiotherapistsaunaskin_care_clinicspatanning_studiowellness_centeryoga_studio
|
|
| 住宅 | ||
apartment_buildingapartment_complexcondominium_complexhousing_complex
|
||
| 住宿地點 | ||
bed_and_breakfastbudget_japanese_inncampgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostelhotel |
innjapanese_innlodgingmobile_home_parkmotelprivate_guest_roomresort_hotelrv_park
|
|
| Natural Features | ||
beachisland *lake *mountain_peak *nature_preserve *river *scenic_spot *woods * |
||
| 廟宇 | ||
buddhist_temple *churchhindu_templemosqueshinto_shrine *synagogue
|
||
| 服務 | ||
aircraft_rental_service *association_or_organization *astrologerbarber_shopbeauticianbeauty_salonbody_art_servicecatering_servicecemeterychauffeur_service *child_care_agencyconsultantcourier_serviceelectricianemployment_agency *floristfood_deliveryfoot_carefuneral_homehair_carehair_saloninsurance_agencylaundrylawyerlocksmith |
makeup_artistmarketing_consultant *moving_companynail_salonnon_profit_organization *painterpet_boarding_service *pet_care *plumberpsychicreal_estate_agencyroofing_contractorservice *shipping_service *storagesummer_camp_organizertailortelecommunications_service_providertour_agencytourist_information_centertravel_agencyveterinary_care
|
|
| Google 購物 | ||
asian_grocery_storeauto_parts_storebicycle_storebook_storebuilding_materials_store *butcher_shopcell_phone_storeclothing_storeconvenience_storecosmetics_store *department_storediscount_storediscount_supermarket *electronics_storefarmers_market *flea_market *food_storefurniture_storegarden_center *general_store *gift_shopgrocery_storehardware_storehealth_food_store *home_goods_store
|
home_improvement_storehypermarket *jewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storesportswear_store *storesupermarkettea_store *thrift_store *toy_store *warehouse_storewholesalerwomens_clothing_store * |
|
| 運動 | ||
arenaathletic_fieldfishing_charterfishing_pier *fishing_pondfitness_centergolf_coursegymice_skating_rinkindoor_golf_course * |
playgroundrace_course *ski_resortsports_activity_locationsports_clubsports_coachingsports_complexsports_school *stadiumswimming_pool *tennis_court * |
|
| 交通運輸 | ||
airportyakitori_restaurant *airstripbike_sharing_station *bridge *bus_stationbus_stopferry_service *ferry_terminalheliportinternational_airportlight_rail_stationpark_and_ride |
subway_stationtaxi_service *taxi_standtoll_station *train_stationtrain_ticket_office *tram_stop *transit_depottransit_stationtransit_stop *transportation_service *truck_stop
|
|
表 B
表 B 中的地點類型值可能會在 Place Details (新版)、Nearby Search (新版)、Text Search (新版) 或 Autocomplete (新版) 回應中傳回。這些類型也支援 includedPrimaryTypes 的 Autocomplete (New) 要求。
| 其他地點類型值 | ||
|---|---|---|
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 陣列表示「地址類型」。地址類型包括街道地址、國家/地區或政治實體。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」 |
公車、火車或大眾運輸站牌的位置。 |