이 제품은 기존 상태입니다. 2026년 10월부터는 새 Google Cloud 프로젝트에 Places API (기존)를 더 이상 사용 설정할 수 없습니다. 기존 프로젝트는 계속해서 완전히 지원됩니다. 새로운 기능과 향상된 성능을 위해 Places API (신규)로 이전하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

텍스트 검색 (기존)

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

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

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

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

텍스트 검색(기존)은 문자열(예: '뉴욕의 피자', '오타와 근처의 신발 가게' 또는 '중앙로 123')을 기반으로 일련의 장소에 대한 정보를 반환합니다. 이 서비스는 사전에 설정된 텍스트 문자열 및 특정 위치와 일치하는 장소의 목록을 반환합니다.

텍스트 검색 (기존)은 다음을 포함하여 모호한 쿼리에 사용하기 위한 것이 아닙니다.

쿼리 유형	예
단일 쿼리에 여러 장소, 도로 또는 도시의 이름과 같은 너무 많은 개념 또는 제약 조건이 포함되어 있습니다.	'Market Street San Francisco San Jose Airport'
Google 지도에 표시되지 않는 우편 주소 요소	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
비즈니스, 체인 또는 카테고리의 이름이 해당 법인이 존재하지 않는 위치와 결합된 경우	"Tesco near Dallas, Texas"
여러 해석이 가능한 모호한 검색어	'충전기 반납'
더 이상 사용되지 않는 이전 이름	'Middlesex United Kingdom'
지리 공간적 요소 또는 의도가 아님	"벤투라 항구에 보트가 몇 대 있어?"
비공식 이름 또는 가상 이름	'젠가' '헬터 스켈터'
위도 및 경도 좌표	"37.422131,-122.084801"

검색 응답에는 장소의 목록이 포함됩니다. 응답에 포함된 장소에 대한 자세한 내용을 확인하려면 장소 세부정보 요청을 전송하세요.

텍스트 검색 (기존) 요청

텍스트 검색 (기존) 요청은 다음과 같은 형식의 HTTP URL입니다.

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

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

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

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

필수 매개변수

query

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

장소 결과를 반환할 거리 (미터)를 정의합니다. location 및 radius 매개변수를 전달하여 특정 원에 편중된 결과를 얻을 수 있습니다. 이렇게 하면 장소 서비스에서 해당 원 내의 결과를 우선적으로 표시합니다. 정의된 영역 밖의 결과가 표시될 수도 있습니다.

반경은 검색 유형 및 기타 매개변수에 따라 자동으로 최댓값으로 고정됩니다.
- 자동 완성: 50,000미터
- 주변 지역 검색:
  - keyword 또는 name: 50,000미터
  - keyword 또는 name 없이
    - rankby 매개변수와 관계없이 지역 밀도에 따라 동적으로 조정되는 최대 50,000미터입니다.
    - rankby=distance를 사용하는 경우 radius 매개변수가 허용되지 않으며 INVALID_REQUEST가 발생합니다.
- Query Autocomplete: 50,000미터
- 텍스트 검색: 50,000미터

선택적 매개변수

language

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

장소 정보를 검색할 지점입니다. latitude,longitude로 지정해야 합니다.

query에 Market in Barcelona과 같은 명시적 위치가 포함된 경우 location 매개변수가 재정의될 수 있습니다. 검색어에 따옴표를 사용하면 location 및 radius에 부여되는 가중치에도 영향을 줄 수 있습니다.
maxprice

지정된 범위 내의 장소로만 결과를 제한합니다. 유효한 값의 범위는 0 (가장 저렴함)~4 (가장 비쌈)입니다. 특정 값으로 표시되는 정확한 금액은 지역마다 다릅니다.
minprice

지정된 범위 내의 장소로만 결과를 제한합니다. 유효한 값의 범위는 0 (가장 저렴함)~4 (가장 비쌈)입니다. 특정 값으로 표시되는 정확한 금액은 지역마다 다릅니다.
opennow

쿼리가 전송된 시점에 영업 중인 장소만 반환합니다. 이 매개변수를 쿼리에 포함하면 Google 지역 정보 데이터베이스에 영업시간을 지정하지 않은 장소는 반환되지 않습니다.
pagetoken

이전에 실행한 검색에서 최대 20개의 결과를 반환합니다. pagetoken 매개변수를 설정하면 이전에 사용된 것과 동일한 매개변수로 검색이 실행됩니다. pagetoken 이외의 모든 매개변수는 무시됩니다.
지역

ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하지만 일부 주목할 만한 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb'입니다(엄밀히 말하면 '영국 및 북아일랜드' 항목).
유형

지정된 유형과 일치하는 장소로 결과를 제한합니다. 한 가지 유형만 지정할 수 있습니다. 두 개 이상의 유형을 제공하면 첫 번째 항목 이후의 모든 유형은 무시됩니다.
- type=hospital|pharmacy|doctor가 type=hospital로 됨
- type=hospital,pharmacy,doctor는 완전히 무시됩니다.
지원되는 유형의 목록을 참고하세요.

