장소 유형 (신규)

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

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

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

표 A

자동차
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
winery *
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
yakitori_restaurant *
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

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

대답의 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 버스, 기차 또는 대중교통 정류장의 위치입니다.