이 페이지는 Cloud Translation API를 통해 번역되었습니다.

텍스트 검색(신규)

플랫폼 선택: Android iOS JavaScript 웹 서비스

텍스트 검색 (신규) 는 문자열을 기반으로 일련의 장소에 대한 정보를 반환합니다. 예를 들어 "서울 피자" 또는 '오타와 주변 신발 가게' 또는 '중앙로 123'. 이 서비스는 텍스트 문자열 및 모든 위치와 일치하는 장소의 목록을 반환합니다. 확인할 수 있습니다.

이 서비스는 모호한 주소 쿼리 문자열에서 주소가 아닌 구성요소가 일치하거나 주소도 있습니다. 모호한 주소 쿼리의 예는 다음과 같습니다. 형식이 잘못된 주소 또는 주소가 아닌 구성요소가 포함된 요청(예: 업체 이름으로 사용할 수 있습니다. 다음 표의 처음 두 예시와 같은 요청 지역, 위치 등 특정 위치가 없는 경우 0개의 결과가 반환될 수 있습니다. 제한, 즉 위치 편향이 설정되어 있어야 합니다.

'서울특별시 강남구 테헤란로 152' 또는 '서울특별시 강남구 테헤란로 152'	영국의 여러 '하이 스트리트' 미국에 있는 여러 '메인 스트리트'가 있습니다. 위치 제한이 없는 한 쿼리는 원하는 결과를 반환하지 않습니다. 설정합니다.
"ChainRestaurant New York"	여러 'ChainRestaurant' 뉴욕 지점 상세 주소 또는 도로명도 있습니다.
'10 High Street, Escher UK' 또는 "서울특별시 강남구 테헤란로 152"	'High Street' 1곳만 영국 에셔시에서 근무하고 있습니다. 'Main Street' 1곳만 캘리포니아 플레즌턴에 거주하고 있습니다.
'UniqueRestaurantName New York'	뉴욕에 이 이름을 가진 시설이 하나뿐임 상세 주소 없음 확인할 수 있습니다
"서울의 피자 가게"	이 쿼리에는 위치 제한과 '피자 식당'이 포함되어 있습니다. 은 장소 유형도 있습니다. 여러 결과를 반환합니다.
'+1 514-670-8700'	이 쿼리에는 전화번호가 포함되어 있습니다. 다음에 대한 여러 결과를 반환합니다. 해당 전화번호와 연결된 장소가 표시됩니다. 참고: 검색 시 최상의 결과를 얻으려면 전화번호에 국가 코드와 공백을 차례로 입력하세요. `regionCode` 설정 매개변수를 사용해야 합니다.

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: *
```
와일드 카드 '*' 모든 필드를 선택합니다. 그러나 개발 시에는 와일드 카드를 사용해도 좋지만 Google은 와일드 카드 (*) 응답 필드 마스크에 반환할 수 있는 데이터의 양을 나타냅니다.

places.iconMaskBaseUri 및 places.iconBackgroundColor은(는) 다음 위치에서 찾을 수 있습니다. 장소 아이콘 섹션

다음 필드 중 하나 이상을 지정합니다.
- 다음 필드는 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.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.servesBeer, places.servesBreakfast, 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"
참고: 표 B 응답에서만 반환됩니다 다음의 값은 사용할 수 없습니다. 표 B 필터로 사용합니다.
languageCode

결과를 반환할 때 사용하는 언어입니다.
- 자세한 내용은 지원되는 언어 목록을 확인하세요. Google은 지원되는 언어를 자주 업데이트하므로 이 목록은 완전하지 않습니다.
- languageCode가 제공되지 않으면 API의 기본값은 다음과 같습니다. en입니다. 잘못된 언어 코드를 지정하면 API에서 INVALID_ARGUMENT 오류를 반환합니다.
- API는 다음과 같이 읽을 수 있는 상세 주소를 제공하기 위해 최선을 다합니다. 이 문제를 해결할 수 있습니다. 이 목표를 달성하기 위해 주소를 현지 언어로 읽을 수 있으며, 읽을 수 있는 스크립트로 음역하고 사용자가 선호하는 언어를 관찰합니다. 기타 모든 항목 주소는 기본 언어로 반환됩니다. 주소 구성요소는 모두 동일한 언어로 반환되며 이는 첫 번째 구성요소를 사용합니다.
- 기본 언어로 이름을 사용할 수 없는 경우 API는 가장 근접한 값을 찾습니다.
- 선호 언어는 사용자가 선호하는 결과 세트에 약간의 영향을 미칩니다. API가 반환하기로 선택한 값과 반환되는 순서를 지정합니다. 이 지오코더는 언어에 따라 약어를 다르게 해석하지만 예를 들어 도로 유형의 약어나 한 언어에서는 유효하지만 다른 언어에서는 유효하지 않습니다.
locationBias

검색할 영역을 지정합니다. 이 위치는 편향 역할을 하여 결과를 포함하여 지정된 위치 주변의 결과가 반환될 수 있습니다. 지정된 영역 밖에 있을 수 있습니다.

locationRestriction 또는 locationBias를 지정할 수 있습니다. 둘 다일 수는 없습니다 locationRestriction는 결과가 포함되어야 하는 리전 및 locationBias 결과가 근처에 있어야 하지만 외부에 있을 수 있는 지역 지정 확인할 수 있습니다.

참고: 둘 다 생략하는 경우 locationBias 및 locationRestriction 그리고 API 는 기본적으로 IP 바이어스를 사용합니다. IP 바이어스를 통해 API는 기기의 결과에 편향된 IP 주소를 입력하세요.

참고: locationBias 매개변수는 textQuery에 Market in Barcelona와 같은 명시적인 위치 이 경우 locationBias는 무시됩니다.

지역을 직사각형 표시 영역 또는 원형으로 지정합니다.
- 원은 중심점과 반지름(미터)으로 정의됩니다. 반경 0.0 이상 50000.0 이하여야 합니다. 기본 반경은 0.0입니다. 예를 들면 다음과 같습니다.
```
"locationBias": {
  "circle": {
    "center": {
      "latitude": 37.7937,
      "longitude": -122.3965
    },
    "radius": 500.0
  }
}
```
- 직사각형은 위도-경도 표시 영역으로, 2로 표현됩니다. 대각선으로 낮은 점과 높은 점들을 마주 보고 있습니다. 저점은 남서쪽을 나타냄 꼭짓점은 북동쪽을 나타냅니다. 표시됩니다.
  
  표시 영역은 즉, 해당 경계를 포함합니다. 위도 경계 범위는 -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 결과가 근처에 있어야 하지만 외부에 있을 수 있는 리전 지정 확인할 수 있습니다.

참고: 둘 다 생략하는 경우 locationBias 및 locationRestriction 그리고 API 는 기본적으로 IP 바이어스를 사용합니다. IP 상세 검색을 통해 API는 결과를 편중할 수 있습니다.
maxResultCount (지원 중단됨)

지원 중단됨: 이 필드는 지원 중단되었으며 pageSize로 대체되었습니다. maxResultCount와 pageSize를 모두 지정하면 pageSize가 사용되고 maxResultCount는 무시됩니다.

페이지당 표시할 결과 수 (1~20)를 지정합니다. 예를 들어 maxResultCount 값을 5로 설정하면 최대 5가 반환됩니다. 첫 번째 페이지에 광고가 게재됩니다. 더 많은 결과를 반환할 수 있는 경우 응답에는 쿼리에서 제공한 nextPageToken가 포함됩니다. 다음 페이지에 액세스하기 위해 후속 요청으로 전달할 수 있습니다.

참고: maxResultCount가 0이거나 지정되지 않은 경우 API는 기본적으로 페이지당 20개의 결과를 반환합니다. maxResultCount이 20보다 크면 API는 페이지당 20개 이하의 결과를 반환합니다.
evOptions

사용 가능한 전기자동차 (EV)를 식별하기 위한 매개변수를 지정합니다. 충전 커넥터 및 충전 속도
- connectorTypes
  
  장소에서 사용할 수 있는 전기자동차 충전 커넥터의 유형별로 필터링합니다. 가 어떤 커넥터 유형도 지원하지 않는 장소는 필터링됩니다. 있습니다. 지원되는 전기자동차 충전 커넥터 유형에는 결합 유형 (AC 및 DC)이 포함됩니다. 충전기, 테슬라 충전기, GB/T 규격 충전기 (지역 내 전기자동차 급속 충전용) 벽면 콘센트 충전기를 연결합니다. 자세한 내용은 참조 문서 문서를 참조하세요
- 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인 경우 모든 비즈니스를 반환합니다. 공개 상태와 관계없이 Google 지역 정보 데이터베이스에 영업시간을 지정하지 않은 장소는 다음과 같습니다. 이 매개변수를 false로 설정하면 반환됩니다.
pageSize

페이지당 표시할 결과 수 (1~20)를 지정합니다. 예를 들어 pageSize 값을 5로 설정하면 최대 5가 반환됩니다. 첫 번째 페이지에 광고가 게재됩니다. 더 많은 결과를 반환할 수 있는 경우 응답에는 쿼리에서 제공한 nextPageToken가 포함됩니다. 다음 페이지에 액세스하기 위해 후속 요청으로 전달할 수 있습니다.

참고: pageSize가 0이거나 지정되지 않은 경우 API는 기본적으로 페이지당 20개의 결과를 반환합니다. pageSize이 20보다 크면 API는 페이지당 20개 이하의 결과를 반환합니다.
pageToken

응답 본문에서 nextPageToken를 지정합니다. 이전 페이지
priceLevels

특정 가격 수준으로 표시된 장소로 검색을 제한합니다. 기본값은 모든 가격 수준을 선택하는 것입니다.

다음에 의해 정의된 하나 이상의 값의 배열을 지정합니다. PriceLevel

참고: PRICE_LEVEL_FREE은 허용되지 않습니다. 응답을 채우는 데만 사용됩니다.

예를 들면 다음과 같습니다.
```
"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 결과가 가깝지만 그 밖에 있을 수 있는 지역을 지정하는 것과 같습니다. 확인할 수 있습니다.

참고: locationBias를 사용하는 경우 지역을 직사각형 표시 영역이나 원으로 지정할 수 있습니다. locationRestriction의 경우 리전을 직사각형 표시 영역입니다

다음 예는 "매콤한 채식주의자 음식" 500미터 이내에 있도록 편향된 있습니다. 이 요청은 다음에 대한 처음 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 사용 내 전기자동차와 호환되는 충전기가 있는 장소를 검색할 수 있습니다.

다음 예시는 Tesla 및 J1772 유형 1 EV 충전에 대한 요청을 보여줍니다. 캘리포니아 마운틴뷰에서 최소 충전 속도가 10kW인 커넥터 단 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개로 제한 페이지당 결과 수:

 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 탐색기 창을 펼칩니다.

텍스트 검색(신규)

텍스트 검색 요청

텍스트 검색 (신규) 응답

필수 매개변수

FieldMask

textQuery

선택적 매개변수

includedType

languageCode

locationBias

locationRestriction

maxResultCount (지원 중단됨)

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

pageSize

pageToken

priceLevels

rankPreference

regionCode

strictTypeFiltering