ประเภทสถานที่ (ใหม่)

เลือกแพลตฟอร์ม: Android iOS JavaScript Web Service

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

ประเภทสถานที่คือหมวดหมู่ที่ระบุลักษณะของสถานที่ สถานที่หนึ่งๆ อาจมีประเภทสถานที่ที่กำหนดไว้มากกว่า 1 ประเภท

ประเภทของสถานที่รวมอยู่ในการตอบกลับจากคำขอรายละเอียดสถานที่ (ใหม่), การค้นหาใกล้เคียง (ใหม่), การค้นหาข้อความ (ใหม่) และการเติมข้อความอัตโนมัติ (ใหม่) ดังนี้

  • สถานที่หนึ่งๆ จะมีประเภทหลักเดียวจากประเภทใน ตาราง ก หรือประเภทในตาราง ข ที่เชื่อมโยงอยู่ เช่น ประเภทหลักอาจเป็น mexican_restaurant หรือ steak_house ประเภทหลักอาจหายไปหากประเภทหลักของสถานที่นั้นไม่ใช่ประเภทที่รองรับ เมื่อมีประเภทหลัก ประเภทดังกล่าวจะเป็นประเภทใดประเภทหนึ่ง ในประเภทในฟิลด์ types เสมอ
  • สถานที่หนึ่งๆ อาจมีค่าประเภทหลายค่าจากประเภท ตาราง ก หรือประเภทตาราง ข ที่เชื่อมโยงอยู่ เช่น ร้านอาหารอาจมีประเภทต่อไปนี้ seafood_restaurant, restaurant, food point_of_interest, establishment
  • คุณติดแท็กที่อยู่และคอมโพเนนต์ของที่อยู่ของสถานที่ด้วยประเภทบางอย่างจากตารางประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่ได้ เช่น อาจแท็กที่อยู่เป็น street_address และแท็กคอมโพเนนต์ของที่อยู่เป็น street_number

นอกจากนี้ คุณยังระบุประเภทสถานที่เป็นส่วนหนึ่งของคำขอได้ด้วย เมื่อระบุในคำขอ ประเภทจะทำหน้าที่เป็นตัวกรองเพื่อจำกัดการตอบกลับให้รวมเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุ

คุณต้องเปิดใช้ Places API (ใหม่) ในโปรเจ็กต์ Google Cloud เพื่อเข้าถึงประเภทเหล่านี้ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อตั้งค่าโปรเจ็กต์ Google Cloud

เกี่ยวกับตารางประเภท

ตาราง ก แสดงประเภทที่ใช้ใน ลักษณะต่อไปนี้

  • ในส่วนของการตอบกลับจากรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) และ การค้นหาข้อความ (ใหม่) ระบบจะใช้ ค่าในตาราง ก เพื่อป้อนข้อมูลพร็อพเพอร์ตี้ประเภท ของอินสแตนซ์ GMSPlace คำขอต้องระบุ GMSPlacePropertyTypes ในรายการฟิลด์
  • เป็นส่วนหนึ่งของคำขอการค้นหาใกล้เคียง (ใหม่) ซึ่งใช้เป็น ค่าของพารามิเตอร์ประเภทที่รวม ประเภทที่ยกเว้น ประเภทหลักที่รวม และประเภทหลักที่ยกเว้น
  • เป็นส่วนหนึ่งของคำขอการค้นหาข้อความ (ใหม่) ซึ่งใช้เป็น ค่าของพารามิเตอร์ประเภทที่รวมไว้
  • ในส่วนของคำขอ Place Autocomplete (ใหม่) ใช้เป็นค่าสำหรับพารามิเตอร์ประเภท
  • เป็นส่วนหนึ่งของคำตอบ Place Autocomplete (ใหม่) ที่ใช้ในการป้อนข้อมูลพร็อพเพอร์ตี้ประเภทของอินสแตนซ์ GMSAutocompletePlaceSuggestion

ตาราง ข แสดงค่าประเภทสถานที่เพิ่มเติมซึ่ง อาจแสดงเป็นส่วนหนึ่งของการตอบกลับรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) การค้นหาข้อความ (ใหม่) และ การเติมข้อความอัตโนมัติของสถานที่ (ใหม่) คำขอต้อง ระบุ GMSPlacePropertyTypes ในรายการฟิลด์ ค่าจากตาราง ข ใช้เป็นส่วนหนึ่งของคำขอไม่ได้ ยกเว้นค่าสำหรับ พารามิเตอร์ types สำหรับคำขอ Place Autocomplete (ใหม่)

ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่แสดงประเภทที่อาจปรากฏ ในอาร์เรย์ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่ หรือทั้ง 2 อย่างในเนื้อหาการตอบกลับ ประเภทคอมโพเนนต์ของที่อยู่อาจมีการเปลี่ยนแปลง

