텍스트 검색(신규)은 문자열(예: '뉴욕의 피자', '오타와 근처의 신발 가게' 또는 '중앙로 123')을 기반으로 일련의 장소에 대한 정보를 반환합니다. 이 서비스는 설정된 텍스트 문자열 및 특정 위치와 일치하는 장소의 목록을 반환합니다.
이 서비스는 자동화된 시스템에서 모호한 주소 쿼리를 하는 데 특히 유용하며 문자열에서 주소가 아닌 구성요소가 비즈니스 및 주소와 일치할 수 있습니다. 모호한 주소 쿼리의 예로는 비즈니스 이름과 같이 주소가 아닌 구성요소를 포함하는 잘못된 형식의 주소 또는 요청이 있습니다. 다음 표의 처음 두 예시와 같은 요청은 위치(예: 지역, 위치 제한, 위치 상세 검색)를 설정하지 않으면 결과를 0으로 반환할 수 있습니다.
'10 High Street, UK' 또는 '123 Main Street, US' | 영국에 여러 '하이 스트리트', 미국에 여러 '메인 스트리트' 위치 제한이 설정되지 않으면 쿼리가 원하는 결과를 반환하지 않습니다. |
"ChainRestaurant New York" | 뉴욕에 'ChainRestaurant' 위치가 여러 개 있으며 상세 주소나 도로명도 없습니다. |
'10 High Street, Escher UK' 또는 '123 Main Street, Pleasanton US' | 영국 에셔시의 '하이 스트리트' 1곳, 미국 캘리포니아주 플레즌턴 시의 '메인 스트리트' 1곳 |
'UniqueRestaurantName New York' | 뉴욕에서 이 이름을 사용하는 시설이 하나만 있으므로 구별하기 위해 상세 주소가 필요하지 않습니다. |
"서울의 피자 가게" | 이 쿼리에는 위치 제한이 포함되어 있으며 '피자 레스토랑'은 잘 정의된 장소 유형입니다. 여러 결과를 반환합니다. |
'+1 514-670-8700' | 이 쿼리에는 전화번호가 포함되어 있습니다. 이 함수는 해당 전화번호와 연결된 장소에 대해 여러 결과를 반환합니다. |
API 탐색기를 사용하면 실시간 요청을 수행하여 API 및 API 옵션에 익숙해질 수 있습니다.
텍스트 검색 요청
텍스트 검색 요청은 다음 형식을 사용하는 HTTP POST 요청입니다.
https://places.googleapis.com/v1/places:searchText
JSON 요청 본문 또는 헤더에 모든 매개변수를 POST 요청의 일부로 전달합니다. 예를 들면 다음과 같습니다.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
텍스트 검색 (신규) 응답
텍스트 검색 (신규)은 JSON 객체를 응답으로 반환합니다. 응답에서 각 항목의 의미는 다음과 같습니다.
places
배열에는 일치하는 모든 장소가 포함됩니다.- 배열의 각 장소는
Place
객체로 표현됩니다.Place
객체에는 단일 장소에 대한 자세한 정보가 포함됩니다. - 요청에 전달된 FieldMask는
Place
객체에서 반환된 필드의 목록을 지정합니다.
전체 JSON 객체는 다음과 같은 형식입니다.
{ "places": [ { object (Place) } ] }
필수 매개변수
-
FieldMask
응답 필드 마스크를 만들어 응답에서 반환할 필드 목록을 지정합니다. URL 매개변수
$fields
또는fields
를 사용하거나 HTTP 헤더X-Goog-FieldMask
를 사용하여 응답 필드 마스크를 메서드에 전달합니다. 응답에는 반환된 필드의 기본 목록이 없습니다. 필드 마스크를 생략하면 메서드가 오류를 반환합니다.필드 마스킹은 불필요한 데이터를 요청하지 않도록 하는 좋은 설계 방법이며, 이를 통해 불필요한 처리 시간과 요금이 청구되지 않습니다.
반환할 장소 데이터 유형의 쉼표로 구분된 목록을 지정합니다. 예를 들어 장소의 표시 이름과 주소를 가져올 수 있습니다.
X-Goog-FieldMask: places.displayName,places.formattedAddress
*
를 사용하여 모든 필드를 검색합니다.X-Goog-FieldMask: *
다음 필드 중 하나 이상을 지정합니다.
다음 필드는 Text Search (ID Only) SKU를 트리거합니다.
places.attributions
,places.id
,places.name
*,nextPageToken
*places.name
필드에 리소스 이름 장소가places/PLACE_ID
형식으로 포함됩니다.places.displayName
을 사용하여 장소의 텍스트 이름에 액세스합니다.다음 필드는 Text Search (Basic) SKU를 트리거합니다.
places.accessibilityOptions
,places.addressComponents
,places.adrFormatAddress
,places.businessStatus
,places.displayName
,places.formattedAddress
,places.googleMapsUri
,places.iconBackgroundColor
,places.iconMaskBaseUri
,places.location
,places.photos
,places.plusCode
,places.primaryType
,places.primaryTypeDisplayName
,places.shortFormattedAddress
,places.subDestinations
,places.types
,places.utcOffsetMinutes
,places.viewport
다음 필드는 Text Search (Advanced) SKU를 트리거합니다.
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
다음 필드는 Text Search (Preferred) SKU를 트리거합니다.
places.allowsDogs
,places.curbsidePickup
,places.delivery
,places.dineIn
,places.editorialSummary
,places.evChargeOptions
,places.fuelOptions
,places.goodForChildren
,places.goodForGroups
,places.goodForWatchingSports
,places.liveMusic
,places.paymentOptions
,places.outdoorSeating
,places.reservable
,places.restroom
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.delivery
,places.servesBreakfast
,places.servesBreakfast
places.menuForChildren
places.parkingOptions
places.reviews
places.servesBeer
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
-
textQuery
검색할 텍스트 문자열입니다(예: '레스토랑', '중앙로 123' 또는 '샌프란시스코에서 방문하기 가장 좋은 장소'). API는 이 문자열을 기준으로 일치 가능성이 있는 항목을 반환하고 감지된 관련성을 기준으로 검색 결과를 정렬합니다.
선택적 매개변수
includedType
표 A에 정의된 지정된 유형과 일치하는 장소로 결과를 제한합니다. 하나의 유형만 지정할 수 있습니다. 예를 들면 다음과 같습니다.
"includedType":"bar"
"includedType":"pharmacy"
languageCode
결과를 반환할 때 사용하는 언어입니다.
- 지원 언어 목록을 참고하세요. Google에서는 지원되는 언어를 자주 업데이트하므로 이 목록은 완전하지 않을 수 있습니다.
-
languageCode
가 제공되지 않으면 API의 기본값은en
입니다. 잘못된 언어 코드를 지정하면 API에서INVALID_ARGUMENT
오류를 반환합니다. - API는 사용자와 현지인이 모두 읽을 수 있는 상세 주소를 제공하기 위해 최선을 다합니다. 이를 위해 기본 언어를 관찰하면서 필요한 경우 사용자가 읽을 수 있는 스크립트로 음역된 현지 언어로 상세 주소를 반환합니다. 다른 모든 주소는 기본 언어로 반환됩니다. 주소 구성요소는 모두 첫 번째 구성요소에서 선택된 동일한 언어로 반환됩니다.
- 기본 언어로 이름을 사용할 수 없는 경우 API는 가장 가까운 일치 항목을 사용합니다.
- 선호 언어는 API가 반환하기로 선택한 결과 집합과 반환 순서에 약간의 영향을 미칩니다. 지오코더는 언어에 따라 약어를 다르게 해석합니다(예: 거리 유형의 약어, 한 언어에서는 유효하지만 다른 언어에서는 유효하지 않은 동의어).
locationBias
검색할 영역을 지정합니다. 이 위치는 지정된 지역 외부의 결과를 포함하여 지정된 위치 주변의 결과가 반환될 수 있음을 의미하는 바이어스 역할을 합니다.
locationRestriction
또는locationBias
중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다.locationRestriction
은 결과가 포함되어야 하는 영역을 지정하는 것으로,locationBias
은 결과가 있어야 하지만 영역 밖에 있을 수 있는 영역을 지정하는 것으로 생각하세요.지역을 직사각형 표시 영역 또는 원형으로 지정합니다.
원은 중심점과 반지름(미터)으로 정의됩니다. 반경은 0.0 이상, 50000.0 이하여야 합니다. 기본 반경은 0.0입니다. 예를 들면 다음과 같습니다.
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
직사각형은 위도-경도 표시 영역으로, 대각선으로 마주하는 두 개의 최저점과 상위점으로 표시됩니다. 낮은 지점은 직사각형의 남서쪽 모서리를 나타내고 높은 지점은 직사각형의 북동쪽 모서리를 나타냅니다.
표시 영역은 경계가 포함된 닫힌 영역으로 간주됩니다. 위도 경계는 -90도 이상 90도 이하여야 하며 경도 경계는 -180도 이상 180도 범위여야 합니다.
low
=high
인 경우 표시 영역은 단일 점으로 구성됩니다.low.longitude
>high.longitude
인 경우 경도 범위가 반전됩니다 (표시 영역이 180도 경도선을 교차함).low.longitude
= -180도이고high.longitude
= 180도이면 표시 영역에 모든 경도가 포함됩니다.low.longitude
= 180도이고high.longitude
= -180도인 경우 경도 범위는 비어 있습니다.low.latitude
>high.latitude
인 경우 위도 범위는 비어 있습니다.
낮은 값과 높은 값을 모두 채워야 하며, 표시된 상자는 비워 둘 수 없습니다. 표시 영역이 비어 있으면 오류가 발생합니다.
예를 들어 이 표시 영역은 뉴욕시를 완전히 둘러쌉니다.
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
locationRestriction
검색할 영역을 지정합니다. 지정된 영역을 벗어난 결과는 반환되지 않습니다. 지역을 직사각형 표시 영역으로 지정합니다. 표시 영역 정의에 관한 자세한 내용은
locationBias
설명을 참고하세요.locationRestriction
또는locationBias
중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다.locationRestriction
은 결과가 포함되어야 하는 영역을 지정하는 것으로,locationBias
은 결과가 있어야 하지만 영역 밖에 있을 수 있는 영역을 지정하는 것으로 생각하세요.-
maxResultCount (지원 중단됨)
페이지당 표시할 결과 수 (1~20)를 지정합니다. 예를 들어
maxResultCount
값을 5로 설정하면 첫 페이지에 최대 5개의 결과가 반환됩니다. 쿼리에서 반환할 수 있는 결과가 더 있는 경우 다음 페이지에 액세스하기 위한 후속 요청에 전달할 수 있는nextPageToken
가 응답에 포함됩니다. evOptions
사용 가능한 전기자동차 (EV) 충전 커넥터 및 충전 속도를 식별하기 위한 매개변수를 지정합니다.
connectorTypes
장소에서 사용할 수 있는 전기자동차 충전 커넥터의 유형별로 필터링합니다. 어떤 커넥터 유형도 지원하지 않는 위치는 필터링됩니다. 지원되는 전기자동차 충전 커넥터 유형에는 결합형 (AC 및 DC) 충전기, 테슬라 충전기, GB/T 호환 충전기 (중국 내 EV 급속 충전용), 전원 콘센트 충전기가 있습니다. 자세한 내용은 참조 문서를 확인하세요.
minimumChargingRateKw
최소 EV 충전 속도(킬로와트(kW))를 기준으로 장소를 필터링합니다. 충전 속도가 최소 충전 속도보다 낮은 장소는 모두 필터링됩니다. 예를 들어 충전 속도가 10kW 이상인 전기자동차 충전기를 찾으려면 이 매개변수를 '10'으로 설정합니다.
minRating
평균 사용자 평점이 이 한도보다 크거나 같은 결과로만 결과를 제한합니다. 값은 0.0 이상, 5.0 이상, 0.5 이하여야 합니다. 예: 0, 0.5, 1.0, ... , 5.0(포함) 값은 가장 가까운 0.5 단위로 반올림됩니다. 예를 들어 값이 0.6이면 평점이 1.0 미만인 모든 결과가 제거됩니다.
openNow
true
인 경우 쿼리 전송 시 영업 중인 장소만 반환합니다.false
인 경우 영업 중 상태에 관계없이 모든 비즈니스를 반환합니다. 이 매개변수를false
로 설정하면 Google Places 데이터베이스에 영업시간을 지정하지 않은 장소가 반환됩니다.pageSize
페이지당 표시할 결과 수 (1~20)를 지정합니다. 예를 들어
pageSize
값을 5로 설정하면 첫 페이지에 최대 5개의 결과가 반환됩니다. 쿼리에서 반환할 수 있는 결과가 더 있는 경우 다음 페이지에 액세스하기 위한 후속 요청에 전달할 수 있는nextPageToken
가 응답에 포함됩니다.pageToken
이전 페이지의 응답 본문에서
nextPageToken
를 지정합니다.-
priceLevels
특정 가격 수준으로 표시된 장소로 검색을 제한합니다. 기본값은 모든 가격 수준을 선택하는 것입니다.
PriceLevel
로 정의된 하나 이상의 값의 배열을 지정합니다.예를 들면 다음과 같습니다.
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
쿼리 유형에 따라 응답에서 결과의 순위가 지정되는 방식을 지정합니다.
- '뉴욕의 식당'과 같은 범주형 쿼리의 경우
RELEVANCE
(검색 관련성을 기준으로 결과 순위 지정)가 기본값입니다.rankPreference
을RELEVANCE
또는DISTANCE
(거리별 결과 순위)로 설정할 수 있습니다. - 'Mountain View, CA'와 같이 범주형이 아닌 쿼리의 경우
rankPreference
을 설정하지 않은 상태로 두는 것이 좋습니다.
- '뉴욕의 식당'과 같은 범주형 쿼리의 경우
regionCode
응답 형식을 지정하는 데 사용되는 지역 코드로, 2자리 CLDR 코드 값으로 지정됩니다. 이 매개변수는 검색결과에도 편향 효과를 줄 수 있습니다. 기본값은 없습니다.
응답의
formattedAddress
필드의 국가 이름이regionCode
와 일치하면formattedAddress
에서 국가 코드가 생략됩니다. 이 매개변수는 사용 가능한 경우 항상 국가 이름을 포함하는adrFormatAddress
또는 국가 이름을 포함하지 않는shortFormattedAddress
에는 영향을 미치지 않습니다.대부분의 CLDR 코드는 ISO 3166-1 코드와 동일하지만 일부 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)이지만 ISO 3166-1 코드는 'gb' (기술적으로 '영국 및 북아일랜드' 엔티티)입니다. 매개변수는 관련 법률에 따라 결과에 영향을 미칠 수 있습니다.
strictTypeFiltering
includedType
매개변수와 함께 사용됩니다.true
로 설정하면includeType
로 지정된 지정된 유형과 일치하는 장소만 반환됩니다. 기본값인 false인 경우 지정된 유형과 일치하지 않는 장소가 응답에 포함될 수 있습니다.
텍스트 검색 예
쿼리 문자열로 장소 찾기
다음 예는 '오스트레일리아 시드니의 매운 채식주의자 음식'에 대한 텍스트 검색 요청을 보여줍니다.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
X-Goog-FieldMask
헤더는 응답에 places.displayName,places.formattedAddress
데이터 필드가 포함되어 있음을 지정합니다.
응답은 다음과 같은 형식입니다.
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
추가 정보를 반환하려면 필드 마스크에 데이터 유형을 더 추가하세요.
예를 들어 응답에 레스토랑 유형과 웹 주소를 포함하려면 places.types,places.websiteUri
를 추가합니다.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \ 'https://places.googleapis.com/v1/places:searchText'
이제 응답은 다음과 같은 형식입니다.
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
가격 수준별 장소 필터링
priceLevel
옵션을 사용하여 저렴하거나 약간 비싼 레스토랑으로 정의된 레스토랑으로 결과를 필터링합니다.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia", "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
또한 이 예에서는 X-Goog-FieldMask
헤더를 사용하여 places.priceLevel
데이터 필드를 다음과 같은 형식으로 응답에 추가합니다.
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
includedType
, minRating
, rankPreference
, openNow
및 선택적 매개변수에 설명된 기타 매개변수와 같은 추가 옵션을 추가하여 검색을 세분화합니다.
지역 내 장소 검색
검색을 특정 영역으로 제한하려면 locationRestriction
또는 locationBias
중 하나만 사용합니다. locationRestriction
은 결과가 포함되어야 하는 영역을 지정하는 것으로, locationBias
은 결과가 있어야 하지만 영역 밖에 있을 수 있는 영역을 지정하는 것으로 생각하세요.
다음 예는 샌프란시스코 시내의 한 지점에서 500미터 이내에 있도록 편중된 'Spicy Vegetarian Food'에 대한 텍스트 검색 요청을 보여줍니다. 이 요청은 영업 중인 장소의 처음 10개 결과만 반환합니다.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "pageSize": 10, "locationBias": { "circle": { "center": {"latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } }, }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
최소 충전 속도가 적용되는 전기자동차 충전기를 검색하세요
minimumChargingRateKw
및 connectorTypes
를 사용하여 내 전기자동차와 호환되는 사용 가능한 충전기가 있는 장소를 검색하세요.
다음 예는 캘리포니아주 마운틴뷰에서 최소 충전 속도가 10kW인 Tesla 및 J1772 유형 1 EV 충전 커넥터에 대한 요청을 보여줍니다. 4개의 결과만 반환됩니다.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "pageSize": 4, "evOptions": { "minimumChargingRateKw": 10, "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"] } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \ 'https://places.googleapis.com/v1/places:searchText'
요청은 다음 응답을 반환합니다.
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
페이지당 반환할 결과 수 지정
pageSize
매개변수를 사용하여 페이지당 반환할 결과 수를 지정합니다. 응답 본문의 nextPageToken
매개변수는 결과의 다음 페이지에 액세스하기 위한 후속 호출에서 사용할 수 있는 토큰을 제공합니다.
다음 예는 페이지당 결과 5개로 제한된 'pizza in New York' 요청을 보여줍니다.
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
결과의 다음 페이지에 액세스하려면 pageToken
를 사용하여 요청 본문에 nextPageToken
를 전달합니다.
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5, "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
사용해 보기
API 탐색기를 사용하면 샘플 요청을 수행하여 API 및 API 옵션에 익숙해질 수 있습니다.
페이지 오른쪽에 있는 API 아이콘 을 선택합니다.
필요한 경우 표준 매개변수 표시를 펼치고
fields
매개변수를 필드 마스크로 설정합니다.필요한 경우 요청 본문을 수정합니다.
실행 버튼을 선택합니다. 팝업 대화상자에서 요청에 사용할 계정을 선택합니다.
API 탐색기 패널에서 확장 아이콘 을 선택하여 API 탐색기 창을 펼칩니다.