참고: 동일한 값(keyword=cafe&type=cafe 또는 keyword=parking&type=parking)으로 keyword 및 type를 모두 추가하면 ZERO_RESULTS가 발생할 수 있습니다.

텍스트 검색 (기존) 예시

참고: 이 예시에서는 애플리케이션에서 요청이 작동하도록 key를 자체 API 키로 바꿔야 합니다.

기본 예시

다음 예는 시드니 근처의 음식점을 검색하는 방법을 보여줍니다.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

불완전한 주소 예시

다음 예는 불완전한 주소(이 경우 도시, 주 또는 국가가 포함되지 않은 상세 주소)를 검색하는 것을 보여줍니다.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=123%20main%20street
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

위치 편향 예시

다음 예는 이전 예와 동일한 불완전한 주소를 검색하고 location 및 radius 매개변수를 포함하여 결과를 관심 지역으로 편향시킵니다.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?location=42.3675294%2C-71.186966
  &query=123%20main%20street
  &radius=10000
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

텍스트 검색 (기존) 응답

검색 응답은 URL 요청 경로 내의 output 플래그로 표시된 형식으로 반환됩니다.

다음 예는 텍스트 검색 (기존) 응답을 보여줍니다.

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

필드	필수	유형	설명
`html_attributions`	required	Array<string>	사용자에게 표시해야 하는 이 등록정보에 관한 저작자 표시 집합이 포함될 수 있습니다 (일부 등록정보에는 저작자 표시가 없을 수 있음).
`results`	required	Array<Place>	장소 배열이 포함됩니다. 장소 검색 요청은 장소 세부정보 요청에서 반환하는 필드의 하위 집합을 반환합니다. 장소 검색에서 원하는 필드를 반환하지 않는 경우 장소 검색을 사용하여 `place_id`를 가져온 다음 이 장소 ID를 사용하여 장소 세부정보를 요청할 수 있습니다. 자세한 내용은 장소를 참고하세요.
`status`	required	PlacesSearchStatus	요청의 상태가 포함되며 요청이 실패한 이유를 추적하는 데 도움이 되는 디버깅 정보가 포함될 수도 있습니다. 자세한 내용은 PlacesSearchStatus를 참고하세요.
`error_message`	선택사항	문자열	서비스가 `OK<` 이외의 상태 코드를 반환하는 경우 응답 객체 내에 추가 `error_message` 필드가 있을 수 있습니다. 이 필드에는 지정된 상태 코드의 이유에 관한 자세한 정보가 포함됩니다. 이 필드는 항상 반환되지 않으며 콘텐츠는 변경될 수 있습니다.
`info_messages`	선택사항	Array<string>	서비스가 요청 사양에 대한 추가 정보를 반환하면 응답 객체 내에 추가 `info_messages` 필드가 있을 수 있습니다. 이 필드는 성공적인 요청에 대해서만 반환됩니다. 항상 반환되는 것은 아니며 콘텐츠는 변경될 수 있습니다.
`next_page_token`	선택사항	문자열	최대 20개의 추가 결과를 반환하는 데 사용할 수 있는 토큰을 포함합니다. 표시할 추가 결과가 없으면 next_page_token이 반환되지 않습니다. 반환할 수 있는 최대 결과 수는 60개입니다. next_page_token이 발급되는 시점과 유효해지는 시점 사이에 약간의 지연이 있습니다.

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, formatted_phone_number, reviews, website)를 가져오려면 반환된 place_id를 장소 세부정보(기존) 요청에 전달합니다. 엔드포인트 전반의 필드 가용성 및 가격 책정 등급은 장소 데이터 필드 (기존)를 참고하세요.