ตาราง ก

ยานยนต์
car_dealer
car_rental
car_repair
car_wash
electric_vehicle_charging_station
gas_station
parking
rest_stop
ธุรกิจ
corporate_office *
farm
ranch *
วัฒนธรรม
art_gallery
art_studio *
auditorium *
cultural_landmark *
historical_place *
monument *
museum
performing_arts_theater
sculpture *
การศึกษา
library
preschool
primary_school
school
secondary_school
university
สถานบันเทิงและสันทนาการ
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
สิ่งอำนวยความสะดวก
public_bath *
public_bathroom *
stable *
การเงิน
accounting
atm
bank
อาหารและเครื่องดื่ม
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 *
พื้นที่ทางภูมิศาสตร์
administrative_area_level_1
administrative_area_level_2
country
locality
postal_code
school_district
รัฐบาล
city_hall
courthouse
embassy
fire_station
government_office *
local_government_office
neighborhood_police_station (ญี่ปุ่นเท่านั้น)
police
post_office
สุขภาพและความเป็นอยู่ที่ดี
chiropractor *
dental_clinic
dentist
doctor
drugstore
hospital
massage *
medical_lab *
pharmacy
physiotherapist
sauna *
skin_care_clinic *
spa
tanning_studio *
wellness_center *
yoga_studio *
การเคหะ
apartment_building *
apartment_complex *
condominium_complex *
housing_complex *
ที่พัก
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
องค์ประกอบทางธรรมชาติ
beach *
สถานที่สักการะ
church
hindu_temple
mosque
synagogue
บริการ
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
ช็อปปิ้ง
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
กีฬา
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
การขนส่ง
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

ระบบอาจแสดงค่าประเภทสถานที่ในตาราง ข เป็นส่วนหนึ่งของรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) การค้นหาข้อความ (ใหม่) หรือ การเติมข้อความอัตโนมัติ (ใหม่) includedPrimaryTypesยังรองรับคำขอการเติมข้อความอัตโนมัติ (ใหม่) ด้วย

ค่าประเภทสถานที่เพิ่มเติม
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

ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่

types enum ในคลาส GMSPlace ในการตอบกลับจะระบุประเภทที่อยู่ ตัวอย่างประเภทที่อยู่ ได้แก่ ที่อยู่ ถนน ประเทศ หรือหน่วยงานทางการเมือง อาร์เรย์ types ในออบเจ็กต์ GMSAddressComponent จะระบุประเภทของส่วนต่างๆ ของที่อยู่ เช่น หมายเลขถนนหรือประเทศ

ที่อยู่อาจมีหลายประเภท ระบบอาจพิจารณาว่าประเภทดังกล่าวเป็น "แท็ก" ตัวอย่างเช่น เมืองหลายแห่งติดแท็กด้วยประเภท political และ locality

ระบบรองรับประเภทต่อไปนี้และจะแสดงในทั้งอาร์เรย์ ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่

