장소 찾기 (기존)

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

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

참고: 서버 측 및 클라이언트 측 라이브러리

Places API는 Google 지도 서비스용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트에서도 사용할 수 있습니다. Places API 및 클라이언트 라이브러리는 서버 애플리케이션에서 사용하기 위한 것입니다.

클라이언트 측 애플리케이션을 빌드하는 경우 Android용 Places SDK (신규), iOS용 Places SDK (신규), Maps JavaScript API의 장소 라이브러리를 참고하세요.

Find Place (기존) 요청은 텍스트 입력을 받아 장소를 반환합니다. 이름, 주소, 전화번호 등 모든 유형의 장소 텍스트 데이터를 입력할 수 있습니다. 요청은 문자열이어야 합니다. 위도/경도 좌표나 플러스 코드와 같은 비문자열 데이터를 사용하는 Find Place (Legacy) 요청은 오류를 생성합니다.

장소 검색 (레거시) 요청은 장소 세부정보 (레거시) 요청에서 반환하는 필드의 하위 집합을 반환합니다. 장소 찾기 (기존) 요청에서 사용할 수 없는 필드에 대한 자세한 내용은 Places API 필드 지원을 참고하세요. 원하는 필드가 반환되지 않는 경우 Find Place (기존)를 사용하여 place_id를 가져온 다음 이 ID를 사용하여 Place Details (기존)를 요청할 수 있습니다.

장소 찾기 (기존) 요청

장소 찾기 (레거시) 요청은 다음 형식의 HTTP URL입니다.

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

여기서 output은 다음 값 중 하나일 수 있습니다.

• json (권장)은 JavaScript 객체 표기법 (JSON)으로 출력을 나타냅니다.
• xml는 XML로 출력을 나타냅니다.

장소 찾기 (기존) 요청을 시작하려면 특정 매개변수가 필요합니다. URL에서와 마찬가지로 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다.

필수 매개변수

• 입력

  검색할 텍스트 문자열(예: '음식점' 또는 '123 Main Street'). 장소 이름, 주소 또는 시설의 카테고리여야 합니다. 다른 유형의 입력을 사용하면 오류가 발생할 수 있으며 유효한 결과가 반환되지 않을 수 있습니다. Places API는 이 문자열을 기반으로 일치 가능성이 있는 항목을 반환하고 감지된 관련성을 기반으로 검색 결과를 정렬합니다.

• inputtype

  입력 유형입니다. textquery 또는 phonenumber 중 하나일 수 있습니다. 전화번호는 국가 코드 포함 형식(앞에 더하기 기호 ('+')가 있고 그 뒤에 국가 코드, 전화번호가 나오는 형식)이어야 합니다. 자세한 내용은 E.164 ITU 권장사항을 참고하세요.

선택적 매개변수

• 필드

  주의: 장소 검색 요청과 장소 세부정보 요청은 동일한 필드를 반환하지 않습니다. 장소 검색 요청은 장소 세부정보 요청에서 반환하는 필드의 하위 집합을 반환합니다. 장소 검색에서 원하는 필드를 반환하지 않는 경우 장소 검색을 사용하여 place_id를 가져온 다음 이 장소 ID를 사용하여 장소 세부정보를 요청할 수 있습니다. 장소 검색 요청에서 사용할 수 없는 필드에 대한 자세한 내용은 Places API 필드 지원을 참고하세요.

  fields 매개변수를 사용하여 반환할 장소 데이터 유형의 쉼표로 구분된 목록을 지정합니다. 예를 들면 fields=formatted_address,name,geometry입니다. 복합 값을 지정할 때는 슬래시를 사용하세요. 예를 들면 opening_hours/open_now입니다.

  필드는 기본, 연락처, 분위기 등 세 가지 결제 카테고리로 분류됩니다. 기본 필드에는 기본 요율로 청구되며 연락처 및 분위기 필드에는 더 높은 요율로 청구됩니다. Basic, Contact, Atmosphere SKU는 이를 트리거한 요청의 기본 SKU (Place Details, Find Place, Nearby Search, Text Search) 외에 추가로 요금이 청구됩니다. 자세한 내용은 가격 시트를 참고하세요.

  기본

  기본 카테고리에는 다음 필드가 포함됩니다. address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (지원 중단됨), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  연락처

  연락처 카테고리에는 다음 필드가 포함됩니다. current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

  분위기

  분위기 카테고리에는 다음 필드가 포함됩니다. curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

  참고: 저작자 표시(html_attributions)는 필드 요청 여부에 관계없이 모든 호출에서 항상 반환됩니다.

