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

주변 검색 (기존)

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

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

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

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

주변 검색 (기존)을 사용하면 지정된 영역 내에서 장소를 검색할 수 있습니다. 키워드를 제공하거나 검색 중인 장소 유형을 지정하여 검색 요청을 세분화할 수 있습니다.

주변 검색 (기존) 요청

주변 지역 검색 (기존) 요청은 다음과 같은 형식의 HTTP URL입니다.

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

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

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

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

필수 매개변수

위치

장소 정보를 가져올 지점입니다. latitude,longitude로 지정해야 합니다.

반경

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

반경은 검색 유형 및 기타 매개변수에 따라 자동으로 최댓값으로 고정됩니다.

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

선택적 매개변수

키워드

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

이 매개변수를 사용하여 위치 정보를 명시적으로 포함하면 위치, 반경, 순위 매개변수와 충돌하여 예기치 않은 결과가 발생할 수 있습니다.

이 매개변수를 생략하면 business_status가 CLOSED_TEMPORARILY 또는 CLOSED_PERMANENTLY인 장소는 반환되지 않습니다.

language

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

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

maxprice

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

minprice

이름

name는 지원 중단되었습니다.

keyword와 같습니다. 이 필드의 값은 keyword 필드의 값과 결합되어 동일한 검색 문자열의 일부로 전달됩니다.

opennow

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

pagetoken

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

rankby

결과가 나열되는 순서를 지정합니다. 가능한 값은 다음과 같습니다.

prominence(기본값). 이 옵션은 중요도를 기반으로 결과를 정렬합니다. 일치하지만 덜 유명한 주변 장소보다 설정된 반경 내 유명한 장소에 더 높은 순위가 부여됩니다. 유명도는 Google 색인에서 장소의 순위, 전체 인기도 및 기타 요인의 영향을 받을 수 있습니다. 가 지정된 경우 radius 파라미터가 필요합니다.
distance. 이 옵션은 지정된 위치로부터의 거리의 오름차순으로 검색결과에 편향을 적용합니다. distance를 지정하는 경우 keyword, name 또는 type 중 하나 이상이 필요하며 radius는 허용되지 않습니다.

유형

지정된 유형과 일치하는 장소로 결과를 제한합니다. 유형은 하나만 지정할 수 있습니다. 두 개 이상의 유형을 제공하면 API는 첫 번째 항목 이후의 모든 유형을 무시합니다.

type=hospital|pharmacy|doctor가 type=hospital로 변경됨
type=hospital,pharmacy,doctor는 완전히 무시됩니다.

지원되는 유형의 목록을 참고하세요.

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

주변 지역 검색 (기존) 예시

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

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

주변 지역 검색 (기존) 응답

다음 예는 주변 지역 검색 (기존) 응답을 보여줍니다.

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</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/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
</PlaceSearchResponse>

PlacesNearbySearchResponse

필드	필수	유형	설명
`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

주변 검색 (기존)

주변 검색 (기존) 요청

필수 매개변수

위치

반경

선택적 매개변수

키워드

language

maxprice

minprice

이름

opennow

pagetoken

rankby

유형

주변 지역 검색 (기존) 예시

curl

HTTP

주변 지역 검색 (기존) 응답

JSON

XML

PlacesNearbySearchResponse

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`

PlacesSearchStatus

장소

추가 결과 액세스

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

주변 검색 (기존) 요청

필수 매개변수

위치

반경

선택적 매개변수

키워드

language

maxprice

minprice

이름

opennow

pagetoken

rankby

유형

주변 지역 검색 (기존) 예시

curl

HTTP

주변 지역 검색 (기존) 응답

JSON

XML

PlacesNearbySearchResponse

html_attributions

results

status

error_message

info_messages

next_page_token

PlacesSearchStatus

장소

추가 결과 액세스

주변 검색 (기존)

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`