ประเภทสถานที่คือหมวดหมู่ที่ระบุลักษณะของสถานที่ สถานที่หนึ่งๆ อาจมีประเภทสถานที่ที่กำหนดไว้มากกว่า 1 ประเภท
ประเภทของสถานที่รวมอยู่ในการตอบกลับจากคำขอรายละเอียดสถานที่ (ใหม่), การค้นหาใกล้เคียง (ใหม่), การค้นหาข้อความ (ใหม่) และการเติมข้อความอัตโนมัติ (ใหม่) ดังนี้
- สถานที่หนึ่งๆ มีประเภทหลักเดียวจากประเภท
ตาราง ก หรือประเภทตาราง ข ที่เชื่อมโยงอยู่ได้
เช่น ประเภทหลักอาจเป็น
mexican_restaurantหรือsteak_houseประเภทหลักอาจหายไปหากประเภทหลักของสถานที่ ไม่ใช่ประเภทที่รองรับ เมื่อมีประเภทหลัก จะเป็นหนึ่งในประเภทในฟิลด์typesเสมอ - สถานที่หนึ่งๆ อาจมีค่าประเภทหลายค่าจากประเภท
ตาราง ก หรือประเภทตาราง ข ที่เชื่อมโยงอยู่
เช่น ร้านอาหารอาจมีประเภทต่อไปนี้
seafood_restaurant,restaurant,foodpoint_of_interest,establishment - คุณติดแท็กที่อยู่และคอมโพเนนต์ของที่อยู่ของสถานที่ด้วยประเภทบางอย่างจากตารางประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่ได้ เช่น อาจแท็กที่อยู่เป็น
street_addressและแท็กคอมโพเนนต์ของที่อยู่เป็นstreet_number
นอกจากนี้ คุณยังระบุประเภทสถานที่เป็นส่วนหนึ่งของคำขอได้ด้วย เมื่อระบุในคำขอ ประเภทจะทำหน้าที่เป็นตัวกรองเพื่อจำกัดการตอบกลับให้รวมเฉพาะสถานที่ที่ตรงกับประเภทที่ระบุ
เกี่ยวกับตารางประเภท
ตาราง ก แสดงค่าที่รองรับสำหรับประเภทสถานที่
- เป็นส่วนหนึ่งของการตอบกลับจากรายละเอียดสถานที่ (ใหม่) การค้นหาใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) จากนั้นระบบจะใช้ค่าในตาราง ก. เพื่อป้อนข้อมูลในช่องเหล่านั้น
- เป็นส่วนหนึ่งของคำขอการค้นหาใกล้เคียง (ใหม่) ใช้เป็นค่าของพารามิเตอร์
includedTypes,excludedTypes,includedPrimaryTypesและexcludedPrimaryTypesจากนั้นระบบจะใช้ค่าในตาราง B เพื่อป้อนข้อมูลในช่องเหล่านั้น - เป็นส่วนหนึ่งของคำขอการค้นหาข้อความ (ใหม่) ใช้เป็น
ค่าของพารามิเตอร์
includedType - เป็นส่วนหนึ่งของคำขอ Place Autocomplete Widget (ใหม่)
ใช้เป็นค่าสำหรับพารามิเตอร์
includedPrimaryTypes - เป็นส่วนหนึ่งของการตอบกลับวิดเจ็ตการเติมข้อความอัตโนมัติของสถานที่ (ใหม่)
ตาราง ข แสดงค่าประเภทสถานที่เพิ่มเติมซึ่ง
อาจแสดงเป็นส่วนหนึ่งของการตอบกลับรายละเอียดสถานที่ (ใหม่)
การค้นหาใกล้เคียง (ใหม่)
การค้นหาข้อความ (ใหม่) และ
วิดเจ็ตการเติมข้อความอัตโนมัติของสถานที่ (ใหม่) คำขอต้องระบุฟิลด์ places.types หรือ places.primaryType อย่างน้อย 1 รายการในฟิลด์มาสก์
ห้ามใช้ค่าจากตาราง ข เป็นส่วนหนึ่งของคำขอ ยกเว้นค่าสำหรับพารามิเตอร์ includedPrimaryTypes
สำหรับคำขอวิดเจ็ตการเติมข้อความอัตโนมัติของสถานที่ (ใหม่)
ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่แสดงประเภทที่อาจปรากฏ ในอาร์เรย์ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่ หรือทั้ง 2 อย่างในเนื้อหา การตอบกลับ ประเภทคอมโพเนนต์ของที่อยู่อาจมีการเปลี่ยนแปลง
ตาราง ก
| ยานยนต์ | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_wash |
electric_vehicle_charging_stationgas_stationparkingrest_stop |
|
| ธุรกิจ | ||
corporate_office *farmranch * |
||
| วัฒนธรรม | ||
art_galleryart_studio *auditorium *cultural_landmark *historical_place * |
monument *museumperforming_arts_theatersculpture * |
|
| การศึกษา | ||
librarypreschoolprimary_school
|
schoolsecondary_schooluniversity
|
|
| สถานบันเทิงและสันทนาการ | ||
adventure_sports_center *amphitheatre *amusement_centeramusement_parkaquariumbanquet_hallbarbecue_area *botanical_garden *bowling_alleycasinochildrens_camp *comedy_club *community_centerconcert_hall *convention_centercultural_centercycling_park *dance_hall *dog_parkevent_venue |
ferris_wheel *garden *hiking_area *historical_landmarkinternet_cafe *karaoke *marinamovie_rentalmovie_theaternational_parknight_clubobservation_deck *off_roading_area *opera_house *parkphilharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * |
skateboard_park *state_park *tourist_attractionvideo_arcade *visitor_centerwater_park *wedding_venuewildlife_park *wildlife_refuge *zoo
|
| สิ่งอำนวยความสะดวก | ||
public_bath *public_bathroom *stable *
|
||
| การเงิน | ||
accountingatmbank
|
||
| อาหารและเครื่องดื่ม | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurantasian_restaurant *bagel_shop *bakerybarbar_and_grill *barbecue_restaurantbrazilian_restaurantbreakfast_restaurantbrunch_restaurantbuffet_restaurant *cafecafeteria *candy_store *cat_cafe *chinese_restaurantchocolate_factory *chocolate_shop *coffee_shopconfectionery * |
deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurantfine_dining_restaurant *food_court *french_restaurantgreek_restauranthamburger_restaurantice_cream_shopindian_restaurantindonesian_restaurantitalian_restaurantjapanese_restaurantjuice_shop *korean_restaurant *lebanese_restaurantmeal_deliverymeal_takeawaymediterranean_restaurant |
mexican_restaurantmiddle_eastern_restaurantpizza_restaurantpub *ramen_restaurantrestaurantsandwich_shopseafood_restaurantspanish_restaurantsteak_housesushi_restauranttea_house *thai_restaurantturkish_restaurantvegan_restaurantvegetarian_restaurantvietnamese_restaurantwine_bar *
|
| พื้นที่ทางภูมิศาสตร์ | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| รัฐบาล | ||
city_hallcourthouseembassyfire_stationgovernment_office *
|
local_government_officeneighborhood_police_station (ญี่ปุ่นเท่านั้น)policepost_office
|
|
| สุขภาพและความเป็นอยู่ที่ดี | ||
chiropractor *dental_clinicdentistdoctordrugstorehospitalmassage *medical_lab *
|
pharmacyphysiotherapistsauna *skin_care_clinic *spatanning_studio *wellness_center *yoga_studio *
|
|
| การเคหะ | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
| ที่พัก | ||
bed_and_breakfastbudget_japanese_inn *campgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostel *hotel * |
inn *japanese_inn *lodgingmobile_home_park *motelprivate_guest_roomresort_hotelrv_park
|
|
| องค์ประกอบทางธรรมชาติ | ||
beach *
|
||
| สถานที่สักการะ | ||
churchhindu_templemosquesynagogue
|
||
| บริการ | ||
astrologer *barber_shopbeautician *beauty_salonbody_art_service *catering_service *cemeterychild_care_agencyconsultantcourier_serviceelectricianfloristfood_delivery *foot_care *funeral_homehair_carehair_saloninsurance_agencylaundry * |
lawyerlocksmithmakeup_artist *moving_companynail_salon *painterplumberpsychic *real_estate_agencyroofing_contractorstoragesummer_camp_organizer *tailortelecommunications_service_providertour_agency *tourist_information_center *travel_agencyveterinary_care
|
|
| ช็อปปิ้ง | ||
asian_grocery_store *auto_parts_storebicycle_storebook_storebutcher_shop *cell_phone_storeclothing_storeconvenience_storedepartment_storediscount_storeelectronics_storefood_store *furniture_storegift_shopgrocery_storehardware_storehome_goods_store
|
home_improvement_storejewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storestoresupermarketwarehouse_store *wholesaler
|
|
| กีฬา | ||
arena *athletic_fieldfishing_charter *fishing_pond *fitness_centergolf_coursegymice_skating_rink * |
playground *ski_resortsports_activity_location *sports_clubsports_coaching *sports_complexstadiumswimming_pool
|
|
| การขนส่ง | ||
airportairstrip *bus_stationbus_stopferry_terminalheliportinternational_airport *light_rail_station |
park_and_ride *subway_stationtaxi_standtrain_stationtransit_depottransit_stationtruck_stop
|
|
ตาราง B
ระบบอาจแสดงค่าประเภทสถานที่ในตาราง ข เป็นส่วนหนึ่งของรายละเอียดสถานที่ (ใหม่)
การค้นหาใกล้เคียง (ใหม่)
การค้นหาข้อความ (ใหม่) หรือ
การเติมข้อความอัตโนมัติ (ใหม่) includedPrimaryTypesยังรองรับคำขอการเติมข้อความอัตโนมัติ (ใหม่)
ด้วย
| ค่าประเภทสถานที่เพิ่มเติม | ||
|---|---|---|
administrative_area_level_3administrative_area_level_4administrative_area_level_5administrative_area_level_6administrative_area_level_7archipelagocolloquial_areacontinentestablishmentfinancefoodgeneral_contractorgeocodehealthintersectionlandmarknatural_featureneighborhoodplace_of_worshipplus_code
|
point_of_interestpoliticalpostal_code_prefixpostal_code_suffixpostal_townpremiseroutestreet_addresssublocalitysublocality_level_1sublocality_level_2sublocality_level_3sublocality_level_4sublocality_level_5subpremisetown_square
|
|
ประเภทที่อยู่และประเภทคอมโพเนนต์ของที่อยู่
อาร์เรย์ types ในการตอบกลับจะระบุประเภทที่อยู่
ตัวอย่างประเภทที่อยู่ ได้แก่ ที่อยู่ ถนน ประเทศ หรือหน่วยงานทางการเมือง อาร์เรย์ types ในคลาส google.maps.places.AddressComponent จะระบุประเภทของแต่ละส่วนของที่อยู่ เช่น หมายเลขถนนหรือประเทศ
ที่อยู่อาจมีหลายประเภท ระบบอาจพิจารณาว่าประเภทดังกล่าวเป็น "แท็ก"
ตัวอย่างเช่น เมืองหลายแห่งติดแท็กด้วยประเภท 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 |
ตำแหน่งของป้ายรถประจำทาง รถไฟ หรือป้ายขนส่งสาธารณะ |