필드	유형	설명
`business_status`	`string`	장소가 비즈니스인 경우 장소의 영업 상태를 나타냅니다(`OPERATIONAL`, `CLOSED_TEMPORARILY` 또는 `CLOSED_PERMANENTLY`). 상태 데이터가 없으면 생략됩니다.
`formatted_address`	`string`	이 장소의 인간이 읽을 수 있는 주소입니다. 텍스트 검색 (기존) 및 장소 찾기 (기존)에서 반환됩니다. 형식이 지정된 주소를 프로그래매틱 방식으로 파싱하지 마세요. 대신 장소 세부정보 (기존)에서 `address_components`를 요청하세요.
`geometry`	`Geometry`	`lat` 및 `lng` 좌표가 있는 지오코딩된 `location`와 `northeast` 및 `southwest` 경계가 있는 기본 `viewport`가 포함됩니다.
`icon`	`string`	지도에 이 결과를 표시할 때 표시할 수 있는 추천 아이콘의 URL입니다.
`icon_background_color`	`string`	장소 카테고리의 기본 16진수 색상 코드입니다.
`icon_mask_base_uri`	`string`	추천 아이콘의 기준 URL입니다(SVG 또는 PNG 파일 형식 확장자 제외).
`name`	`string`	반환된 결과의 인간이 읽을 수 있는 이름입니다. `establishment` 결과의 경우 이 값은 일반적으로 표준화된 비즈니스 이름입니다.
`opening_hours`	`PlaceOpeningHours`	영업시간 정보 장소 검색 엔드포인트는 `open_now` 불리언 하위 필드만 반환합니다. `periods` 및 `weekday_text`의 경우 장소 세부정보 (기존)에서 `opening_hours`를 요청하세요.
`permanently_closed`	`boolean`	지원 중단됨: `business_status`를 사용하여 비즈니스의 영업 상태를 확인하세요.
`photos`	`Array<PlacePhoto>`	`PlacePhoto` 객체의 배열로, 각 객체에는 `photo_reference`, `height`, `width`, `html_attributions`가 포함됩니다. 사용에 관한 자세한 내용은 장소 사진 (기존)을 참고하세요.
`place_id`	`string`	장소를 고유하게 식별하는 텍스트 식별자. 장소 세부정보 (기존) 요청의 `place_id` 매개변수에 이 ID를 전달합니다. 장소 ID 개요를 참고하세요.
`plus_code`	`PlusCode`	위도 및 경도 좌표에서 파생된 인코딩된 위치 참조로, `global_code` 및 선택적 `compound_code`를 포함합니다.
`price_level`	`integer`	`0`에서 `4`까지의 장소 가격 수준으로, 가장 저렴한 가격부터 가장 비싼 가격까지입니다. `price_level`를 참고하세요.
`rating`	`number`	집계된 사용자 리뷰를 기준으로 한 장소 평점(`1.0`~`5.0`)
`reference`	`string`	지원 중단됨: 대신 `place_id`를 사용하세요.
`scope`	`string`	지원 중단됨: `place_id`의 범위를 나타내며 항상 `GOOGLE`입니다. 주변 검색 (기존)에서 반환됩니다.
`types`	`Array<string>`	지정된 결과를 설명하는 지형지물 유형의 배열입니다. 장소 유형 (기존)을 참고하세요.
`user_ratings_total`	`integer`	이 장소에 대한 총 평점 수입니다(리뷰 텍스트 유무와 관계없음).
`vicinity`	`string`	도로명, 번지, 지역은 포함하되 주/도, 우편번호, 국가는 포함되지 않은 장소의 단순화된 주소입니다. 주변 지역 검색 (기존)에서 반환됩니다.

추가 결과 액세스

기본적으로 각 응답은 쿼리당 최대 20개의 establishment 결과를 반환하지만 각 검색은 세 페이지에 걸쳐 최대 60개까지의 결과를 반환할 수 있습니다. 검색에서 20개 이상의 결과가 반환되면 검색 응답에 추가 값인 next_page_token가 포함됩니다. 다음 결과 집합을 보려면 next_page_token 값을 새 요청의 pagetoken 매개변수에 전달합니다.

next_page_token가 null이거나 반환되지 않으면 더 이상 결과가 없습니다.
동일한 next_page_token로 요청을 다시 시도하면 다음 결과 페이지가 반환됩니다.
pagetoken을 설정하면 다른 매개변수가 무시됩니다.
원래 쿼리 후 최대 두 번까지 새 페이지를 요청할 수 있습니다.
next_page_token를 사용하는 요청을 포함한 각 요청은 사용량 한도 계산 시 하나의 요청으로 간주되며 별도로 청구됩니다.
next_page_token가 발급된 시점과 유효해지는 시점 사이에 몇 초의 지연 시간이 있습니다. 다음 페이지를 사용할 수 있기 전에 요청하면 INVALID_REQUEST 응답이 반환됩니다. next_page_token가 있는 요청에는 항상 요금이 청구됩니다.
참고: next_page_token를 올바르게 사용하려면 사용자가 요청한 경우에만 다음 결과 페이지를 요청해야 합니다. 실제 페이징 (한 번에 20개의 결과 표시)을 구현하거나 사용자가 끝까지 스크롤하면 결과 페이지 하단에 장소를 추가하는 것이 좋습니다.

예를 들어 아래 쿼리에서는 오스트레일리아 시드니의 달링 하버 근처에 있는 레스토랑을 검색하고 결과를 거리순으로 정렬합니다. 응답에 next_page_token 속성이 포함되어 있습니다.

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

다음 결과 집합을 보려면 next_page_token의 결과를 pagetoken 매개변수에 전달하여 새 쿼리를 제출하면 됩니다. 예를 들면 다음과 같습니다.

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

텍스트 검색 (기존) 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

텍스트 검색 (기존) 요청

필수 매개변수

query

반경

선택적 매개변수

language

위치

maxprice

minprice

opennow

pagetoken

지역

유형

텍스트 검색 (기존) 예시

기본 예시

curl

HTTP

불완전한 주소 예시

curl

HTTP

JSON

XML

위치 편향 예시

curl

HTTP

JSON

XML

텍스트 검색 (기존) 응답

JSON

XML

PlacesTextSearchResponse

html_attributions

results

status

error_message

info_messages

next_page_token

PlacesSearchStatus

장소

추가 결과 액세스

텍스트 검색 (기존)

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`