장소 유형 (신규)

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

유럽 경제 지역(EEA) 개발자

청구서 수신 주소가 유럽 경제 지역에 있는 경우 2025년 7월 8일부터 Google Maps Platform EEA 서비스 약관이 서비스 이용에 적용됩니다. 기능은 리전에 따라 다릅니다. 자세히 알아보기

소개

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

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

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

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

유형 테이블 정보

표 A에는 다음과 같은 방식으로 사용되는 유형이 나열되어 있습니다.

• 장소 세부정보(신규), 주변 지역 검색(신규), 텍스트 검색(신규) 응답의 일부로. 요청은 필드 마스크에 places.types 또는 places.primaryType 필드 중 하나 이상을 지정해야 합니다. 그런 다음 표 A의 값이 이러한 필드를 채우는 데 사용됩니다.
• 주변 지역 검색(신규) 요청의 일부로, includedTypes, excludedTypes, includedPrimaryTypes, excludedPrimaryTypes 매개변수의 값으로 사용됩니다. 그런 다음 표 B의 값이 이러한 필드를 채우는 데 사용됩니다.
• 텍스트 검색(신규) 요청의 일부로, includedType 매개변수의 값으로 사용됩니다.
• Autocomplete(신규) 요청의 일부로, includedPrimaryTypes 매개변수의 값으로 사용됩니다.
• Autocomplete(신규) 응답의 일부로 사용됩니다.

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

표 C에는 Autocomplete(신규) 요청에서 includedPrimaryTypes 매개변수의 값으로 사용할 수 있는 유형 컬렉션이 나열되어 있습니다. 유형 컬렉션은 다른 유형 값으로 지정할 수 없습니다.

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

테이블 A

참고: 별표(*)가 있는 유형은 2026년 2월 12일 출시의 일부로 추가되었습니다.

Automotive 비즈니스 문화 교육 엔터테인먼트 및여가 시설 금융 식음료 지역 정부 기관

건강 및 웰니스 주거 숙박시설 자연 지형지물 예배 장소 서비스 쇼핑 스포츠 교통

