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

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 chỉ định một hoặc nhiều loại địa điểm.

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

• Một địa điểm có thể có một loại chính 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ụ: 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ó loại chính, loại này 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 thuộc loại Bảng A hoặc loại Bảng B 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.
• Địa chỉ và thành phần địa chỉ của một địa điểm có thể được gắn thẻ bằng một số loại nhất định trong bảng Loại địa chỉ và 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 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:

• Trong phản hồi từ Place Details (New), Nearby Search (New) và Tìm kiếm văn bản (New), các giá trị trong Bảng A được dùng để điền sẵn thuộc tính types của thực thể Place. Yêu cầu phải chỉ định Place.Field.TYPES hoặc Place.Field.PRIMARY_TYPE trong danh sách trường.
• Là một phần của yêu cầu Nearby Search (Mới), được dùng làm giá trị của các tham số loại được đưa vào, loại bị loại trừ, loại chính được đưa vào và loại chính bị loại trừ.
• 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ố loại được đưa vào.
• Trong yêu cầu của tính năng Place Autocomplete (Mới), hãy sử dụng làm giá trị cho tham số loại chính.
• Là một phần của phản hồi Place Autocomplete (Mới) dùng để điền sẵn thuộc tính types của thực thể AutocompletePrediction.

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 một phần của phản hồi Place Details (Mới), Nearby Search (Mới), Tìm kiếm văn bản (Mới) và Place Autocomplete (Mới). Yêu cầu phải chỉ định Place.Field.TYPES hoặc Place.Field.PRIMARY_TYPE trong danh sách trường. KHÔNG 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ố loại chính cho yêu cầu Place Autocomplete (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 mảng loại địa chỉ và loại thành phần địa chỉ trong phần 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à tiêu khiển Cơ sở vật chất Tài chính Thực phẩm và đồ uống Khu vực địa lý Chính phủ

Sức khoẻ và thể chất Nhà ở Dịch vụ 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 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ẻ thể chất và tinh thần
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
Nhà ở
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 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 yêu cầu Place Details (Mới), Nearby Search (Mới), Tìm kiếm văn bản (Mới) hoặc Tự động hoàn thành (Mới). includedPrimaryTypes cũng hỗ trợ các loại này cho yêu cầu của tính năng Tự động hoàn thành (Mới).

Các giá trị loại địa điểm khác
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ỉ

Enum getPlaceTypes 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 pháp nhân chính trị. Mảng types trong lớp 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à mảng 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	Tuyến đường có tên (chẳng hạn như "US 101").
intersection	Giao lộ lớn, thường là 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 đ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 mà Bộ mã hoá địa lý trả về.
administrative_area_level_1	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 có các cấp hành chính này. Trong hầu hết các trường hợp, tên ngắn administrative_area_level_1 sẽ khớp gần đúng với các phân khu ISO 3166-2 và các danh sách được lưu hành rộng rãi khác; 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	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à quận. Chỉ một số quốc gia có các cấp hành chính này.
administrative_area_level_3	Một thực thể dân sự 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 có 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 có các cấp hành chính này.
administrative_area_level_5	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 có 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 thực thể.
locality	Một pháp nhân chính trị là 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 một đị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 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 tập hợp các toà nhà có tên chung.
subpremise	Một thực thể có địa chỉ bên dưới cấp cơ sở, chẳng hạn như căn hộ, đơn vị hoặc phòng.
plus_code	Một thông tin tham chiếu về vị trí được mã hoá, bắt nguồn từ vĩ độ và kinh độ. Bạn có thể dùng Plus Codes 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 xem https://plus.codes để biết thông tin chi tiết.
postal_code	Mã bưu chính dùng để gửi thư bưu chính trong quốc gia.
natural_feature	Một đối tượng tự nhiên nổi bật.
airport	Một sân bay.
park	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 "địa điểm yêu thích" này là các địa điểm nổi bật tại địa phương 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 loại trống 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 các thành phần nêu trên, thành phần địa chỉ có thể bao gồm các loại được liệt kê dưới đây.

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òm 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 trạm xe buýt, tàu hoả hoặc phương tiện công cộng.