장소 유형

플랫폼 선택: Android iOS JavaScript 웹 서비스

장소 유형은 장소의 특징을 식별하는 카테고리입니다. 장소에는 하나 이상의 장소 유형이 할당될 수 있습니다.

장소의 유형은 장소 세부정보 (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규), 자동 완성 (신규) 요청의 응답에 포함됩니다.

  • 장소에는 유형 표 A 또는 유형 표 B의 단일 기본 유형이 연결될 수 있습니다. 예를 들어 기본 유형은 mexican_restaurant 또는 steak_house일 수 있습니다.장소의 기본 유형이 지원되는 유형이 아닌 경우 기본 유형이 누락될 수 있습니다. 기본 유형이 있으면 항상 types 필드의 유형 중 하나입니다.
  • 장소에는 유형 표 A 또는 유형 표 B의 여러 유형 값이 연결될 수 있습니다. 예를 들어 레스토랑에는 seafood_restaurant, restaurant, food, point_of_interest, establishment와 같은 유형이 있을 수 있습니다.
  • 장소의 주소와 주소 구성요소에는 주소 유형 및 주소 구성요소 유형 표의 특정 유형을 태그할 수 있습니다. 예를 들어 주소는 street_address로 태그가 지정되고 주소의 구성요소는 street_number로 태그가 지정될 수 있습니다.

요청의 일부로 장소 유형을 지정할 수도 있습니다. 요청에 지정된 경우 유형은 지정된 유형과 일치하는 장소만 포함하도록 응답을 제한하는 필터 역할을 합니다.

유형 테이블 정보

표 A에는 지원되는 장소 유형 값이 나열됩니다.

  • 장소 세부정보(신규), 주변 지역 검색(신규), 텍스트 검색(신규) 응답의 일부로. 그런 다음 표 A의 값이 이러한 필드를 채우는 데 사용됩니다.
  • 주변 지역 검색(신규) 요청의 일부로, includedTypes, excludedTypes, includedPrimaryTypes, excludedPrimaryTypes 매개변수의 값으로 사용됩니다. 그런 다음 표 B의 값이 이러한 필드를 채우는 데 사용됩니다.
  • 텍스트 검색(신규) 요청의 일부로, includedType 매개변수의 값으로 사용됩니다.
  • Place Autocomplete Widget (신규) 요청의 일부로, includedPrimaryTypes 매개변수의 값으로 사용됩니다.
  • Place Autocomplete Widget (신규) 응답의 일부로.

표 B에는 장소 세부정보 (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규), Place Autocomplete 위젯 (신규) 응답의 일부로 반환될 수도 있는 추가 장소 유형 값이 나열되어 있습니다. 요청은 필드 마스크에 places.types 또는 places.primaryType 필드 중 하나 이상을 지정해야 합니다. 표 B의 값은 Place Autocomplete Widget (신규) 요청의 includedPrimaryTypes 매개변수 값을 제외하고 요청의 일부로 사용할 수 없습니다.

주소 유형 및 주소 구성요소 유형은 응답 본문의 주소 유형 및 주소 구성요소 유형 배열 중 하나 또는 둘 다에 표시될 수 있는 유형을 나열합니다. 주소 구성요소 유형은 변경될 수 있습니다.

표 A

자동차
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

표 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 배열은 주소 유형을 나타냅니다. 주소 유형의 예로는 상세 주소, 국가 또는 정치적 독립체가 있습니다. google.maps.places.AddressComponent 클래스의 types 배열은 주소의 각 부분 유형을 나타냅니다. 예에는 번지 또는 국가가 포함됩니다.

주소에는 여러 유형이 있을 수 있습니다. 유형은 '태그'로 간주될 수도 있습니다. 예를 들어 많은 도시가 political 및 locality 유형으로 태그됩니다.

주소 유형과 주소 구성요소 유형 배열 모두에서 다음과 같은 유형이 지원되고 반환됩니다.

