Places UI Kit: Một thư viện có thể sử dụng ngay, cung cấp không gian tuỳ chỉnh và kiểm soát cho nhà phát triển. Hãy dùng thử và chia sẻ ý kiến của bạn về trải nghiệm dùng Bộ giao diện người dùng.

Trang này được dịch bởi Cloud Translation API.

Loại địa điểm

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

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 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à Tự động hoàn thành (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 giá trị được hỗ trợ cho các loại địa điểm:

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). Sau đó, các giá trị trong Bảng A 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 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 Tiện ích tự động hoàn thành địa điểm (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 Tiện ích tự động hoàn thành địa điểm (Mới).

Bảng B liệt kê các giá trị bổ sung về loại địa điểm cũng có thể được trả về trong một phần của phản hồi 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à Tiện ích tự động hoàn thành địa điểm (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 Tiện ích tự động hoàn thành địa điểm (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 *
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`	`electric_vehicle_charging_station` `gas_station` `parking` `rest_stop`
Doanh nghiệp
`corporate_office` * `farm` `ranch` *
Văn hóa
`art_gallery` `art_studio` * `auditorium` * `cultural_landmark` * `historical_place` *	`monument` * `museum` `performing_arts_theater` `sculpture` *
Giáo dục
`library` `preschool` `primary_school`	`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` * `comedy_club` * `community_center` `concert_hall` * `convention_center` `cultural_center` `cycling_park` * `dance_hall` * `dog_park` `event_venue`	`ferris_wheel` * `garden` * `hiking_area` * `historical_landmark` `internet_cafe` * `karaoke` * `marina` `movie_rental` `movie_theater` `national_park` `night_club` `observation_deck` * `off_roading_area` * `opera_house` * `park` `philharmonic_hall` * `picnic_ground` * `planetarium` * `plaza` * `roller_coaster` *	`skateboard_park` * `state_park` * `tourist_attraction` `video_arcade` * `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` `asian_restaurant` * `bagel_shop` * `bakery` `bar` `bar_and_grill` * `barbecue_restaurant` `brazilian_restaurant` `breakfast_restaurant` `brunch_restaurant` `buffet_restaurant` * `cafe` `cafeteria` * `candy_store` * `cat_cafe` * `chinese_restaurant` `chocolate_factory` * `chocolate_shop` * `coffee_shop` `confectionery` *	`deli` * `dessert_restaurant` * `dessert_shop` * `diner` * `dog_cafe` * `donut_shop` * `fast_food_restaurant` `fine_dining_restaurant` * `food_court` * `french_restaurant` `greek_restaurant` `hamburger_restaurant` `ice_cream_shop` `indian_restaurant` `indonesian_restaurant` `italian_restaurant` `japanese_restaurant` `juice_shop` * `korean_restaurant` * `lebanese_restaurant` `meal_delivery` `meal_takeaway` `mediterranean_restaurant`	`mexican_restaurant` `middle_eastern_restaurant` `pizza_restaurant` `pub` * `ramen_restaurant` `restaurant` `sandwich_shop` `seafood_restaurant` `spanish_restaurant` `steak_house` `sushi_restaurant` `tea_house` * `thai_restaurant` `turkish_restaurant` `vegan_restaurant` `vegetarian_restaurant` `vietnamese_restaurant` `wine_bar` *
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` `hospital` `massage` * `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` *
Địa điểm thờ cúng
`church` `hindu_temple` `mosque` `synagogue`
Dịch vụ
`astrologer` * `barber_shop` `beautician` * `beauty_salon` `body_art_service` * `catering_service` * `cemetery` `child_care_agency` `consultant` `courier_service` `electrician` `florist` `food_delivery` * `foot_care` * `funeral_home` `hair_care` `hair_salon` `insurance_agency` `laundry` *	`lawyer` `locksmith` `makeup_artist` * `moving_company` `nail_salon` * `painter` `plumber` `psychic` * `real_estate_agency` `roofing_contractor` `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` `butcher_shop` * `cell_phone_store` `clothing_store` `convenience_store` `department_store` `discount_store` `electronics_store` `food_store` * `furniture_store` `gift_shop` `grocery_store` `hardware_store` `home_goods_store`	`home_improvement_store` `jewelry_store` `liquor_store` `market` `pet_store` `shoe_store` `shopping_mall` `sporting_goods_store` `store` `supermarket` `warehouse_store` * `wholesaler`
Thể thao
`arena` * `athletic_field` `fishing_charter` * `fishing_pond` * `fitness_center` `golf_course` `gym` `ice_skating_rink` *	`playground` * `ski_resort` `sports_activity_location` * `sports_club` `sports_coaching` * `sports_complex` `stadium` `swimming_pool`
Vận tải
`airport` `airstrip` * `bus_station` `bus_stop` `ferry_terminal` `heliport` `international_airport` * `light_rail_station`	`park_and_ride` * `subway_station` `taxi_stand` `train_station` `transit_depot` `transit_station` `truck_stop`

Bảng B

Các giá trị Loại địa điểm trong Bảng B có thể được trả về trong một phần của phản hồi 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) 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ị khác của 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 lớp google.maps.places.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 con đường lớn.
`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. Không phải quốc gia nào cũng 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ẽ 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 thực thể dân sự 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. Không phải quốc gia nào cũng 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 thứ ba dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính nhỏ. Không phải quốc gia nào cũng có các cấp hành chính này.
`administrative_area_level_4`	Một thực thể dân sự cấp thứ tư dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính nhỏ. Không phải quốc gia nào cũng có các cấp hành chính này.
`administrative_area_level_5`	Một thực thể dân sự cấp thứ 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ỏ. Không phải quốc gia nào cũng có các cấp hành chính này.
`administrative_area_level_6`	Một thực thể dân sự cấp thứ 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ỏ. Không phải quốc gia nào cũng có các cấp hành chính này.
`administrative_area_level_7`	Một thực thể dân sự cấp thứ 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ỏ. Không phải quốc gia nào cũng có 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 bên 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 thực thể dân sự. Số càng lớn thì khu vực địa lý càng nhỏ.
`neighborhood`	Một khu phố 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 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`	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, 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ợ việc điều hướ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, nhà ga hoặc trạm dừng phương tiện công cộng.