Loại địa điểm (Mới)

Chọn nền tảng: Android iOS JavaScript Dịch vụ web

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Giới thiệu

Loại địa điểm là những danh mục xác định đặc điểm của một địa điểm. Một địa điểm có thể có một hoặc nhiều loại địa điểm được chỉ định.

Các loại địa điểm được đưa vào phản hồi từ yêu cầu Place Details (Mới), Nearby Search (Mới), Text Search (Mới) và Autocomplete (Mới):

Một địa điểm có thể có một loại chính duy nhất trong loại Bảng A hoặc loại Bảng B được liên kết với địa điểm đó. Ví dụ: loại chính có thể là mexican_restaurant hoặc steak_house.Loại chính có thể bị thiếu nếu loại chính của địa điểm không phải là loại được hỗ trợ. Khi có một loại chính, loại đó luôn là một trong các loại trong trường types.
Một địa điểm có thể có nhiều giá trị loại từ loại Bảng A hoặc loại Bảng B được liên kết với địa điểm đó. Ví dụ: một nhà hàng có thể có các loại sau: seafood_restaurant, restaurant, food, point_of_interest, establishment.
Bạn có thể gắn thẻ địa chỉ và các thành phần địa chỉ của một địa điểm bằng một số loại nhất định trong bảng Các loại địa chỉ và các loại thành phần địa chỉ. Ví dụ: một địa chỉ có thể được gắn thẻ là street_address và một thành phần của địa chỉ có thể được gắn thẻ là street_number.

Bạn cũng có thể chỉ định các loại địa điểm trong yêu cầu. Khi được chỉ định trong yêu cầu, loại này sẽ hoạt động như một bộ lọc để giới hạn phản hồi chỉ bao gồm những địa điểm khớp với các loại được chỉ định.

Giới thiệu về các bảng loại

Bảng A liệt kê các loại được dùng theo những cách sau:

Là một phần của phản hồi từ Place Details (Mới), Nearby Search (Mới) và Text Search (Mới). Yêu cầu phải chỉ định ít nhất một trong các trường places.types hoặc places.primaryType trong mặt nạ trường. Sau đó, các giá trị trong Bảng A sẽ được dùng để điền vào các trường đó.
Trong yêu cầu Tìm kiếm lân cận (Mới), được dùng làm giá trị của tham số includedTypes, excludedTypes, includedPrimaryTypes và excludedPrimaryTypes. Sau đó, các giá trị trong Bảng B sẽ được dùng để điền vào các trường đó.
Là một phần của yêu cầu Tìm kiếm văn bản (Mới), được dùng làm giá trị của tham số includedType.
Trong yêu cầu Autocomplete (Mới), hãy dùng làm giá trị cho tham số includedPrimaryTypes.
Là một phần của phản hồi Tự động hoàn thành (Mới).

Bảng B liệt kê các giá trị loại địa điểm bổ sung cũng có thể được trả về trong Thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới), Tìm kiếm bằng văn bản (Mới) và Phản hồi Tự động hoàn thành (Mới). Yêu cầu phải chỉ định ít nhất một trong các trường places.types hoặc places.primaryType trong mặt nạ trường. Bạn KHÔNG ĐƯỢC sử dụng các giá trị trong Bảng B trong yêu cầu, ngoại trừ các giá trị cho tham số includedPrimaryTypes đối với yêu cầu Tự động hoàn thành (Mới).

Các loại địa chỉ và loại thành phần địa chỉ liệt kê các loại có thể xuất hiện trong một hoặc cả hai loại địa chỉ và mảng loại thành phần địa chỉ trong nội dung phản hồi. Các loại thành phần địa chỉ có thể thay đổi.

Bảng A

Ô tô
Doanh nghiệp
Văn hoá
Giáo dục
Giải trí và thư giãn
Cơ sở vật chất
Tài chính
Đồ ăn và đồ uống
Khu vực địa lý
Chính phủ

Sức khoẻ và sức khoẻ tinh thần
Nhà ở
Cơ sở lưu trú
Đặc điểm tự nhiên
Địa điểm thờ cúng
Dịch vụ
Mua sắm
Thể thao
Giao thông vận tải