주소 유형 설명
street_address 정확한 상세 주소입니다.
route 이름이 지정된 경로 (예: 'US 101')
intersection 주요 교차로(일반적으로 두 주요 도로의 교차로)입니다.
political 정치적 독립체입니다. 일반적으로 이 유형은 일부 정부 행정 구역의 폴리곤을 나타냅니다.
country 전국적인 정치적 독립체로, 일반적으로 지오코더에서 반환하는 순위가 가장 높은 유형입니다.
administrative_area_level_1 국가 수준 아래 첫 번째 행정 독립체입니다. 미국 내에서, 이러한 행정 레벨은 주입니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다. 대부분의 경우 administrative_area_level_1 짧은 이름은 ISO 3166-2 하위 구역이나 기타 널리 보급된 목록들과 거의 일치하지만 지오코딩 결과는 다양한 신호와 위치 데이터를 기반으로 하기 때문에 이러한 일치가 보장되지는 않습니다.
administrative_area_level_2 국가 수준 아래 두 번째 행정 독립체입니다. 미국 내에서, 이러한 행정 레벨은 카운티입니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
administrative_area_level_3 국가 수준 아래 세 번째 행정 독립체입니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
administrative_area_level_4 국가 수준 아래 네 번째 행정 독립체입니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
administrative_area_level_5 국가 수준 아래 다섯 번째 행정 독립체입니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
administrative_area_level_6 국가 수준 아래 여섯 번째 행정 독립체입니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
administrative_area_level_7 국가 수준 아래 일곱 번째 행정 독립체입니다. 이 유형은 하위 행정 구역을 나타냅니다. 모든 국가에 이러한 행정 구역 수준이 표시되지는 않습니다.
colloquial_area 일반적으로 사용되는 독립체의 대체 이름입니다.
locality 도시 또는 마을로 통합된 정치적 독립체입니다.
sublocality 지역 아래 첫 번째 행정 독립체입니다. 일부 위치의 경우 추가 유형 중 하나(sublocality_level_1~sublocality_level_5)를 받을 수도 있습니다. 각 하위 지역 수준은 하나의 행정 독립체입니다. 숫자가 클수록 더 작은 지역을 나타냅니다.
neighborhood 이름이 지정된 동네입니다.
premise 이름이 지정된 위치, 일반적으로 공통된 이름을 가진 건물 또는 여러 건물입니다.
subpremise 아파트, 동/호수, 사무실 등 건물 수준 아래의 주소 지정이 가능한 항목입니다.
plus_code 위도와 경도에서 파생된 인코딩된 위치 참조입니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다. 자세한 내용은 https://plus.codes를 참고하세요.
postal_code 국가 내에서 우편물을 보낼 때 사용되는 우편번호입니다.
natural_feature 유명한 자연 지형지물입니다.
airport 공항
park 이름이 지정된 공원입니다.
point_of_interest 이름이 지정된 관심 장소입니다. 일반적으로 이러한 '관심 장소'는 '엠파이어 스테이트 빌딩' 또는 '에펠탑'과 같이 다른 카테고리에 쉽게 포함되지 않는 유명한 지역 항목입니다.

빈 유형 목록은 예를 들어 프랑스의 리외디와 같이 특정한 주소 요소에 대해 알려진 유형이 없다는 것을 나타냅니다.

위의 유형 외에 아래에 나열된 유형이 주소 구성요소에 포함될 수도 있습니다.

주소 구성요소 유형 설명
floor 건물 주소의 층입니다.
establishment 일반적으로 아직 분류되지 않은 장소입니다.
landmark 탐색을 돕기 위해 참조로 사용되는 주변 장소입니다.
point_of_interest 이름이 지정된 관심 장소입니다.
parking 주차장 또는 주차 시설
post_box 특정 사서함입니다.
postal_town 일부 국가에서 우편 주소에 사용되는 locality 및 sublocality와 같은 지리적 영역의 그룹입니다.
room 건물 주소의 방입니다.
street_number 정확한 번지입니다.
bus_station, train_station, transit_station 버스, 기차 또는 대중교통 정류장의 위치입니다.