주변 검색 (기존)

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

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

주변 검색 (기존) 요청

주변 지역 검색 (기존) 요청은 다음과 같은 형식의 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 장소 서비스는 이 문자열을 기반으로 일치 가능성이 있는 항목을 반환하고 감지된 관련성을 기반으로 검색 결과를 정렬합니다.

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

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

  • language

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

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

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

  • minprice

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

  • 이름

    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

필드 필수 유형 설명
required Array<string>

사용자에게 표시해야 하는 이 등록정보에 관한 저작자 표시 집합이 포함될 수 있습니다 (일부 등록정보에는 저작자 표시가 없을 수 있음).

required Array<Place>

장소 배열이 포함됩니다.

장소 검색 요청은 장소 세부정보 요청에서 반환하는 필드의 하위 집합을 반환합니다. 장소 검색에서 원하는 필드를 반환하지 않는 경우 장소 검색을 사용하여 place_id를 가져온 다음 이 장소 ID를 사용하여 장소 세부정보를 요청할 수 있습니다.

자세한 내용은 장소를 참고하세요.

required PlacesSearchStatus

요청의 상태가 포함되며 요청이 실패한 이유를 추적하는 데 도움이 되는 디버깅 정보가 포함될 수도 있습니다.

자세한 내용은 PlacesSearchStatus를 참고하세요.

선택사항 문자열

서비스가 OK< 이외의 상태 코드를 반환하는 경우 응답 객체 내에 추가 error_message 필드가 있을 수 있습니다. 이 필드에는 지정된 상태 코드의 이유에 관한 자세한 정보가 포함됩니다. 이 필드는 항상 반환되지 않으며 콘텐츠는 변경될 수 있습니다.

선택사항 Array<string>

서비스가 요청 사양에 대한 추가 정보를 반환하면 응답 객체 내에 추가 info_messages 필드가 있을 수 있습니다. 이 필드는 성공적인 요청에 대해서만 반환됩니다. 항상 반환되는 것은 아니며 콘텐츠는 변경될 수 있습니다.

선택사항 문자열

최대 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 속성이 포함되어 있습니다.

{
   "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