• language

  결과를 반환할 언어입니다.

  • 지원되는 언어 목록을 참고하세요. Google에서는 지원되는 언어를 자주 업데이트하므로 이 목록에 모든 언어가 포함되지 않을 수도 있습니다.
  • language가 제공되지 않으면 API는 Accept-Language 헤더에 지정된 기본 언어를 사용하려고 시도합니다.
  • API는 사용자와 현지인 모두가 읽을 수 있는 상세 주소를 제공하기 위해 최선을 다합니다. 이 목표를 달성하기 위해 선호하는 언어를 준수하여 필요한 경우 사용자가 읽을 수 있는 스크립트로 음역된 현지 언어의 거리 주소를 반환합니다. 다른 모든 주소는 기본 언어로 반환됩니다. 주소 구성요소는 모두 첫 번째 구성요소에서 선택한 동일한 언어로 반환됩니다.
  • 선호하는 언어로 이름을 사용할 수 없는 경우 API는 가장 일치하는 이름을 사용합니다.
  • 기본 언어는 API가 반환하도록 선택한 결과 집합과 반환되는 순서에 약간의 영향을 미칩니다. 지오코더는 언어에 따라 약어를 다르게 해석합니다. 예를 들어 거리 유형의 약어나 한 언어에서는 유효하지만 다른 언어에서는 유효하지 않은 동의어가 있습니다. 예를 들어 utca와 tér은 헝가리어로 거리의 동의어입니다.

• locationbias

  반경과 위도/경도를 지정하거나 직사각형의 점을 나타내는 두 개의 위도/경도 쌍을 지정하여 지정된 지역의 결과를 우선합니다. 이 매개변수를 지정하지 않으면 API에서 기본적으로 IP 주소 바이어스를 사용합니다.

  • IP 편향: API에 IP 주소 편향을 사용하도록 지시합니다. ipbias 문자열을 전달합니다 (이 옵션에는 추가 매개변수가 없음).
  • 원형: 반지름(미터)과 위도/경도(십진수)를 지정하는 문자열입니다. circle:radius@lat,lng 형식을 사용하세요.
  • 직사각형: 직사각형의 남서쪽 및 북동쪽 지점을 나타내는 2개의 위도/경도 쌍을 십진수로 지정하는 문자열입니다. rectangle:south,west|north,east 형식을 사용합니다. 동/서 값은 -180~180 범위로 래핑되고 북/남 값은 -90~90 범위로 클램핑됩니다.

참고: 장소 찾기 (기존) 요청에서 fields 매개변수를 생략하면 결과의 place_id만 반환됩니다.

장소 찾기 (기존) 예

다음 예는 photos, formatted_address, name, rating, opening_hours, geometry 필드를 포함하는 'Museum of Contemporary Art Australia'에 대한 장소 찾기 (기존) 요청을 보여줍니다.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

다음 예는 locationbias 매개변수를 사용하여 지정된 좌표에서 2,000미터 이내의 결과를 우선하는 '몽골식 그릴'에 대한 장소 검색 (기존) 요청을 보여줍니다.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

다음 예는 전화번호에 대한 장소 찾기 (기존) 요청을 보여줍니다. 이 요청이 규정을 준수하는 URL이 되도록 국제 전화 접두사 '+'가 %2B로 인코딩되었습니다. 인코딩되지 않은 상태로 두면 + 접두사가 서버에서 공백으로 디코딩되어 잘못된 전화번호 조회가 발생합니다.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

장소 찾기 (기존) 응답

