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

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 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 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 đây: 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 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ề 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à Tìm kiếm văn bản (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 sẵn các 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 tham số includedTypes, excludedTypes, includedPrimaryTypes và excludedPrimaryTypes. Sau đó, các giá trị trong Bảng B sẽ được dùng để điền vào những 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 phản hồi Place Details (Mới), Nearby Search (Mới), Tìm kiếm văn bản (Mới) và 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 Autocomplete (Mới).

Bảng C liệt kê các loại tập hợp có thể được dùng làm giá trị của tham số includedPrimaryTypes trong yêu cầu Tự động hoàn thành (Mới). Bạn không thể chỉ định tập hợp loại bằng bất kỳ giá trị loại nào khác.

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à thư giã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ẻ và thể chất
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 Place Details (Mới), Nearby Search (Mới), Tìm kiếm văn bản (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 hoàn thà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

Bảng C

Bạn có thể dùng các loại tập hợp làm giá trị includedPrimaryTypes trong các yêu cầu Tự động hoàn thành (Mới). Việc sử dụng một bộ sưu tập loại sẽ trả về tất cả kết quả khớp với bất kỳ loại nào được liên kết. Bạn không thể chỉ định các tập hợp loại bằng bất kỳ giá trị loại nào khác.

Bộ sưu tập kiểu	Các loại được đưa vào
(regions)	Bộ lọc cho các khu vực hoặc phân chia, chẳng hạn như khu phố và mã bưu chính.
(cities)	Lọc theo những địa điểm mà Google xác định là thành phố.

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	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 thực thể 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 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 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à quận. 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	Thực thể dân sự 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	Thực thể dân sự 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	Thực thể dân sự 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 thực thể dân sự cấp một dưới một thành phố. Một số vị trí 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	Khu vực lân cận 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ị trí được mã hoá, bắt nguồn từ vĩ độ và kinh độ. Bạn có thể sử dụng Plus Codes để thay thế cho địa chỉ đường phố ở những nơi không có địa chỉ (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 được 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 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 nêu trên, các 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 nơi 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.