자동차
car_dealer car_rental car_repair car_wash ebike_charging_station * electric_vehicle_charging_station gas_station	parking parking_garage * parking_lot * rest_stop tire_shop * truck_dealer *
비즈니스
business_center * corporate_office coworking_space * farm manufacturer * ranch supplier * television_studio *
문화
art_gallery art_museum * art_studio auditorium castle * cultural_landmark fountain * historical_place history_museum *	monument museum performing_arts_theater sculpture
교육
academic_department * educational_institution * library preschool primary_school	research_institute * school secondary_school university
엔터테인먼트 및여가
adventure_sports_center amphitheatre amusement_center amusement_park aquarium banquet_hall barbecue_area botanical_garden bowling_alley casino childrens_camp city_park * comedy_club community_center concert_hall convention_center cultural_center cycling_park dance_hall dog_park event_venue ferris_wheel garden go_karting_venue *	hiking_area historical_landmark indoor_playground * internet_cafe karaoke live_music_venue * marina miniature_golf_course * movie_rental movie_theater national_park night_club observation_deck off_roading_area opera_house paintball_center * park philharmonic_hall picnic_ground planetarium plaza roller_coaster skateboard_park state_park	tourist_attraction video_arcade vineyard * 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 argentinian_restaurant * asian_fusion_restaurant * asian_restaurant australian_restaurant * austrian_restaurant * bagel_shop bakery bangladeshi_restaurant * bar bar_and_grill barbecue_restaurant basque_restaurant * bavarian_restaurant * beer_garden * belgian_restaurant * bistro * brazilian_restaurant breakfast_restaurant brewery * brewpub * british_restaurant * brunch_restaurant buffet_restaurant burmese_restaurant * burrito_restaurant * cafe cafeteria cajun_restaurant * cake_shop * californian_restaurant * cambodian_restaurant * candy_store cantonese_restaurant * caribbean_restaurant * cat_cafe chicken_restaurant * chicken_wings_restaurant * chilean_restaurant * chinese_noodle_restaurant * chinese_restaurant chocolate_factory chocolate_shop cocktail_bar * coffee_roastery * coffee_shop coffee_stand * colombian_restaurant * confectionery croatian_restaurant * cuban_restaurant * czech_restaurant * danish_restaurant * deli	dessert_restaurant dessert_shop dim_sum_restaurant * diner dog_cafe donut_shop dumpling_restaurant * dutch_restaurant * eastern_european_restaurant * ethiopian_restaurant * european_restaurant * falafel_restaurant * family_restaurant * fast_food_restaurant filipino_restaurant * fine_dining_restaurant fish_and_chips_restaurant * fondue_restaurant * food_court french_restaurant fusion_restaurant * gastropub * german_restaurant * greek_restaurant gyro_restaurant * halal_restaurant* hamburger_restaurant hawaiian_restaurant * hookah_bar * hot_dog_restaurant * hot_dog_stand * hot_pot_restaurant * hungarian_restaurant * ice_cream_shop indian_restaurant indonesian_restaurant irish_pub * irish_restaurant * israeli_restaurant * italian_restaurant japanese_curry_restaurant * japanese_izakaya_restaurant * japanese_restaurant juice_shop kebab_shop * korean_barbecue_restaurant * korean_restaurant latin_american_restaurant * lebanese_restaurant lounge_bar * malaysian_restaurant * meal_delivery meal_takeaway mediterranean_restaurant mexican_restaurant middle_eastern_restaurant mongolian_barbecue_restaurant *	moroccan_restaurant * noodle_shop * north_indian_restaurant * oyster_bar_restaurant * pakistani_restaurant * pastry_shop * persian_restaurant * peruvian_restaurant * pizza_delivery * pizza_restaurant polish_restaurant * portuguese_restaurant * pub ramen_restaurant restaurant romanian_restaurant * russian_restaurant * salad_shop * sandwich_shop scandinavian_restaurant * seafood_restaurant shawarma_restaurant * snack_bar * soul_food_restaurant * soup_restaurant * south_american_restaurant * south_indian_restaurant * southwestern_us_restaurant * spanish_restaurant sports_bar * sri_lankan_restaurant * steak_house sushi_restaurant swiss_restaurant * taco_restaurant * taiwanese_restaurant * tapas_restaurant * tea_house tex_mex_restaurant * thai_restaurant tibetan_restaurant * tonkatsu_restaurant * turkish_restaurant ukrainian_restaurant * vegan_restaurant vegetarian_restaurant vietnamese_restaurant western_restaurant * wine_bar winery * yakiniku_restaurant * yakitori_restaurant *
지역
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 general_hospital * hospital massage massage_spa * medical_center * medical_clinic * 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 island * lake * mountain_peak * nature_preserve * river * scenic_spot * woods *
예배 장소
buddhist_temple * church hindu_temple mosque shinto_shrine * synagogue
서비스
aircraft_rental_service * association_or_organization * astrologer barber_shop beautician beauty_salon body_art_service catering_service cemetery chauffeur_service * child_care_agency consultant courier_service electrician employment_agency * florist food_delivery foot_care funeral_home hair_care hair_salon insurance_agency laundry lawyer locksmith	makeup_artist marketing_consultant * moving_company nail_salon non_profit_organization * painter pet_boarding_service * pet_care * plumber psychic real_estate_agency roofing_contractor service * shipping_service * 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 building_materials_store * butcher_shop cell_phone_store clothing_store convenience_store cosmetics_store * department_store discount_store discount_supermarket * electronics_store farmers_market * flea_market * food_store furniture_store garden_center * general_store * gift_shop grocery_store hardware_store health_food_store * home_goods_store	home_improvement_store hypermarket * jewelry_store liquor_store market pet_store shoe_store shopping_mall sporting_goods_store sportswear_store * store supermarket tea_store * thrift_store * toy_store * warehouse_store wholesaler womens_clothing_store *
스포츠
arena athletic_field fishing_charter fishing_pier * fishing_pond fitness_center golf_course gym ice_skating_rink indoor_golf_course *	playground race_course * ski_resort sports_activity_location sports_club sports_coaching sports_complex sports_school * stadium swimming_pool * tennis_court *
교통
airport airstrip bike_sharing_station * bridge * bus_station bus_stop ferry_service * ferry_terminal heliport international_airport light_rail_station park_and_ride	subway_station taxi_service * taxi_stand toll_station * train_station train_ticket_office * tram_stop * transit_depot transit_station transit_stop * transportation_service * truck_stop

표 B

표 B의 장소 유형 값은 장소 세부정보(신규), 주변 지역 검색(신규), 텍스트 검색(신규) 또는 자동 완성(신규) 응답의 일부로 반환될 수 있습니다. 이러한 유형은 Autocomplete(New) 요청에 대해 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

테이블 C

유형 모음은 Autocomplete(신규) 요청에서 includedPrimaryTypes 값으로 사용할 수 있습니다. 유형 컬렉션을 사용하면 연결된 포함된 유형과 일치하는 모든 결과가 반환됩니다. 유형 컬렉션은 다른 유형 값으로 지정할 수 없습니다.

참고: 더 나은 결과를 얻으려면 사용자가 표 A 및 표 B에서 특정 유형을 선택해야 합니다.

서체 컬렉션	포함된 유형
(regions)	주변 지역 및 우편번호와 같은 지역 또는 구역을 필터링합니다.
(cities)	Google에서 도시로 식별하는 장소를 필터링합니다.

주소 유형 및 주소 구성요소 유형

응답의 types 배열은 주소 유형을 나타냅니다. 주소 유형의 예로는 상세 주소, 국가, 정치적 독립체가 있습니다. 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	버스, 기차 또는 대중교통 정류장의 위치입니다.