Find Place (레거시) 응답에는 fields 매개변수를 사용하여 지정된 데이터 유형과 html_attributions만 포함됩니다. 다음 예는 'Museum of Contemporary Art Australia'에 대한 장소 찾기 (기존) 요청의 응답을 보여줍니다. 이 응답에는 formatted_address, geometry, name, opening_hours, photos, rating 필드가 포함되어 있습니다.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

필드	필수	유형	설명
candidates	required	Array<Place>	장소 후보 배열이 포함되어 있습니다. 장소 검색 요청은 장소 세부정보 요청에서 반환하는 필드의 하위 집합을 반환합니다. 장소 검색에서 원하는 필드를 반환하지 않는 경우 장소 검색을 사용하여 place_id를 가져온 다음 이 장소 ID를 사용하여 장소 세부정보를 요청할 수 있습니다. 자세한 내용은 장소를 참고하세요.
status	required	PlacesSearchStatus	요청의 상태를 포함하며 요청이 실패한 이유를 추적하는 데 도움이 되는 디버깅 정보가 포함될 수도 있습니다. 자세한 내용은 PlacesSearchStatus를 참고하세요.
error_message	선택사항	문자열	서비스가 OK< 이외의 상태 코드를 반환하는 경우 응답 객체 내에 error_message 필드가 추가로 있을 수 있습니다. 이 필드에는 지정된 상태 코드의 이유에 관한 자세한 정보가 포함되어 있습니다. 이 필드는 항상 반환되지 않으며 콘텐츠가 변경될 수 있습니다.
info_messages	선택사항	Array<string>	서비스에서 요청 사양에 관한 추가 정보를 반환하는 경우 응답 객체 내에 info_messages 필드가 추가로 있을 수 있습니다. 이 필드는 성공한 요청에만 반환됩니다. 항상 반환되지 않을 수 있으며 콘텐츠는 변경될 수 있습니다.

PlacesSearchStatus

서비스에서 반환된 상태 코드입니다.

• OK - API 요청이 성공적이었음을 나타냅니다.
• ZERO_RESULTS: 검색이 성공했지만 반환된 결과가 없습니다. 검색에 원격 위치의 latlng이 전달된 경우 이러한 결과가 발생할 수도 있습니다.
• INVALID_REQUEST - API 요청이 잘못되었음을 나타냅니다. 일반적으로 필수 쿼리 매개변수 (location 또는 radius)가 누락되었기 때문입니다.
• OVER_QUERY_LIMIT: 다음 중 하나를 나타냅니다.
  • QPS 한도를 초과했습니다.
  • 계정에 결제가 사용 설정되어 있지 않습니다.
  • 월 $200 크레딧 또는 자체 설정 사용량 한도를 초과했습니다.
  • 제공된 결제 수단이 더 이상 유효하지 않습니다 (예: 신용카드가 만료됨).
  이 오류를 해결하는 방법에 대한 자세한 내용은 지도 FAQ를 참고하세요.
• REQUEST_DENIED - 요청이 거부되었음을 나타냅니다. 일반적으로 다음과 같은 이유 때문입니다.
  • 요청에 API 키가 누락되었습니다.
  • key 매개변수가 잘못되었습니다.
• UNKNOWN_ERROR - 알 수 없는 오류를 나타냅니다.

장소

장소를 설명하는 속성입니다. 일부 장소 유형에서는 일부 속성을 사용할 수 없습니다.