ประเภทที่อยู่ คำอธิบาย
street_address ที่อยู่ที่ถูกต้องแม่นยำ
route เส้นทางที่มีชื่อ (เช่น "US 101")
intersection สี่แยกใหญ่ ซึ่งมักจะเป็นจุดตัดของถนนสายหลัก 2 สาย
political หน่วยงานทางการเมือง โดยปกติแล้ว ประเภทนี้จะระบุรูปหลายเหลี่ยมของการบริหารพลเรือน
country หน่วยงานทางการเมืองระดับประเทศ และมักเป็นประเภทลำดับสูงสุดที่ Geocoder แสดงผล
administrative_area_level_1 หน่วยงานพลเรือนระดับที่ 1 ที่ต่ำกว่าระดับประเทศ ในสหรัฐอเมริกา ระดับการบริหารเหล่านี้คือรัฐ บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้ ในกรณีส่วนใหญ่ administrative_area_level_1ชื่อย่อจะตรงกับส่วนย่อยของ ISO 3166-2 และรายการอื่นๆ ที่เผยแพร่อย่างกว้างขวาง อย่างไรก็ตาม เราไม่รับประกันว่าชื่อย่อจะตรงกันเนื่องจากผลลัพธ์การแปลงรหัสพิกัดภูมิศาสตร์ของเราอิงตามสัญญาณและข้อมูลตำแหน่งที่หลากหลาย
administrative_area_level_2 หน่วยงานพลเรือนระดับที่ 2 ที่ต่ำกว่าระดับประเทศ ในสหรัฐอเมริกา ระดับการบริหารเหล่านี้คือเทศมณฑล บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
administrative_area_level_3 หน่วยงานพลเรือนระดับที่ 3 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
administrative_area_level_4 หน่วยงานพลเรือนระดับที่ 4 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
administrative_area_level_5 หน่วยงานพลเรือนระดับที่ 5 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
administrative_area_level_6 หน่วยงานพลเรือนระดับที่ 6 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
administrative_area_level_7 หน่วยงานพลเรือนระดับที่ 7 ที่ต่ำกว่าระดับประเทศ ประเภทนี้ระบุเขตการปกครองย่อย บางประเทศไม่ได้ใช้การบริหารระดับเหล่านี้
colloquial_area ชื่ออื่นที่ใช้กันโดยทั่วไปสำหรับเอนทิตี
locality หน่วยงานทางการเมืองของเมืองหรือเทศบาลที่จดทะเบียน
sublocality หน่วยงานพลเรือนระดับที่ 1 ที่ต่ำกว่าระดับท้องถิ่น บางสถานที่อาจได้รับประเภทเพิ่มเติมต่อไปนี้ sublocality_level_1 ถึง sublocality_level_5 ระดับเขตย่อยแต่ละระดับเป็นหน่วยงานพลเรือน ตัวเลขที่มากขึ้นแสดงถึงพื้นที่ทางภูมิศาสตร์ที่เล็กลง
neighborhood ย่านที่มีชื่อ
premise สถานที่ที่มีชื่อ ซึ่งมักจะเป็นอาคารหรือกลุ่มอาคารที่มีชื่อร่วมกัน
subpremise หน่วยที่อยู่ซึ่งอยู่ต่ำกว่าระดับสถานที่ เช่น อพาร์ตเมนต์ ห้องชุด หรือห้อง
plus_code การอ้างอิงตำแหน่งที่เข้ารหัสซึ่งได้มาจากละติจูดและลองจิจูด คุณใช้ Plus Codes แทนที่อยู่ได้ในสถานที่ที่ไม่มีที่อยู่ (ไม่มีหมายเลขอ้างอิงอาคารหรือไม่มีชื่อถนน) ดูรายละเอียดได้ที่ https://plus.codes
postal_code รหัสไปรษณีย์ที่ใช้ในการส่งจดหมายภายในประเทศ
natural_feature องค์ประกอบทางธรรมชาติที่โดดเด่น
airport สนามบิน
park สวนสาธารณะที่มีชื่อ
point_of_interest จุดที่น่าสนใจที่มีชื่อ โดยปกติแล้ว "POI" เหล่านี้จะเป็นหน่วยงานท้องถิ่นที่มีชื่อเสียงซึ่งไม่สามารถจัดอยู่ในหมวดหมู่อื่นๆ ได้ง่าย เช่น "ตึกเอ็มไพร์สเตต" หรือ "หอไอเฟล"

รายการประเภทที่ว่างเปล่าแสดงว่าไม่มีประเภทที่รู้จักสำหรับ คอมโพเนนต์ที่อยู่เฉพาะ (เช่น Lieu-dit ในฝรั่งเศส)

นอกจากนี้ คอมโพเนนต์ที่อยู่ยังอาจรวมถึงประเภทที่ระบุไว้ด้านล่างด้วย

ประเภทส่วนประกอบของที่อยู่ คำอธิบาย
floor ชั้นของที่อยู่อาคาร
establishment โดยปกติแล้วจะเป็นสถานที่ที่ยังไม่ได้รับการจัดหมวดหมู่
landmark สถานที่ใกล้เคียงที่ใช้เป็นข้อมูลอ้างอิงเพื่อช่วยในการนำทาง
point_of_interest จุดที่น่าสนใจที่มีชื่อ
parking ที่จอดรถหรืออาคารจอดรถ
post_box ตู้ไปรษณีย์ที่เฉพาะเจาะจง
postal_town การจัดกลุ่มพื้นที่ทางภูมิศาสตร์ เช่น locality และ sublocality ซึ่งใช้สำหรับที่อยู่ไปรษณีย์ในบางประเทศ
room ห้องของที่อยู่อาคาร
street_number หมายเลขถนนที่แน่นอน
bus_station, train_station และ transit_station ตำแหน่งของป้ายรถประจำทาง รถไฟ หรือป้ายขนส่งสาธารณะ