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

텍스트 검색(신규)

텍스트 검색(신규)은 문자열(예: '뉴욕의 피자', '오타와 근처의 신발 가게' 또는 '중앙로 123')을 기반으로 장소 집합에 대한 정보를 반환합니다. 이 서비스는 텍스트 문자열과 일치하는 장소 목록 및 설정된 위치 편향으로 응답합니다.

이 서비스는 자동화 시스템에서 모호한 주소 쿼리를 수행할 때 특히 유용하며, 문자열에서 주소가 아닌 구성요소는 비즈니스 및 주소와 일치할 수 있습니다. 모호한 주소 쿼리의 예로는 형식이 잘못된 주소 또는 업체 이름과 같이 주소가 아닌 구성요소를 포함하는 요청이 있습니다. 지역, 위치 제한 또는 위치 편향과 같은 위치가 설정되지 않은 경우 다음 표의 처음 두 예와 같은 요청에서 결과가 0개일 수 있습니다.

"10 High Street, UK" 또는 "123 Main Street, US"	영국에는 여러 개의 '고속도로'가, 미국에는 여러 개의 '중앙로'가 있습니다. 위치 제한을 설정하지 않으면 쿼리가 원하는 결과를 반환하지 않습니다.
"뉴욕의 체인 레스토랑"	뉴욕에 여러 'ChainRestaurant' 위치가 여러 개 있습니다. 상세 주소 또는 거리 이름은 넣지 않아도 됩니다.
"10 High Street, Escher UK" 또는 "123 Main Street, Pleasanton US"	영국 에셔에는 '하이 스트리트'가 1개만 있고, 미국 캘리포니아주 플레전턴시에는 '메인 스트리트'가 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'

텍스트 검색 (신규) 응답

Text Search (신규)는 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: *
```
와일드 카드 '*'를 사용하면 모든 필드가 선택됩니다. 개발 시에는 와일드 카드를 사용해도 괜찮지만, 반환될 수 있는 데이터가 많으므로 프로덕션 환경에서는 와일드 카드 (*) 응답 필드 마스크를 사용하지 않는 것이 좋습니다.

places.iconMaskBaseUri 및 places.iconBackgroundColor 사용에 관한 자세한 내용은 장소 아이콘 섹션을 참고하세요.

다음 필드 중 하나 이상을 지정합니다.
- 다음 필드는 Text Search (ID Only) SKU를 트리거합니다.
  places.id, places.name^*
  
  ^* 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.restroom, places.reviews, places.restroom, places.reviews, places.delivery{2, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.delivery, places.outdoorSeatingplaces.reservableplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.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 주소를 사용하여 결과를 편중합니다.

참고: textQuery에 Market in Barcelona와 같은 명시적 위치가 포함된 경우 locationBias 매개변수를 재정의할 수 있습니다. 이 경우 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는 기기의 IP 주소를 사용하여 결과를 편중합니다.
maxResultCount

반환할 장소 결과의 최대 개수를 지정합니다. 1 이상, 20 이하여야 합니다 (기본값).
evOptions

사용 가능한 전기자동차 (EV) 충전 커넥터 및 충전 요금을 식별하기 위한 매개변수를 지정합니다.
- connectorTypes
  
  장소에서 사용할 수 있는 전기자동차 충전 커넥터 유형별로 필터링합니다. 커넥터 유형을 지원하지 않는 장소는 필터링됩니다. 지원되는 EV 충전 커넥터 유형에는 통합 (AC 및 DC) 충전기, Tesla 충전기, 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 지역 정보 데이터베이스에 영업시간을 지정하지 않은 장소가 반환됩니다.
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

includeType 매개변수와 함께 사용됩니다. true로 설정하면 includeType로 지정된 유형과 일치하는 장소만 반환됩니다. 기본값인 false인 경우 지정된 유형과 일치하지 않는 장소가 응답에 포함될 수 있습니다.

텍스트 검색 예

쿼리 문자열로 장소 찾기

다음 예는 'Spicy Vegetarian Food in Sydney, Australia'에 대한 텍스트 검색 요청을 보여줍니다.

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미터 이내에 치우친 'Spicy Vegetarian Food'에 대한 텍스트 검색 요청을 보여줍니다. 이 요청은 영업 중인 장소의 처음 10개 결과만 반환합니다.

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "openNow": true,
  "maxResultCount": 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",
    "maxResultCount": 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
          }
        ]
      }
    }
  ]
}

사용해 보기

API 탐색기를 사용하면 샘플 요청을 수행하여 API 및 API 옵션에 익숙해질 수 있습니다.

페이지 오른쪽에서 API 아이콘 을 선택합니다.
필요한 경우 표준 매개변수 표시를 펼치고 fields 매개변수를 필드 마스크로 설정합니다.
필요한 경우 요청 본문을 수정합니다.
실행 버튼을 선택합니다. 팝업 대화상자에서 요청에 사용할 계정을 선택합니다.
API 탐색기 패널에서 펼치기 아이콘 을 선택하여 API 탐색기 창을 펼칩니다.

텍스트 검색(신규)

텍스트 검색 요청

텍스트 검색 (신규) 응답

필수 매개변수

FieldMask

textQuery

선택적 매개변수

includedType

languageCode

locationBias

locationRestriction

maxResultCount

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

priceLevels

rankPreference

regionCode

strictTypeFiltering