필드	필수	유형	설명
address_components	선택사항	Array<AddressComponent>	이 주소에 적용할 수 있는 별도의 구성요소가 포함된 배열입니다. 자세한 내용은 AddressComponent를 참고하세요.
adr_address	선택사항	문자열	adr 마이크로포맷의 장소 주소를 나타냅니다.
business_status	선택사항	문자열	장소가 비즈니스인 경우 장소의 영업 상태를 나타냅니다. 데이터가 없으면 business_status가 반환되지 않습니다. The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
curbside_pickup	선택사항	부울	비즈니스에서 차량 수령을 지원하는지 여부를 지정합니다.
current_opening_hours	선택사항	PlaceOpeningHours	다음 7일간 (오늘 포함)의 영업시간을 포함합니다. 기간은 요청일의 자정에 시작하여 6일 후 오후 11시 59분에 종료됩니다. 이 필드에는 예외적인 시간이 있는 날짜에 설정된 모든 시간의 special_days 하위 필드가 포함됩니다. 자세한 내용은 PlaceOpeningHours를 참고하세요.
delivery	선택사항	부울	비즈니스에서 배송을 지원하는지 여부를 지정합니다.
dine_in	선택사항	부울	비즈니스에서 실내 또는 실외 좌석 옵션을 지원하는지 여부를 지정합니다.
editorial_summary	선택사항	PlaceEditorialSummary	장소의 요약이 포함됩니다. 요약은 텍스트 개요로 구성되며, 해당하는 경우 이러한 언어의 언어 코드도 포함됩니다. 요약 텍스트는 있는 그대로 표시해야 하며 수정하거나 변경할 수 없습니다. 자세한 내용은 PlaceEditorialSummary를 참고하세요.
formatted_address	선택사항	문자열	이 장소의 사람이 읽을 수 있는 주소가 포함된 문자열입니다. 이 주소는 대개 우편 주소와 일치합니다. 참고: 영국과 같은 일부 국가에서는 라이선스 제한으로 인해 실제 우편 주소의 배포가 허용되지 않습니다. 형식이 지정된 주소는 하나 이상의 주소 구성요소로 논리적으로 구성됩니다. 예를 들어 주소 '111 8th Avenue, New York, NY'는 '111' (번지), '8th Avenue' (경로), 'New York' (도시) 및 'NY' (미국의 주)로 구성됩니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요. 대신 API 응답에 형식이 지정된 주소 필드 외에 포함되는 개별 주소 구성요소를 사용해야 합니다.
formatted_phone_number	선택사항	문자열	장소의 전화번호가 현지 형식으로 포함됩니다.
geometry	선택사항	Geometry	위치의 위치와 표시 영역을 포함합니다. 자세한 내용은 Geometry를 참고하세요.
icon	선택사항	문자열	지도에 이 결과를 표시할 때 사용자에게 표시될 수 있는 추천 아이콘의 URL을 포함합니다.
icon_background_color	선택사항	문자열	장소 카테고리의 기본 16진수 색상 코드를 포함합니다.
icon_mask_base_uri	선택사항	문자열	권장 아이콘의 URL에서 .svg 또는 .png 파일 형식 확장자를 뺀 값을 포함합니다.
international_phone_number	선택사항	문자열	장소의 전화번호가 국가 코드 포함 형식으로 포함됩니다. 국가 코드 포함 형식에는 국가 코드가 포함되며 앞에 더하기(+) 기호가 붙습니다. 예를 들어 Google 오스트레일리아 시드니 사무실의 international_phone_number는 [phone]입니다.
name	선택사항	문자열	반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. establishment 결과의 경우 일반적으로 표준화된 업체 이름입니다.
opening_hours	선택사항	PlaceOpeningHours	정규 영업시간을 포함합니다. 자세한 내용은 PlaceOpeningHours를 참고하세요.
permanently_closed	선택사항	부울	permanently_closed이(가) 지원 중단되었습니다. business_status을 사용하여 비즈니스의 영업 상태를 가져옵니다.
photos	선택사항	Array<PlacePhoto>	사진 객체의 배열이며, 각 객체에는 이미지에 대한 참조가 포함됩니다. 요청은 최대 10장의 사진을 반환할 수 있습니다. 장소 사진 및 애플리케이션에서 이미지를 사용하는 방법에 관한 자세한 내용은 장소 사진 문서를 참고하세요. 자세한 내용은 PlacePhoto를 참고하세요.
place_id	선택사항	문자열	장소를 고유하게 식별하는 텍스트 식별자. 장소에 관한 정보를 가져오려면 Places API 요청의 place_id 필드에 이 식별자를 전달하세요. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참고하세요.
plus_code	선택사항	PlusCode	위도와 경도 좌표에서 파생된 인코딩된 위치 참조로 1/8000도x1/8000도 (적도에서 14mx14m) 이하의 영역을 나타냅니다. Plus Code는 상세 주소가 없는 (건물에 번호가 지정되지 않거나 거리 이름이 없는) 장소의 상세 주소 대신 사용할 수 있습니다. Open Location Code 및 플러스 코드를 참고하세요. 자세한 내용은 PlusCode를 참고하세요.
price_level	선택사항	숫자	장소의 가격 수준입니다(0~4). 특정 값으로 표시된 정확한 금액은 지역마다 다릅니다. 가격 수준은 다음과 같이 해석됩니다. 0 무료 1 저렴함 2 보통 3 비쌈 4 매우 비쌈
rating	선택사항	숫자	집계된 사용자 리뷰를 기준으로 한 장소 평점(1.0~5.0)이 포함됩니다.
reference	선택사항	문자열	reference이 지원 중단되었습니다.
reservable	선택사항	부울	장소에서 예약을 지원하는지 여부를 지정합니다.
reviews	선택사항	Array<PlaceReview>	최대 5개의 리뷰로 구성된 JSON 배열입니다. 기본적으로 리뷰는 관련성 순으로 정렬됩니다. reviews_sort 요청 매개변수를 사용하여 정렬을 제어합니다. most_relevant (기본값)의 경우 리뷰가 관련성을 기준으로 정렬됩니다. 서비스는 기본 언어로 원래 작성된 리뷰를 반환하도록 결과를 편향시킵니다. newest의 경우 리뷰가 시간순으로 정렬됩니다. 선호하는 언어는 정렬 순서에 영향을 주지 않습니다. Google에서는 결과가 most_relevant 또는 newest에 따라 정렬되는지 사용자에게 표시할 것을 권장합니다. 자세한 내용은 PlaceReview를 참고하세요.
scope	선택사항	문자열	scope이 지원 중단되었습니다.
secondary_opening_hours	선택사항	Array<PlaceOpeningHours>	비즈니스의 보조 영업시간에 관한 정보를 비롯해 다음 7일 동안의 항목 배열을 포함합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 영업시간이나 배달 시간을 보조 영업시간으로 지정할 수 있습니다. 이 필드는 장소 유형에 따라 미리 정의된 영업시간 유형 목록 (예: DRIVE_THROUGH, PICKUP 또는 TAKEOUT)에서 가져온 type 하위 필드를 채웁니다. 이 필드에는 예외적인 시간이 있는 날짜에 설정된 모든 시간의 special_days 하위 필드가 포함됩니다. 자세한 내용은 PlaceOpeningHours를 참고하세요.
serves_beer	선택사항	부울	장소에서 맥주를 판매하는지 여부를 지정합니다.
serves_breakfast	선택사항	부울	장소에서 아침 식사를 제공하는지 여부를 지정합니다.
serves_brunch	선택사항	부울	장소에서 브런치를 제공하는지 여부를 지정합니다.
serves_dinner	선택사항	부울	장소에서 저녁 식사를 제공하는지 여부를 지정합니다.
serves_lunch	선택사항	부울	장소에서 점심을 제공하는지 여부를 지정합니다.
serves_vegetarian_food	선택사항	부울	장소에서 채식 요리를 제공하는지 여부를 지정합니다.
serves_wine	선택사항	부울	장소에서 와인을 판매하는지 여부를 지정합니다.
takeout	선택사항	부울	비즈니스에서 테이크아웃을 지원하는지 여부를 지정합니다.
types	선택사항	Array<string>	주어진 결과를 설명하는 기능 유형의 배열을 포함합니다. 지원되는 유형의 목록을 참고하세요.
url	선택사항	문자열	이 장소의 공식 Google 페이지 URL이 포함됩니다. 장소에 대한 최상의 정보가 포함된 Google 소유 페이지입니다. 애플리케이션에서는 장소에 대한 자세한 결과를 사용자에게 표시하는 모든 화면에 이 페이지를 연결하거나 포함해야 합니다.
user_ratings_total	선택사항	숫자	이 장소에 대한 총 리뷰 수(텍스트 유무와 관계없음)입니다.
utc_offset	선택사항	숫자	이 장소의 현재 시간대가 UTC에서 오프셋된 분 수를 포함합니다. 예를 들어 오스트레일리아 시드니의 경우 일광 절약 시간 동안 660 (UTC에서 +11시간)이고, 캘리포니아의 경우 일광 절약 시간 외에는 -480(UTC에서 -8시간)입니다.
vicinity	선택사항	문자열	시설 (types:["establishment", ...]) 결과만 해당)의 경우 vicinity 필드에는 도로명, 번지, 지역은 포함하되 주/도, 우편번호, 국가는 포함되지 않은 장소의 단순화된 주소가 포함됩니다. 다른 모든 결과의 경우 vicinity 필드에 결과의 주소에 있는 가장 좁은 정치적 (types:["political", ...]) 기능의 이름이 포함됩니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요.
website	선택사항	문자열	비즈니스 홈페이지와 같이 이 장소의 신뢰할 수 있는 웹사이트입니다.
wheelchair_accessible_entrance	선택사항	부울	장소에 휠체어 진입로가 있는지 여부를 지정합니다.

