Loại địa điểm

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

Loại địa điểm là các 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 địa điểm được đưa vào phản hồi từ yêu cầu 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à Tự động hoàn thành (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.
  • 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à 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 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 một yêu cầu. Khi được chỉ định trong yêu cầu, loại này đóng vai trò là bộ lọc để chỉ cho phép phản hồi bao gồm những địa điểm khớp với các loại đã chỉ định.

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

Bảng A liệt kê các giá trị được hỗ trợ cho loại địa điểm:

  • Trong phần phản hồi của tính năng Thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm bằng văn bản (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 đượ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 sử 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ị loại địa điểm bổ sung cũng có thể được trả về trong 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. KHÔNG được sử dụng các giá trị trong Bảng B trong một yêu cầu, ngoại trừ các giá trị cho tham số includedPrimaryTypes của yêu cầu tiện ích Tự động hoàn thành địa điểm (Mới).

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 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ô
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ỉ dành cho 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 *
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 *
Đị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ị 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ề 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 loại political và locality.

Các loại sau đây được hỗ trợ và trả về trong cả kiểu địa chỉ và mảng kiểu 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 tên (chẳng hạn như "US 101").
intersection Một giao lộ chính, thường là của hai con đường chính.
political Một thực thể chính trị. Loại này thường 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 mà Trình định vị địa lý trả về.
administrative_area_level_1 Một pháp nhân dân sự cấp một bên 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ẽ khớp gần như hoàn toàn với các tiểu khu 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 pháp nhân dân sự cấp hai bên 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 pháp nhân dân sự cấp ba bên dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính cấp dưới. 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 pháp nhân dân sự cấp thứ tư thấp hơn cấp quốc gia. Loại này cho biết một đơn vị hành chính cấp dưới. 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 pháp nhân dân sự cấp thứ năm bên dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính cấp dưới. 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 pháp nhân dân sự cấp thứ sáu, thấp hơn cấp quốc gia. Loại này cho biết một đơn vị hành chính cấp dưới. 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 pháp nhân dân sự cấp thứ bảy bên dưới cấp quốc gia. Loại này cho biết một đơn vị hành chính cấp dưới. 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 được hợp nhất.
sublocality Một pháp nhân dân sự 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 địa phương phụ là một thực thể dân sự. Số lớn hơn cho biết khu vực địa lý nhỏ hơn.
neighborhood Một khu vực lân cận được đặt tên.
premise Một vị trí được đặt 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ó thể định địa chỉ ở cấp dưới cơ sở, chẳng hạn như căn hộ, phòng hoặc căn hộ.
plus_code Tham chiếu vị trí được mã hoá, bắt nguồn từ vĩ độ và kinh độ. Bạn có thể sử dụng plus code để thay thế địa chỉ đường phố ở những nơi không có địa chỉ đường phố (những nơi không có số nhà hoặc tên đường). Hãy xem https://plus.codes để biết thông tin chi tiết.
postal_code Mã bưu chính dùng để ghi địa chỉ thư bưu chính trong quốc gia.
natural_feature Một đặc điểm tự nhiên nổi bật.
airport Sân bay.
park Một công viên được đặt tên.
point_of_interest Một địa điểm yêu thích được đặt tên. Thông thường, những "điểm yêu thích" 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 loại trống cho biết không có loại nào được 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, 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 thường là một địa điểm chưa được phân loại.
landmark Một địa điểm lân cận được dùng làm thông tin tham khảo để hỗ trợ chỉ đường.
point_of_interest Một địa điểm yêu thích được đặt tên.
parking Bãi đỗ xe hoặc nhà đỗ xe.
post_box Một hòm thư bưu chính 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 bến xe buýt, ga tàu hoặc trạm phương tiện công cộng.