Google Places API 웹 서비스는 서버 애플리케이션용입니다. 클라이언트측 애플리케이션을 빌드하는 경우 Android용 Google Places API 및 Google Maps JavaScript API의 장소 라이브러리를 참조하십시오.
Google Places API 웹 서비스를 사용하면 시설, 주요 관심 지점, 지리적 위치 등 다양한 범주의 장소 정보를 검색할 수 있습니다. 장소는 인접도나 텍스트 문자열로 검색할 수 있습니다. 장소 검색은 장소 목록과 함께 각 장소에 대한 개요 정보를 반환합니다. 추가 정보는 장소 세부정보 검색을 통해 확인할 수 있습니다.
주변 검색 요청
이전 버전 Places API에서는 주변 검색을 장소 검색이라 지칭했습니다.
주변 검색을 사용하면 지정 영역 내 장소를 검색할 수 있습니다. 키워드를 제공하거나 검색중인 장소 유형을 지정하여 검색 요청 범위를 좁힐 수 있습니다.
주변 검색 요청은 다음 형식의 HTTP URL입니다.
https://maps.googleapis.com/maps/api/place/nearbysearch/output?parameters
여기서 output은 다음 값 중 하나입니다.
json(권장)은 출력을 JSON 형식으로 나타냅니다.xml은 출력을 XML로 나타냅니다.
주변 검색 요청을 시작하기 위해서는 특정 매개변수가 필요합니다. URL 표준 형식과 같이 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다.
필수 매개변수
key— 애플리케이션의 API 키입니다. 이 키는 할당량 관리 목적으로 애플리케이션을 식별하고 애플리케이션에서 추가한 장소를 앱에서 즉시 사용할 수 있도록 합니다. Google Developers Console을 방문하여 API 프로젝트를 만들고 키를 얻으세요.location— 장소를 검색할 위치의 위도/경도입니다. 위도, 경도로 지정해야 합니다.radius— 거리를 미터 단위로 정의하며, 이 안에서 장소 결과가 반환됩니다. 허용되는 최대 반경은 50,000미터입니다.rankby=distance(하기의 선택적 매개변수 참조)가 지정된 경우radius가 포함돼서는 안됩니다.rankby=distance(하기의 선택적 매개변수 참조)가 지정된 경우 하나 이상의keyword,name또는types가 필요합니다.
선택적 매개변수
keyword— Google이 색인을 생성한 이 지역의 모든 콘텐츠와 비교할 검색어입니다. 여기에는 이름, 유형, 주소뿐만 아니라 고객 리뷰와 타사 콘텐츠 등이 포함되어 있습니다.language— 결과를 반환하는 데 사용되는 언어를 나타내는 언어 코드입니다(가능한 경우). 지원 언어 목록 및 관련 코드를 참고하세요. 지원 언어는 자주 업데이트되므로 목록이 완전하지 않을 수 있습니다.minprice및maxprice(선택사항) — 지정 가격 범위의 장소로 결과를 제한합니다. 유효 값은 0(가장 저렴함)부터 4(가장 비쌈)의 범위로 표시됩니다. 특정 값이 표시하는 정확한 금액은 지역별로 다릅니다.name— 장소의 이름과 비교할 하나 이상의 검색어이며 공백 문자로 구분합니다. 결과는 전달된name값이 있는 항목으로 제한됩니다. 등록된 장소 이름 외에도 추가 이름이 연결되어 있을 수 있습니다. API는 전달된 이름 값을 이러한 모든 이름과 비교합니다. 따라서 등록된 이름이 검색어와 일치하지 않지만 연관된 이름이 일치하는 장소가 결과에서 반환될 수 있습니다.opennow— 검색 전송 시 영업중인 장소만 반환합니다. 이 매개변수를 검색에 포함하는 경우 Google Places 데이터베이스에 개점 시간을 지정하지 않은 장소는 반환되지 않습니다.rankyby— 결과 표시 순서를 지정합니다. 사용할 수 있는 값은 다음과 같습니다.prominence(기본설정): 이 옵션은 유명도에 따라 결과를 정렬합니다. 지정 영역 내 유명도가 높은 장소에 높은 순위가 부여됩니다. 유명도는 Google 색인에서 장소 순위, 전체 인기도 및 기타 요인의 영향을 받을 수 있습니다.distance. 이 옵션을 사용하면 특정location으로부터의 거리를 기준으로 결과가 오름차순으로 정렬됩니다.distance를 지정하면keyword,name또는types중 하나 이상 필요합니다.
types— 지정 유형 중 하나 이상과 일치하는 장소로 결과를 제한합니다. 유형은 파이프 기호(type1|type2|etc)로 구분해야 합니다. 지원 유형 목록을 참조하세요.pagetoken— 이전에 실행한 검색의 다음 결과 20개를 반환합니다.pagetoken매개변수를 설정하면 이전에 사용한 동일한 매개변수로 검색이 실행됩니다. 그러면pagetoken을 제외한 모든 매개변수가 무시됩니다.zagatselected— 이 매개변수(연관된 값 없이 매개변수 이름만)를 추가하여 Zagat 선정 사업체 위치로 검색을 제한합니다. 이 매개변수에는true또는false값이 필요 없습니다.zagatselected매개변수는 시험적이며 Google Places API for Work 고객에게만 제공됩니다.
Maps API for Work 고객은 요청에 client 또는 signature 매개변수를 포함해서는 안됩니다.
다음은 호주 시드니의 한 지점에서 500미터 반경 내에 있는 장소 중에 이름에 'cruise'가 포함된 'food' 유형의 장소를 검색하도록 요청한 예입니다.
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&types=food&name=cruise&key=AddYourOwnKeyHere
애플리케이션에서 요청이 제대로 작동되려면 상기 예의 키를 본인의 키로 대체해야 합니다.
텍스트 검색 요청
Google Places API 텍스트 검색 서비스는 '뉴욕의 피자 가게' 또는 '오타와 주변의 신발 가게'와 같이 문자열에 기반하여 장소 그룹에 대한 정보를 반환하는 웹 서비스입니다. 이 서비스는 텍스트 문자열과 설정된 모든 위치의 상세검색과 일치하는 장소 목록을 반환합니다. 반환된 응답에는 장소 목록이 포함되어 있으며, 장소 세부정보 요청을 전송하여 응답 내 모든 장소에 대한 추가 정보를 얻을 수 있습니다.
Google Places 검색 서비스는 동일한 사용 한도를 공유합니다. 하지만 텍스트 검색 서비스는 10배의 할당량을 소비할 수 있습니다. 즉, 각 텍스트 검색 요청은 할당량에서 10개의 요청으로 계산됩니다. Google Places API를 Google Maps API for Work 계약의 일부로 구매한 경우, 그 배수는 다를 수 있습니다. 자세한 내용은 Google Maps API for Work 문서를 참조하세요.
장소 텍스트 검색 요청은 다음 형식의 HTTP URL입니다.
https://maps.googleapis.com/maps/api/place/textsearch/output?parameters
여기서 output은 다음 값 중 하나입니다.
json(권장)은 출력을 JSON 형식으로 나타냅니다.xml은 출력을 XML로 나타냅니다.
검색 요청을 시작하기 위해서는 특정 매개변수가 필요합니다. URL 표준 형식과 같이 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다.
필수 매개변수
query— 검색할 텍스트 문자열입니다(예, '레스토랑'. Google Places 서비스는 문자열을 기준으로 일치 후보를 반환하고, 감지된 관련성을 기준으로 검색 결과를 정렬합니다.key— 애플리케이션의 API 키입니다. 이 키는 할당량 관리 목적으로 애플리케이션을 식별하고 애플리케이션에서 추가한 장소를 앱에서 즉시 사용할 수 있도록 합니다. Google Developers Console을 방문하여 API 프로젝트를 만들고 키를 얻으세요.
선택적 매개변수
location— 장소를 검색할 위치의 위도/경도입니다. 위도, 경도로 지정해야 합니다.location매개변수를 지정하는 경우radius매개변수도 함께 지정해야 합니다.radius— 미터 단위로 거리를 정의하며, 이 안에서 상세한 위치정보 결과가 반환됩니다. 허용되는 최대 반경은 50,000미터입니다. 이 지역에 속하는 결과는 검색 반경을 벗어나는 결과보다 순위가 높게 지정되지만, 유명도가 높은 결과의 경우 검색 반경에 속하지 않더라도 포함될 수 있습니다.language— 결과를 반환하는 데 사용되는 언어를 나타내는 언어 코드입니다(가능한 경우). 지원 언어 목록 및 관련 코드를 참고하세요. 지원 언어는 자주 업데이트되므로 목록이 완전하지 않을 수 있습니다.minprice및maxprice(선택사항) — 지정 가격 수준의 장소로 결과를 제한합니다. 유효 값은 0(가장 저렴함)부터 4(가장 비쌈)의 범위로 표시됩니다. 특정 값이 표시하는 정확한 금액은 지역별로 다릅니다.opennow— 검색 전송 시 영업 중인 장소만 반환합니다. 이 매개변수를 검색에 포함하는 경우 Google Places 데이터베이스에 개점 시간을 지정하지 않은 장소는 반환되지 않습니다.types— 지정 유형 중 하나 이상과 일치하는 장소로 결과를 제한합니다. 유형은 파이프 기호(type1|type2|etc)로 구분해야 합니다. 지원유형 목록을 참조하세요.zagatselected— 이 매개변수(연관된 값 없이 매개변수 이름만)를 추가하여 Zagat 선정 사업체 위치로 검색을 제한합니다. 이 매개변수에는true또는false값이 필요 없습니다.zagatselected매개변수는 시험적이며 Google Places API for Work 고객에게만 제공됩니다.
location 및 radius의 매개변수를 전달하여 지정한 원 내의 결과를 우선시할 수 있습니다. 이렇게 하면 Google 장소 서비스에서 원 내의 결과를 우선적으로 표시하도록 지시합니다. 하지만 정의한 영역을 벗어난 결과가 여전히 표시될 수 있습니다.
Maps API for Work 고객의 경우 요청에 client 또는 signature 매개변수를 포함해서는 안됩니다.
다음 예는 시드니 주변의 레스토랑에 대한 검색을 보여줍니다.
https://maps.googleapis.com/maps/api/place/textsearch/xml?query=restaurants+in+Sydney&key=AddYourOwnKeyHere
애플리케이션에서 요청이 제대로 작동되려면 상기 예의 키를 본인의 키로 대체해야 합니다.
레이더 검색 요청
Google Places API 레이더 검색을 사용하면 동시에 200개의 장소를 검색할 수 있지만, 일반적으로 텍스트 검색이나 주변 검색 요청으로 반환되는 결과보다는 상세하지 않습니다. 레이더 검색을 사용하면 사용자가 지역 내 관심 지점을 식별하는 데 도움을 주는 애플리케이션을 개발할 수 있습니다.
검색응답은 최대 200개의 장소를 포함하며, 각 장소에 대해 제공되는 정보는 다음에 한합니다.
- 지리 좌표가 담긴
geometry필드. - 장소에 관한 추가 정보를 얻기 위해 장소 세부정보 요청에 사용하는
place_id. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참조하세요. - 사용이 중단되는
reference매개변수. 이 페이지에 있는 사용 중단 알림을 참고하세요.
레이더 검색 요청은 다음 형식의 HTTP URL입니다.
https://maps.googleapis.com/maps/api/place/radarsearch/output?parameters
여기서 output은 다음 값 중 하나입니다.
json(권장)은 출력을 JSON 형식으로 나타냅니다.xml은 출력을 XML로 나타냅니다.
검색 요청을 시작하기 위해서는 특정 매개변수가 필요합니다. URL 표준 형식과 같이 모든 매개변수는 앰퍼샌드(&) 문자를 사용하여 구분합니다.
필수 매개변수
key— 애플리케이션의 API 키입니다. 이 키는 할당량 관리 목적으로 애플리케이션을 식별하고 애플리케이션에서 추가한 장소를 앱에서 즉시 사용할 수 있도록 합니다. Google Developers Console을 방문하여 API 프로젝트를 만들고 키를 얻으세요.location— 장소를 검색할 위치의 위도/경도입니다. 위도, 경도로 지정해야 합니다.radius— 거리를 미터 단위로 정의하며, 이 안에서 장소 결과가 반환됩니다. 허용되는 최대 반경은 50,000미터입니다.
선택적 매개변수
레이더 검색 요청에는 keyword, name, 또는 types 중 최소한 하나를 포함해야 합니다. 다른 매개변수는 모두 선택사항입니다.
keyword— Google이 색인을 생성한 이 지역의 모든 콘텐츠와 비교할 검색어입니다. 여기에는 이름, 유형, 주소뿐만 아니라 고객 리뷰와 타사 콘텐츠 등이 포함되어 있습니다.minprice및maxprice(선택사항) — 지정 가격 수준의 장소로 결과를 제한합니다. 유효 값은 0(가장 저렴함)부터 4(가장 비쌈)의 범위로 표시됩니다. 특정 값이 표시하는 정확한 금액은 지역별로 다릅니다.name— 장소의 이름과 비교할 하나 이상의 검색어이며 공백으로 구분합니다. 결과는 전달된name값이 있는 항목으로 제한됩니다. 등록된 장소 이름 외에도 추가 이름이 연결되어 있을 수 있습니다. API는 전달된 이름 값을 이러한 모든 이름과 비교합니다. 따라서 등록된 이름이 검색어와 일치하지 않지만 연관된 이름이 일치하는 장소가 결과에서 반환될 수 있습니다.opennow— 검색 전송 시 영업중인 장소만 반환합니다. 이 매개변수를 검색에 포함하는 경우 Google Places 데이터베이스에 개점 시간을 지정하지 않은 장소는 반환되지 않습니다.types— 지정 유형 중 하나 이상과 일치하는 장소로 결과를 제한합니다. 유형은 파이프 기호(type1|type2|etc)로 구분해야 합니다. 지원 유형 목록을 참조하세요.zagatselected— 이 매개변수(연관된 값 없이 매개변수 이름만)를 추가하여 Zagat 선정 사업체 위치로 검색을 제한합니다. 이 매개변수에는true또는false값이 필요 없습니다.zagatselected매개변수는 시험적이며 Google Places API for Work 고객에게만 제공됩니다.
Maps API for Work 고객의 경우 요청에 client 또는 signature 매개변수를 포함해서는 안됩니다.
다음 예는 영국 런던 인근의 박물관 목록을 반환합니다.
https://maps.googleapis.com/maps/api/place/radarsearch/json?location=51.503186,-0.126446&radius=5000&types=museum&key=AddYourOwnKeyHere
keyword, name 및 types 매개변수의 조합을 사용해 더 정확한 쿼리를 수행할 수 있습니다. 다음 예는 채식 메뉴를 제공한다고 다른 사용자가 설명한 파리 내 레스토랑과 카페를 보여줍니다.
https://maps.googleapis.com/maps/api/place/radarsearch/json?location=48.859294,2.347589&radius=5000&types=food|cafe&keyword=vegetarian&key=AddYourOwnKeyHere
애플리케이션에서 요청이 제대로 작동되려면 상기 예의 키를 본인의 키로 대체해야 합니다.
검색 응답
검색 응답은 URL 요청 경로내 output 플래그에서 표시한 형식으로 반환됩니다.
다음 예는 주변 검색 응답을 보여줍니다. 텍스트 검색 응답은 주변 검색 응답과 유사하지만 vicinity 속성 대신 formatted_address를 반환한다는 점에서 차이가 있습니다. 상기의 설명과 같이 레이더 검색에서는 제한적인 입력란만 제시합니다
{
"html_attributions" : [],
"results" : [
{
"geometry" : {
"location" : {
"lat" : -33.870775,
"lng" : 151.199025
}
},
"icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
"id" : "21a0b251c9b8392186142c798263e289fe45b4aa",
"name" : "Rhythmboat Cruises",
"opening_hours" : {
"open_now" : true
},
"photos" : [
{
"height" : 270,
"html_attributions" : [],
"photo_reference" : "CnRnAAAAF-LjFR1ZV93eawe1cU_3QNMCNmaGkowY7CnOf-kcNmPhNnPEG9W979jOuJJ1sGr75rhD5hqKzjD8vbMbSsRnq_Ni3ZIGfY6hKWmsOf3qHKJInkm4h55lzvLAXJVc-Rr4kI9O1tmIblblUpg2oqoq8RIQRMQJhFsTr5s9haxQ07EQHxoUO0ICubVFGYfJiMUPor1GnIWb5i8",
"width" : 519
}
],
"place_id" : "ChIJyWEHuEmuEmsRm9hTkapTCrk",
"scope" : "GOOGLE",
"alt_ids" : [
{
"place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
"scope" : "APP"
}
],
"reference" : "CoQBdQAAAFSiijw5-cAV68xdf2O18pKIZ0seJh03u9h9wk_lEdG-cP1dWvp_QGS4SNCBMk_fB06YRsfMrNkINtPez22p5lRIlj5ty_HmcNwcl6GZXbD2RdXsVfLYlQwnZQcnu7ihkjZp_2gk1-fWXql3GQ8-1BEGwgCxG-eaSnIJIBPuIpihEhAY1WYdxPvOWsPnb2-nGb6QGhTipN0lgaLpQTnkcMeAIEvCsSa0Ww",
"types" : [ "travel_agency", "restaurant", "food", "establishment" ],
"vicinity" : "Pyrmont Bay Wharf Darling Dr, Sydney"
},
{
"geometry" : {
"location" : {
"lat" : -33.866891,
"lng" : 151.200814
}
},
"icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
"id" : "45a27fd8d56c56dc62afc9b49e1d850440d5c403",
"name" : "Private Charter Sydney Habour Cruise",
"photos" : [
{
"height" : 426,
"html_attributions" : [],
"photo_reference" : "CnRnAAAAL3n0Zu3U6fseyPl8URGKD49aGB2Wka7CKDZfamoGX2ZTLMBYgTUshjr-MXc0_O2BbvlUAZWtQTBHUVZ-5Sxb1-P-VX2Fx0sZF87q-9vUt19VDwQQmAX_mjQe7UWmU5lJGCOXSgxp2fu1b5VR_PF31RIQTKZLfqm8TA1eynnN4M1XShoU8adzJCcOWK0er14h8SqOIDZctvU",
"width" : 640
}
],
"place_id" : "ChIJqwS6fjiuEmsRJAMiOY9MSms",
"scope" : "GOOGLE",
"reference" : "CpQBhgAAAFN27qR_t5oSDKPUzjQIeQa3lrRpFTm5alW3ZYbMFm8k10ETbISfK9S1nwcJVfrP-bjra7NSPuhaRulxoonSPQklDyB-xGvcJncq6qDXIUQ3hlI-bx4AxYckAOX74LkupHq7bcaREgrSBE-U6GbA1C3U7I-HnweO4IPtztSEcgW09y03v1hgHzL8xSDElmkQtRIQzLbyBfj3e0FhJzABXjM2QBoUE2EnL-DzWrzpgmMEulUBLGrtu2Y",
"types" : [ "restaurant", "food", "establishment" ],
"vicinity" : "Australia"
},
{
"geometry" : {
"location" : {
"lat" : -33.870943,
"lng" : 151.190311
}
},
"icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png",
"id" : "30bee58f819b6c47bd24151802f25ecf11df8943",
"name" : "Bucks Party Cruise",
"opening_hours" : {
"open_now" : true
},
"photos" : [
{
"height" : 600,
"html_attributions" : [],
"photo_reference" : "CnRnAAAA48AX5MsHIMiuipON_Lgh97hPiYDFkxx_vnaZQMOcvcQwYN92o33t5RwjRpOue5R47AjfMltntoz71hto40zqo7vFyxhDuuqhAChKGRQ5mdO5jv5CKWlzi182PICiOb37PiBtiFt7lSLe1SedoyrD-xIQD8xqSOaejWejYHCN4Ye2XBoUT3q2IXJQpMkmffJiBNftv8QSwF4",
"width" : 800
}
],
"place_id" : "ChIJLfySpTOuEmsRsc_JfJtljdc",
"scope" : "GOOGLE",
"reference" : "CoQBdQAAANQSThnTekt-UokiTiX3oUFT6YDfdQJIG0ljlQnkLfWefcKmjxax0xmUpWjmpWdOsScl9zSyBNImmrTO9AE9DnWTdQ2hY7n-OOU4UgCfX7U0TE1Vf7jyODRISbK-u86TBJij0b2i7oUWq2bGr0cQSj8CV97U5q8SJR3AFDYi3ogqEhCMXjNLR1k8fiXTkG2BxGJmGhTqwE8C4grdjvJ0w5UsAVoOH7v8HQ",
"types" : [ "restaurant", "food", "establishment" ],
"vicinity" : "37 Bank St, Pyrmont"
},
{
"geometry" : {
"location" : {
"lat" : -33.867591,
"lng" : 151.201196
}
},
"icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png",
"id" : "a97f9fb468bcd26b68a23072a55af82d4b325e0d",
"name" : "Australian Cruise Group",
"opening_hours" : {
"open_now" : true
},
"photos" : [
{
"height" : 242,
"html_attributions" : [],
"photo_reference" : "CnRnAAAABjeoPQ7NUU3pDitV4Vs0BgP1FLhf_iCgStUZUr4ZuNqQnc5k43jbvjKC2hTGM8SrmdJYyOyxRO3D2yutoJwVC4Vp_dzckkjG35L6LfMm5sjrOr6uyOtr2PNCp1xQylx6vhdcpW8yZjBZCvVsjNajLBIQ-z4ttAMIc8EjEZV7LsoFgRoU6OrqxvKCnkJGb9F16W57iIV4LuM",
"width" : 200
}
],
"place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
"scope" : "GOOGLE",
"reference" : "CoQBeQAAAFvf12y8veSQMdIMmAXQmus1zqkgKQ-O2KEX0Kr47rIRTy6HNsyosVl0CjvEBulIu_cujrSOgICdcxNioFDHtAxXBhqeR-8xXtm52Bp0lVwnO3LzLFY3jeo8WrsyIwNE1kQlGuWA4xklpOknHJuRXSQJVheRlYijOHSgsBQ35mOcEhC5IpbpqCMe82yR136087wZGhSziPEbooYkHLn9e5njOTuBprcfVw",
"types" : [ "travel_agency", "restaurant", "food", "establishment" ],
"vicinity" : "32 The Promenade, King Street Wharf 5, Sydney"
}
],
"status" : "OK"
}
JSON 응답에는 최대 4개의 루트 요소가 있습니다.
"status"에는 요청의 메타데이터가 있습니다. 하기의 상태 코드를 참조하세요."results"요소에는 각 장소와 함께 장소의 배열이 있습니다. 결과에 대한 자세한 내용은 검색 결과를 참조하세요. Places API는 검색당 최대 20개의establishment결과를 반환합니다. 또한 요청 영역을 식별하기 위해 사용되는political관련 결과도 반환될 수 있습니다.html_attributions에는 사용자에게 표시되어야 하는 목록의 특성 모음이 있습니다.next_page_token에는 최대 20개의 추가 결과를 반환하는 데 사용할 수 있는 토큰이 있습니다. 표시할 추가 결과가 없는 경우next_page_token이 반환되지 않습니다. 최대 60개의 결과가 반환될 수 있습니다.next_page_token이 생성된 후 효력이 발생하기까지 약간의 시간이 소요됩니다
JSON 응답 구문 분석에 대한 도움말은 Javascript로 JSON 처리를 참조하세요.
<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
<status>OK</status>
<result>
<name>Rhythmboat Cruises</name>
<vicinity>Pyrmont Bay Wharf Darling Dr, Sydney</vicinity>
<type>travel_agency</type>
<type>restaurant</type>
<type>food</type>
<type>establishment</type>
<geometry>
<location>
<lat>-33.8707750</lat>
<lng>151.1990250</lng>
</location>
</geometry>
<icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
<place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
<scope>GOOGLE</scope>
<alt_ids>
<place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
<scope>APP</scope>
</alt_ids>
<reference>CoQBdAAAAChhtoQX_467esHavS0Sj9DrY306W3_uDXKmB2us8Eh7_dX7rDuln18i_uqocF_LmzRptuFr6WZs7aeBSLFq8VFmckxFjsXDaqMdd3gvxi_5dIwPTEugQQYG9oJA-YnYfPBvjGtuoMfNnjyU2GuxGRmJjCO77pEAbsTLq44eBG5jEhAvkKHCGqIzqgC9tdOb1dSqGhRA1hhG4pvILD5OEAq6W8L8sXbkug</reference>
<id>21a0b251c9b8392186142c798263e289fe45b4aa</id>
<opening_hours>
<open_now>true</open_now>
</opening_hours>
<photo>
<photo_reference>CnRnAAAAiRA8ls6lx5LTfLuHJtLYvz73LXIMa5EVsHz2OUjh70LBPBnIEULZ57w076gOuyCeJqP041_v-ek3I5C4IkqW7YgA0EBybwywfIcUXsj5W_qiJR2yaXHXI-FmDM6j1zaS0sJQnNJhe4Bl9W42Jx16phIQRmNOWKGIemKLgzNEPcCnmBoUGgr0gWQBwWd8HAseR-5ie3JYuIM</photo_reference>
<width>519</width>
<height>270</height>
</photo>
</result>
<result>
<name>Private Charter Sydney Habour Cruise</name>
<vicinity>Australia</vicinity>
<type>restaurant</type>
<type>food</type>
<type>establishment</type>
<geometry>
<location>
<lat>-33.8668910</lat>
<lng>151.2008140</lng>
</location>
</geometry>
<icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
<place_id>ChIJqwS6fjiuEmsRJAMiOY9MSms</place_id>
<scope>GOOGLE</scope>
<reference>CpQBhQAAAKGKrbbnAW3_eAypKW9bhAzAuSmaqAogs7MTFxsntDqCzt-gKD9nz-zqNsk0uJsl0yCUYpNYjHz_yzmh3J_4TTxpxIqdaq2uDvfoTYtvm8FkxMAkK3cS7k9t3Ze2aHRWnxlN9hczK2xlc5taDE7xAGOHF5Xe5IlVV1wV66sOrWrlHtGh47lqT9Id86eG2OmlVhIQo4djLtRkceg-zaYjULYEjRoUToVEyOUVCFfZMUs_E7ZLSzjFmcg</reference>
<id>45a27fd8d56c56dc62afc9b49e1d850440d5c403</id>
<photo>
<photo_reference>CnRnAAAAUW97jpK2_C2Lh4jLPVKZlhyS84mqZxvVmWFdc6jdl3XxjzKbYdbJpz0PGW5eFRw6kTKYNZM9QvRf-csFegHILZxLCLJ-6ZnbdEXbVM4kBzOb-rhchJx1KC6LHs_vVWP8bK96569lFYRf7Hn8ylQrlhIQb69_dcZVwqQhREsHW6azWhoU0XMWqZMBBzx-hgpduAaeErOFg8E</photo_reference>
<width>640</width>
<height>426</height>
</photo>
</result>
<result>
<name>Bucks Party Cruise</name>
<vicinity>37 Bank St, Pyrmont</vicinity>
<type>restaurant</type>
<type>food</type>
<type>establishment</type>
<geometry>
<location>
<lat>-33.8709430</lat>
<lng>151.1903110</lng>
</location>
</geometry>
<icon>http://maps.gstatic.com/mapfiles/place_api/icons/restaurant-71.png</icon>
<place_id>ChIJLfySpTOuEmsRsc_JfJtljdc</place_id>
<scope>GOOGLE</scope>
<reference>CoQBdAAAAOMUoYamsekTDxBDVyKZ-E54VQ6HjirVzAZBBwz5gcn5KTfmemmwmOAtLcvRScp1NLQmj-fBYzEO2Gq_cO4Dc12PG0_twzDv9zq3KIyNQVuO-r0n1eQVj8Dlng-n4c1F2hMxufCNVp4-QfjMj81qXJm0invQMUc1xNgZRyiOpLe9EhDLn0KiVWEFKOURYsWrHRouGhR7YMJxYmFs-OXjKyzQKGdQXLrzPw</reference>
<id>30bee58f819b6c47bd24151802f25ecf11df8943</id>
<opening_hours>
<open_now>true</open_now>
</opening_hours>
<photo>
<photo_reference>CnRnAAAAjboYP9Ujxe5SmZFN5AJc42AWtpYFX9wYdqjcTXavXJlfoXdHPC2hErdbHcaeYJBNPV6CzoDc2RLw_w9HofGOhCWHtoAl9b3g8TZZjnZobnAHxoljUdgV8PXyd-pCO-QHKOtiKfIdUmF4HRj2QHj6OhIQhLNpoKNKP8MNjk90M4KGrhoUW2NyBgsWjRpUEoWlt0fD48BhEcQ</photo_reference>
<width>800</width>
<height>600</height>
</photo>
</result>
<result>
<name>Australian Cruise Group</name>
<vicinity>32 The Promenade, King Street Wharf 5, Sydney</vicinity>
<type>travel_agency</type>
<type>restaurant</type>
<type>food</type>
<type>establishment</type>
<geometry>
<location>
<lat>-33.8675910</lat>
<lng>151.2011960</lng>
</location>
</geometry>
<icon>http://maps.gstatic.com/mapfiles/place_api/icons/travel_agent-71.png</icon>
<place_id>ChIJrTLr-GyuEmsRBfy61i59si0</place_id>
<scope>GOOGLE</scope>
<reference>CoQBeAAAAJZA0WY2pKnZ6nNnxNd_pSDA2NilDLfGDf7pTt7VssxB5tMYE7400w3HZHRav2unpKRhEp7lrh0yKcVdSfKYIz85k1SExoLGmYD8NIf1dPr8KlkRWOYZUTLGp623r5hAzEGk94mPleF4s50pWqLrhAzwvJb1tGj2ak-2PXQORkeTEhAfTj6tMFo_tRWZYOnYCxiVGhQA3n-KV7AW5MvJlGaIDHuLyyEBBA</reference>
<id>a97f9fb468bcd26b68a23072a55af82d4b325e0d</id>
<opening_hours>
<open_now>true</open_now>
</opening_hours>
<photo>
<photo_reference>CnRnAAAAhTkpwozMoZx_NXMkIrKdcEGe46BmPy3GPCfS-gkCK5PlR8rFDY9DtD_7wFYAIdhVoZz3I9QguRNbil5y37jTU-03GJ_LqVw_avSxFkT0g2kU0K5z2VYnAsgNsrbsK_EVglhg5PrDybC1tAVKCXSGsRIQOcdlAVnC1Qc46YLWjlqdyxoUL5JGZgczfo1jxLxhDeGs8OvBQCk</photo_reference>
<width>200</width>
<height>242</height>
</photo>
</result>
</PlaceSearchResponse>
XML 응답은 다음과 같은 단일 <PlaceSearchResponse> 요소와 최대 4개의 상위 요소로 구성됩니다.
<status>에는 요청의 메타데이터가 있습니다. 하기의 상태 코드를 참조하세요.- 0개 이상의
<result>요소가 있으며, 각 요소에는 단일 시설에 대한 정보가 있습니다. 결과에 대한 정보는 주변 검색 결과를 참조하세요. Places API는 검색당 최대 20개의establishment결과를 반환합니다. 또한 요청 영역을 식별하기 위해 사용되는political<type>결과, 또는 도로 관련 결과도 반환될 수 있습니다. next_page_token에는 최대 20개의 추가 결과를 반환하는 데 사용할 수 있는 토큰이 있습니다. 표시할 추가 결과가 없는 경우next_page_token이 반환되지 않습니다. 최대 60개의 결과가 반환될 수 있습니다.next_page_token은 최초 발행 2초 후에 활성화됩니다.html_attributions에는 사용자에게 표시되어야 하는 목록의 특성 모음이 있습니다.
상태 코드
검색 응답 객체의 "status" 필드에는 요청의 상태가 포함되어 있습니다. 또한 요청이 실패한 원인을 추적하는 데 도움이 되는 디버깅 정보가 있을 수도 있습니다. "status" 필드에는 다음 값이 포함될 수 있습니다.
OK는 오류가 발생되지 않았음을 나타냅니다. 장소가 성공적으로 감지되었고 최소 한 개 이상의 결과가 반환됩니다.ZERO_RESULTS는 검색에 성공했지만 반환된 결과가 없음을 나타냅니다. 이는 멀리 떨어진 위치의latlng가 검색에 전달된 경우 발생할 수 있습니다.OVER_QUERY_LIMIT는 할당량이 초과되었음을 나타냅니다.REQUEST_DENIED는 요청이 거부되었음을 나타냅니다. 일반적인 원인은key매개변수가 잘못되었기 때문입니다.INVALID_REQUEST는 일반적으로 필수 검색 매개변수(location또는radius)가 누락되어 있음을 나타냅니다.
오류 메시지
Google 장소 서비스가 OK 이외의 상태 코드를 반환하면 검색 응답 객체에 추가 error_message 입력란이 있을 수 있습니다. 이 필드는 상태 코드가 제시된 이유에 대한 상세정보를 포함합니다.
검색 결과
Google Places 서비스가 검색에서 JSON 결과 반환 시 결과는 results 배열 내에 배치됩니다. 서비스에서 결과를 반환하지 않는 경우에도(예: location이 멀리 떨어진 경우) 여전히 빈 results 배열을 반환합니다. XML 응답은 0개 이상의 <results> 요소로 구성됩니다.
<result> 배열의 각 요소에는 지정된 영역(location 및 radius)의 단일 결과가 있으며, 중요도에 따라 정렬됩니다.
결과에는 사용자에게 표시되어야 하는 특성 정보가 포함될 수도 있습니다. 다음은 JSON 형식의 특성에 대한 예입니다.
"html_attributions" : [
"Listings by \u003ca href=\"http://www.example.com/\"\u003eExample Company\u003c/a\u003e"
],
다음은 XML 형식의 특성에 대한 예입니다. <html_attribution>Listings by <a href="http://www.example.com/">Example Company</a></html_attribution>
각 결과는 results 배열 내 다음 필드를 가질 수 있습니다.
icon에는 지도에 결과를 나타낼 때 사용자에게 표시될 수 있는 권장 아이콘의 URL이 있습니다.id는 장소를 표시하는 안정적인 고유 식별자를 포함합니다. 이 식별자는 장소를 가져오는 데 사용할 수 없지만 여러 세션에서 유효합니다. 이 장소에 대한 데이터를 통합하고 개별 검색에서 장소의 ID를 확인하는 데 사용할 수 있습니다. 참고:id는 이제 사용이 중단되고place_id로 대체됩니다. 이 페이지에 있는 사용 중단 알림을 참고하세요.geometry에는 결과에 관한 도형 정보가 포함됩니다. 여기에는 일반적으로 장소의location(지오코드) 및viewport가 포함됩니다. 뷰포트는 커버리지 범위 내의 일반 영역을 식별하며 선택사항입니다.name에는 사람이 읽을 수 있는 반환된 결과의 이름이 있습니다.establishment의 결과는 일반적으로 상호입니다.opening_hours에는 다음 정보가 포함될 수 있습니다.open-now는 장소가 현재 영업 중임을 나타내는 부울 값입니다.
photos[]—photo객체의 배열이며 각 배열에는 이미지 참조가 포함되어 있습니다. 장소 검색은 1개의photo객체만 반환합니다. 장소에 대한 장소 세부정보 요청을 수행하면 사진이 10개까지 반환될 수 있습니다. 장소 사진에 대한 자세한 내용과 이미지를 애플리케이션에서 사용하는 방법은 장소 사진에서 확인할 수 있습니다.photo객체는 다음 항목으로 설명할 수 있습니다.photo_reference— 사진 요청을 수행하는 경우 사진을 식별하는 데 사용되는 문자열입니다.height— 이미지의 최대 높이입니다.width— 이미지의 최대 너비입니다.html_attributions[]— 모든 필수 특성이 있습니다. 이 필드는 항상 존재하지만 비어있는 경우도 있습니다.
place_id— 장소를 고유하게 식별하는 텍스트 식별자입니다. 장소에 관한 정보를 검색하려면 이 식별자를 Places API 요청의placeId필드에 삽입해 전달합니다. 장소 ID에 대한 자세한 내용은 장소 ID 개요를 참조하세요.scope—place_id의 범위를 표시합니다. 사용할 수 있는 값은 다음과 같습니다.APP: 장소 ID는 본인의 애플리케이션에서만 인식됩니다. 이는 장소를 애플리케이션에 추가했지만 아직 중재 절차를 통과하지 않았기 때문입니다.GOOGLE: 장소 ID를 다른 애플리케이션과 Google Maps에서 사용할 수 있습니다.
scope필드는 주변검색 결과와 장소 세부정보 결과에만 포함됩니다. 주변 검색과 장소 세부정보 요청을 통해서는 앱 지정 범위의 장소만 검색할 수 있습니다.scope필드가 응답에 없으면 범위가GOOGLE이라고 가정해도 무방합니다.alt_ids— 장소의 0개 이상 대체 장소 ID 배열입니다. 각 대체 장소 ID의 관련 범위를 포함합니다. 참고: 이 배열은 비어 있거나 없을 수 있습니다. 있을 경우, 다음 입력란이 있습니다.place_id— 한 장소가 대체 장소 ID를 갖게 되는 가장 큰 이유는 애플리케이션에 장소를 추가하면 애플리케이션 범위의 장소 ID를 부여받고, 이후 중재 절차를 통과하면 Google 범위의 장소 ID를 부여받기 때문입니다.scope— 대체 장소 ID의 범위는 항시APP이며, 이는 대체 장소 ID가 애플리케이션에서만 인식된다는 것을 의미합니다.
AAA라는place_id를 부여받았다고 가정합니다. 이후 장소가 중재 절차를 통과해 Google 범위의BBB라는place_id를 부여받았다고 가정합니다. 이 시점부터 이 장소에 대한 정보에는 다음이 포함됩니다."results" : [ { "place_id" : "BBB", "scope" : "GOOGLE", "alt_ids" : [ { "place_id" : "AAA", "scope" : "APP", } ], } ]price_level— 장소의 가격 수준입니다(0~4등급 기준). 특정 값이 표시하는 정확한 금액은 지역별로 다릅니다. 가격 수준은 다음과 같이 이해할 수 있습니다.0— 무료1— 저렴2— 보통3— 비쌈4— 매우 비쌈
rating에는 장소의 평점이 있습니다(사용자 리뷰 기준으로 0.0~5.0).reference는 장소 세부정보 요청에서 장소에 대한 추가 정보를 검색하는 데 사용할 수 있는 고유 토큰을 포함합니다. 토큰은 장소를 고유하게 식별하지만 장소는 토큰을 식별하지 못합니다. 하나의 장소에 여러 개의 참조 토큰이 있을 수 있습니다. 다른 검색에서 특정 장소에 대해 동일한 토큰이 반환되지 않을 수도 있습니다. 참고:reference는 이제 사용이 중단되고place_id로 대체됩니다. 이 페이지에 있는 사용 중단 알림을 참고하세요.types[]에는 특정 결과를 설명하는 지형지물 유형의 배열이 있습니다. 자세한 내용은 지원 유형 목록을 참조하세요. XML 응답은 한 개 이상의<type>이 결과에 할당되어 있을 경우 여러 요소를 포함합니다.vicinity에는 인근 지역의 지형지물 이름이 있습니다. 지형지물은 대개 지정된 결과 내 거리 또는 근방을 나타냅니다.vicinity속성은 주변 검색에서만 반환됩니다.formatted_address는 장소의 사람이 읽을 수 있는 주소가 포함된 문자열입니다. 주소는 주로 '우편 주소'와 일치합니다.formatted_address속성은 텍스트 검색을 한 경우에만 반환됩니다.
Premium 데이터
위에 나오는 필드 이외에도 Google Places API for Work 고객은 다음 필드를 받을 수 있습니다. 이러한 필드는 result 필드의 최상위 하위항목으로 표시됩니다.
참고: Premium 데이터 기능은 시험 중이므로 변경될 수 있습니다.
aspects에는 시설의 기본 평점과 관련된 단일AspectRating객체가 포함되어 있습니다. 각AspectRating은 다음 항목으로 설명할 수 있습니다.type은 평점을 받는 평가항목의 이름입니다. 다음의 유형이 지원됩니다:appeal,atmosphere,decor,facilities,food,overall,quality및service.rating은 평가항목에 대한 사용자 종합 평점입니다(0~30점). 종합 평점은 0~30점인 반면 리뷰의 일부로 표시되는 평점에는 0~3의 값이 사용됩니다.
zagat_selected는 장소가 Zagat 선정 사업체임을 나타냅니다. Zagat 라벨은 지속적으로 평이 좋은 장소 또는 특별하거나 고유한 특징을 가진 장소를 나타냅니다.
추가 결과에 액세스하기
기본적으로 각 주변 검색 또는 텍스트 검색은 검색당 최대 20개의 establishment 결과를 반환합니다. 하지만 각 검색은 세 페이지에 걸쳐 최대 60개까지의 결과를 반환할 수 있습니다. 검색에서 20개를 초과하는 결과가 반환되는 경우 추가 값인 next_page_token이 검색 응답에 포함됩니다. next_page_token 값을 새로운 검색의 pagetoken 매개변수에 전달하면 다음 20개 결과를 확인할 수 있습니다. next_page_token이 null이거나 반환되지 않은 경우에는 추가 결과가 표시되지 않습니다. next_page_token이 생성된 후 효력이 발생하기까지 약간의 시간이 소요됩니다 사용할 준비가 되기 전에 다음 페이지를 요청하면 INVALID_REQUEST 응답이 반환됩니다. 동일한 next_page_token으로 다시 요청하면 다음 결과 페이지가 반환됩니다.
예를 들어 하기 검색에서는 호주 시드니에 위치한 달링하버 근처의 레스토랑을 검색하여 거리를 기준으로 결과 순위를 지정합니다. 응답에 next_page_token 속성이 포함되어 있음을 확인할 수 있습니다.
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&rankby=distance&types=food&key=AddYourOwnKeyHere
{
"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" : [
{
"geometry" : {
"location" : {
"lat" : -33.867217,
"lng" : 151.195939
}
},
"icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/cafe-71.png",
"id" : "7eaf747a3f6dc078868cd65efc8d3bc62fff77d7",
"name" : "Biaggio Cafe - Pyrmont",
"opening_hours" : {
"open_now" : true
},
"photos" : [
{
"height" : 600,
"html_attributions" : [],
"photo_reference" : "CnRnAAAAmWmj0BqA0Jorm1_vjAvx1n6c7ZNBxyY-U9x99-oNyOxvMjDlo2npJzyIq7c3EK1YyoNXdMFDcRPzwLJtBzXAwCUFDGo_RtLRGBPJTA2CoerPdC5yvT2SjfDwH4bFf5MrznB0_YWa4Y2Qo7ABtAxgeBIQv46sGBwVNJQDI36Wd3PFYBoUTlVXa0wn-zRITjGp0zLEBh8oIBE",
"width" : 900
}
],
"place_id" : "ChIJIfBAsjeuEmsRdgu9Pl1Ps48",
"scope" : "GOOGLE",
"price_level" : 1,
"rating" : 3.4,
"reference" : "CoQBeAAAAGu0wNJjuZ40DMrRe3mpn7fhlfIK1mf_ce5hgkhfM79u-lqy0G2mnmcueTq2JGWu9wsgS1ctZDHTY_pcqFFJyQNV2P-kdhoRIeYRHeDfbWtIwr3RgFf2zzFBXHgNjSq-PSzX_OU6OT2_3dzdhhpV-bPezomtrarW4DsGl9uh773yEhDJT6R3V8Fyvl_xeE761DTCGhT1jJ3floFI5_c-bHgGLVwH1g-cbQ",
"types" : [ "cafe", "bar", "restaurant", "food", "establishment" ],
"vicinity" : "48 Pirrama Rd, Pyrmont"
},
{
"geometry" : {
"location" : {
"lat" : -33.866786,
"lng" : 151.195633
}
},
"icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
"id" : "3ef986cd56bb3408bc1cf394f3dad9657c1d30f6",
"name" : "Doltone House",
"photos" : [
{
"height" : 1260,
"html_attributions" : [ "From a Google User" ],
"photo_reference" : "CnRwAAAAeM-aLqAm573T44qnNe8bGMkr_BOh1MOVQaA9CCggqtTwuGD1rjsviMyueX_G4-mabgH41Vpr8L27sh-VfZZ8TNCI4FyBiGk0P4fPxjb5Z1LrBZScYzM1glRxR-YjeHd2PWVEqB9cKZB349QqQveJLRIQYKq2PNlOM0toJocR5b_oYRoUYIipdBjMfdUyJN4MZUmhCsTMQwg",
"width" : 1890
}
],
"place_id" : "ChIJ5xQ7szeuEmsRs6Kj7YFZE9k",
"scope" : "GOOGLE",
"reference" : "CnRvAAAA22k1PAGyDxAgHZk6ErHh_h_mLUK_8XNFLvixPJHXRbCzg-gw1ZxdqUwA_8EseDuEZKolBs82orIQH4m6-afDZV9VcpggokHD9x7HdMi9TnJDmGb9Bdh8f-Od4DK0fASNBL7Me3CsAWkUMWhlNQNYExIQ05W7VbxDTQe2Kh9TiL840hoUZfiO0q2HgDHSUyRdvTQx5Rs2SBU",
"types" : [ "food", "establishment" ],
"vicinity" : "48 Pirrama Rd, Pyrmont"
},
{
"aspects" : [
{
"rating" : 23,
"type" : "overall"
}
],
...
],
"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=AddYourOwnKeyHere
pagetoken을 설정하면 다른 모든 매개변수가 무시됩니다. 이전과 동일한 검색이 실행되지만 새로운 결과목록을 반환하며, 원래의 검색에 이어서 새로운 페이지를 최대 2회까지 요청할 수 있습니다. 각 결과 페이지는 순서대로 표시되어야 하며, 단일검색의 결과로 두 페이지 이상의 검색 결과가 표시되면 안 됩니다. 각 검색은 사용 한도 계산 시 단일 요청으로 계산됩니다.
sensor 매개변수
이전의 Google Places API는 사용자 위치파악을 위해 애플리케이션의 센서 사용여부를 표시하는 sensor 매개변수의 입력을 요구했습니다. 이 매개변수는 더 이상 필요하지 않습니다.