PlaceEditorialSummary

장소의 요약이 포함됩니다. 요약은 텍스트 개요로 구성되며, 해당하는 경우 이러한 언어의 언어 코드도 포함됩니다. 요약 텍스트는 있는 그대로 표시해야 하며 수정하거나 변경할 수 없습니다.

필드	필수	유형	설명
language	선택사항	문자열	이전 필드의 언어입니다. 항상 표시되지 않을 수 있습니다.
overview	선택사항	문자열	장소에 대한 중간 길이의 텍스트 요약입니다.

PlaceOpeningHours

장소의 영업시간을 설명하는 객체입니다.

필드	필수	유형	설명
open_now	선택사항	부울	장소가 현재 영업 중인지 여부를 나타내는 불리언 값입니다.
periods	선택사항	Array<PlaceOpeningHoursPeriod>	일요일부터 7일 동안의 영업 기간을 시간순으로 나타내는 배열입니다. 자세한 내용은 PlaceOpeningHoursPeriod를 참고하세요.
special_days	선택사항	Array<PlaceSpecialDay>	다음 7일에 해당하는 최대 7개의 항목 배열입니다. 자세한 내용은 PlaceSpecialDay를 참고하세요.
type	선택사항	문자열	보조 시간의 유형을 식별하는 데 사용되는 유형 문자열입니다 (예: DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS). secondary_opening_hours에만 설정됩니다.
weekday_text	선택사항	Array<string>	사람이 읽을 수 있는 텍스트로 장소의 영업시간을 설명하는 문자열 배열입니다.