Ô tô
`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` *
Doanh nghiệp
`business_center` * `corporate_office` `coworking_space` * `farm` `manufacturer` * `ranch` `supplier` * `television_studio` *
Văn hóa
`art_gallery` `art_museum` * `art_studio` `auditorium` `castle` * `cultural_landmark` `fountain` * `historical_place` `history_museum` *	`monument` `museum` `performing_arts_theater` `sculpture`
Giáo dục
`academic_department` * `educational_institution` * `library` `preschool` `primary_school`	`research_institute` * `school` `secondary_school` `university`
Giải trí và Nghỉ ngơi
`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`
Trang thiết bị
`public_bath` `public_bathroom` `stable`
Tài chính
`accounting` `atm` `bank`
Thực phẩm và đồ uống
`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` *
Khu vực địa lý
`administrative_area_level_1` `administrative_area_level_2` `country`	`locality` `postal_code` `school_district`
Chính phủ
`city_hall` `courthouse` `embassy` `fire_station` `government_office`	`local_government_office` `neighborhood_police_station` (chỉ ở Nhật Bản) `police` `post_office`
Sức khoẻ và lối sống lành mạnh
`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`
Nhà ở
`apartment_building` `apartment_complex` `condominium_complex` `housing_complex`
Phòng cho thuê
`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`
Đối tượng tự nhiên
`beach` `island` * `lake` * `mountain_peak` * `nature_preserve` * `river` * `scenic_spot` * `woods` *
Địa điểm thờ cúng
`buddhist_temple` * `church` `hindu_temple` `mosque` `shinto_shrine` * `synagogue`
Dịch vụ
`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`
Mua sắm
`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` *
Thể thao
`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` *
Vận tải
`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ảng B

Các giá trị Loại địa điểm trong Bảng B có thể được trả về trong phản hồi của Place Details (Mới), Nearby Search (Mới), Text Search (Mới) hoặc Autocomplete (Mới). includedPrimaryTypes cũng hỗ trợ các loại này cho yêu cầu Tự động hoàn thành (Mới).

Các giá trị bổ sung cho loại Địa điểm
`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`

Loại địa chỉ và loại thành phần địa chỉ

Mảng types trong phản hồi cho biết loại địa chỉ. Ví dụ về các loại địa chỉ bao gồm địa chỉ đường phố, quốc gia hoặc thực thể chính trị. Mảng types trong trường AddressComponent cho biết loại của từng phần trong địa chỉ. Ví dụ: số nhà hoặc quốc gia.

Địa chỉ có thể có nhiều loại. Các loại này có thể được coi là "thẻ". Ví dụ: nhiều thành phố được gắn thẻ bằng các loại political và locality.

Các loại sau đây được hỗ trợ và trả về trong cả mảng loại địa chỉ và loại thành phần địa chỉ:

Loại địa chỉ	Mô tả
`street_address`	Địa chỉ đường phố chính xác.
`route`	Một tuyến đường có tên (chẳng hạn như "US 101").
`intersection`	Một giao lộ lớn, thường là nơi giao nhau của hai đường chính.
`political`	Một pháp nhân chính trị. Thông thường, loại này cho biết một đa giác của một số cơ quan hành chính dân sự.
`country`	Thực thể chính trị quốc gia và thường là loại thứ tự cao nhất do Trình mã hoá địa lý trả về.
`administrative_area_level_1`	Một khu vực hành chính cấp một dưới cấp quốc gia. Tại Hoa Kỳ, các cấp hành chính này là tiểu bang. Chỉ một số quốc gia sử dụng các cấp hành chính này. Trong hầu hết các trường hợp, tên viết tắt `administrative_area_level_1` sẽ gần giống với các phân vùng ISO 3166-2 và các danh sách khác được lưu hành rộng rãi; tuy nhiên, điều này không được đảm bảo vì kết quả mã hoá địa lý của chúng tôi dựa trên nhiều tín hiệu và dữ liệu vị trí.
`administrative_area_level_2`	Một khu vực hành chính cấp hai dưới cấp quốc gia. Tại Hoa Kỳ, các cấp hành chính này là hạt. Chỉ một số quốc gia sử dụng các cấp hành chính này.
`administrative_area_level_3`	Khu vực hành chính cấp ba dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính nhỏ. Chỉ một số quốc gia sử dụng các cấp hành chính này.
`administrative_area_level_4`	Khu vực hành chính cấp bốn dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính nhỏ. Chỉ một số quốc gia sử dụng các cấp hành chính này.
`administrative_area_level_5`	Một khu vực hành chính cấp năm dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính nhỏ. Chỉ một số quốc gia sử dụng các cấp hành chính này.
`administrative_area_level_6`	Khu vực hành chính cấp sáu dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính nhỏ. Chỉ một số quốc gia sử dụng các cấp hành chính này.
`administrative_area_level_7`	Khu vực hành chính cấp bảy dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính nhỏ. Chỉ một số quốc gia sử dụng các cấp hành chính này.
`colloquial_area`	Tên thay thế thường dùng cho pháp nhân.
`locality`	Một pháp nhân chính trị của thành phố hoặc thị trấn hợp nhất.
`sublocality`	Một khu vực hành chính cấp một dưới cấp địa phương. Đối với một số vị trí, bạn có thể nhận được một trong các loại bổ sung: `sublocality_level_1` đến `sublocality_level_5`. Mỗi cấp độ tiểu khu vực là một pháp nhân dân sự. Số càng lớn thì khu vực địa lý càng nhỏ.
`neighborhood`	Một khu dân cư có tên.
`premise`	Một vị trí có tên, thường là một toà nhà hoặc một nhóm toà nhà có tên chung.
`subpremise`	Một thực thể có thể định địa chỉ ở dưới cấp cơ sở, chẳng hạn như căn hộ, phòng hoặc dãy phòng.
`plus_code`	Một thông tin tham chiếu được mã hoá về vị trí, bắt nguồn từ vĩ độ và kinh độ. Bạn có thể dùng mã cộng thay cho địa chỉ đường phố ở những nơi không có địa chỉ đường phố (nơi các toà nhà không được đánh số hoặc đường phố không có tên). Hãy truy cập https://plus.codes để biết thông tin chi tiết.
`postal_code`	Mã bưu chính được dùng để gửi thư bưu chính trong quốc gia.
`natural_feature`	Một đặc điểm tự nhiên nổi bật.
`airport`	Một sân bay.
`park`	Một công viên có tên.
`point_of_interest`	Một địa điểm yêu thích có tên. Thông thường, những "POI" này là các thực thể nổi bật tại địa phương và không dễ dàng phù hợp với một danh mục khác, chẳng hạn như "Toà nhà Empire State" hoặc "Tháp Eiffel".

Danh sách trống các loại cho biết không có loại nào đã biết cho thành phần địa chỉ cụ thể (ví dụ: Lieu-dit ở Pháp).

Ngoài những thành phần trên, các thành phần địa chỉ có thể bao gồm các loại được liệt kê bên dưới.

Loại thành phần địa chỉ	Mô tả
`floor`	Tầng của địa chỉ toà nhà.
`establishment`	Thường là một địa điểm chưa được phân loại.
`landmark`	Một địa điểm ở gần được dùng làm điểm tham chiếu để hỗ trợ chỉ đường.
`point_of_interest`	Một địa điểm yêu thích có tên.
`parking`	Bãi đỗ xe hoặc nhà đỗ xe.
`post_box`	Một hộp thư bưu điện cụ thể.
`postal_town`	Một nhóm các khu vực địa lý, chẳng hạn như `locality` và `sublocality`, được dùng cho địa chỉ gửi thư ở một số quốc gia.
`room`	Phòng của địa chỉ toà nhà.
`street_number`	Số nhà chính xác.
`bus_station`, `train_station` và `transit_station`	Vị trí của một bến xe buýt, tàu hoả hoặc phương tiện công cộng.