PlaceOpeningHoursPeriod

필드	필수	유형	설명
open	required	PlaceOpeningHoursPeriodDetail	장소의 개점 시간을 나타내는 요일 및 시간 객체 쌍이 포함됩니다. 자세한 내용은 PlaceOpeningHoursPeriodDetail을 참고하세요.
close	선택사항	PlaceOpeningHoursPeriodDetail	장소의 폐점 시간을 나타내는 요일 및 시간 객체 쌍이 포함될 수 있습니다. 장소가 항상 열려 있는 경우 응답에서 close 섹션이 누락됩니다. 클라이언트는 항상 열려 있음을 값이 0인 요일과 값이 0000인 시간을 포함한 열린 기간으로 표시할 수 있으며 close는 없습니다. 자세한 내용은 PlaceOpeningHoursPeriodDetail을 참고하세요.

PlaceSpecialDay

필드	필수	유형	설명
date	선택사항	문자열	장소의 현지 시간대로 RFC3339 형식으로 표현된 날짜입니다(예: 2010-12-31).
exceptional_hours	선택사항	부울	이 날에 예외적인 시간이 있는 경우 True입니다. true인 경우 이 날짜에 하나 이상의 예외가 있음을 의미합니다. 예외로 인해 current_opening_hours 및 secondary_opening_hours의 하위 필드(예: periods, weekday_text, open_now)에 다른 값이 발생합니다. 예외는 시간에 적용되며 시간은 다른 필드를 생성하는 데 사용됩니다.

PlaceOpeningHoursPeriodDetail

필드	필수	유형	설명
day	required	숫자	요일에 해당하는 0~6 사이의 숫자이며 일요일부터 시작됩니다. 예를 들어, 2는 화요일을 의미합니다.
time	required	문자열	하루 중 시간이 24시간 hhmm 형식으로 포함될 수 있습니다. 값은 0000~2359 범위에 있습니다. 시간은 장소의 시간대로 보고됩니다.
date	선택사항	문자열	장소의 현지 시간대로 RFC3339 형식으로 표현된 날짜입니다(예: 2010-12-31).
truncated	선택사항	부울	요청 날짜의 자정 전에 기간이 시작되거나 마지막 날의 자정 또는 그 후에 기간이 종료되는 경우 7일 컷오프로 인해 지정된 기간이 잘렸다면 true입니다. 이 속성은 개장 또는 폐장 기간이 이 7일 기한을 넘어 연장될 수 있음을 나타냅니다.

PlacePhoto

장소 사진입니다. 다음 패턴의 URL을 사용하여 장소 사진 API를 사용하여 사진에 액세스할 수 있습니다.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

자세한 내용은 장소 사진을 참고하세요.

필드	필수	유형	설명
height	required	숫자	사진의 높이입니다.
html_attributions	required	Array<string>	사진의 HTML 저작자 표시입니다.
photo_reference	required	문자열	사진 요청을 실행할 때 사진을 식별하는 데 사용되는 문자열입니다.
width	required	숫자	사진의 너비입니다.

PlaceReview

사용자가 제출한 장소 리뷰입니다.

필드	필수	유형	설명
author_name	required	문자열	리뷰를 제출한 사용자의 이름입니다. 익명의 리뷰는 'A Google user'로 저작자가 표시됩니다.
rating	required	숫자	이 장소에 대한 사용자의 전반적인 평점입니다. 1~5 사이의 정수입니다.
relative_time_description	required	문자열	현재 시간을 기준으로 리뷰가 제출된 시간을 텍스트로 나타냅니다.
time	required	숫자	리뷰가 제출된 시간입니다. 1970년 1월 1일 자정(UTC) 이후 경과된 시간을 초 단위로 측정합니다.
author_url	선택사항	문자열	사용자의 Google 지도 지역 가이드 프로필 URL입니다(해당하는 경우).
language	선택사항	문자열	반환된 리뷰의 언어를 나타내는 IETF 언어 코드입니다.이 필드에는 기본 언어 태그만 포함되며, 국가나 지역을 표시하는 보조 태그는 포함되지 않습니다. 예를 들어 모든 영어 리뷰는 'en'으로만 태그가 지정되며 'en-AU'나 'en-UK' 등으로 태그가 지정되지 않습니다.리뷰 텍스트가 없는 평점만 있는 경우 이 필드는 비어 있습니다.
original_language	선택사항	문자열	리뷰의 원래 언어를 나타내는 IETF 언어 코드입니다. 리뷰가 번역된 경우 original_language != language입니다.이 필드에는 기본 언어 태그만 포함되며, 국가나 지역을 표시하는 보조 태그는 포함되지 않습니다. 예를 들어 모든 영어 리뷰는 'en'으로만 태그가 지정되며 'en-AU'나 'en-UK' 등으로 태그가 지정되지 않습니다.리뷰 텍스트가 없는 평점만 있는 경우 이 필드는 비어 있습니다.
profile_photo_url	선택사항	문자열	사용자의 프로필 사진 URL입니다(사용 가능한 경우).
text	선택사항	문자열	사용자의 리뷰입니다. Google Places에서 위치를 리뷰할 때 텍스트 리뷰는 선택사항으로 간주됩니다. 따라서 이 필드는 비어 있을 수 있습니다. 이 필드에는 기본 HTML 마크업이 포함될 수 있습니다. 예를 들어 항목 참조 &는 앰퍼샌드 문자를 나타낼 수 있습니다.
translated	선택사항	부울	리뷰가 작성된 원래 언어에서 번역되었는지 여부를 나타내는 불리언 값입니다.리뷰가 번역된 경우(true 값에 해당) Google에서는 사용자에게 이를 표시할 것을 권장합니다. 예를 들어 리뷰에 'Google에서 번역함'이라는 문자열을 추가할 수 있습니다.