Method: places.autocomplete

{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}

object (Viewport)

북동쪽과 남서쪽 모서리로 정의된 표시 영역

object (Circle)

중심점과 반지름으로 정의되는 원입니다.

{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}

object (Viewport)

북동쪽과 남서쪽 모서리로 정의된 표시 영역

object (Circle)

중심점과 반지름으로 정의되는 원입니다.

{

  // Union field kind can be only one of the following:
  "placePrediction": {
    object (PlacePrediction)
  },
  "queryPrediction": {
    object (QueryPrediction)
  }
  // End of list of possible types for union field kind.
}

object (PlacePrediction)

장소에 대한 예상 검색어입니다.

object (QueryPrediction)

쿼리에 대한 예측입니다.

{
  "place": string,
  "placeId": string,
  "text": {
    object (FormattableText)
  },
  "structuredFormat": {
    object (StructuredFormat)
  },
  "types": [
    string
  ],
  "distanceMeters": integer
}

string

추천 장소의 리소스 이름입니다. 이 이름은 장소 이름을 허용하는 다른 API에서 사용할 수 있습니다.

string

추천 장소의 고유 식별자입니다. 이 식별자는 장소 ID를 허용하는 다른 API에서 사용할 수 있습니다.

object (FormattableText)

반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. 시설 결과의 경우 이는 일반적으로 비즈니스 이름과 주소입니다.

text는 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 서로 별개이지만 서로 관련이 있는 두 가지 UI 요소를 표시하려는 개발자는 대신 structuredFormat를 사용하는 것이 좋습니다. 두 가지 방법으로 장소 예상 검색어를 나타냅니다. 사용자는 structuredFormat를 text로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.

이 텍스트는 places.get에서 반환된 displayName와 다를 수 있습니다.

요청 input 및 languageCode가 다른 언어로 되어 있거나 장소에 현지 언어에서 languageCode로 번역되지 않은 경우 혼합 언어일 수 있습니다.

object (StructuredFormat)

장소 예상 검색어를 장소 이름을 포함하는 기본 텍스트 및 명확한 추가 지형지물 (예: 도시 또는 지역)을 포함하는 보조 텍스트로 분류한 것입니다.

structuredFormat는 서로 다르지만 관련된 두 가지 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 대신 text를 사용하는 것이 좋습니다. 두 가지 방법으로 장소 예상 검색어를 나타냅니다. 사용자는 structuredFormat를 text로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.

string

https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 또는 표 B에서 이 장소에 적용되는 유형 목록입니다.

유형은 장소의 카테고리입니다. 공유 유형이 있는 장소는 유사한 특성을 공유합니다.

integer

origin가 지정된 경우 origin부터 최단 거리의 길이(미터)입니다. 경로와 같은 특정 예측은 이 입력란을 채우지 않을 수도 있습니다.

{
  "text": string,
  "matches": [
    {
      object (StringRange)
    }
  ]
}

string

그대로 사용하거나 matches로 형식이 지정된 텍스트입니다.

object (StringRange)

text에서 입력 요청이 일치하는 위치를 식별하는 문자열 범위 목록입니다. 범위를 사용하여 text의 특정 부분의 서식을 지정할 수 있습니다. 일치가 문자열 일치 이외의 기준 (예: 맞춤법 교정 또는 음역)에 의해 결정된 경우 하위 문자열은 input와 정확히 일치하지 않을 수 있습니다.

이 값은 text의 유니코드 문자 오프셋입니다. 범위는 오프셋 값이 증가하는 순서대로 정렬됩니다.

{
  "startOffset": integer,
  "endOffset": integer
}

integer

문자열에서 첫 번째 유니코드 문자의 0부터 시작하는 오프셋입니다 (양 끝값 포함).

integer

마지막 유니코드 문자의 0 기준 오프셋 (제외)

{
  "mainText": {
    object (FormattableText)
  },
  "secondaryText": {
    object (FormattableText)
  }
}

object (FormattableText)

장소 또는 쿼리의 이름을 나타냅니다.

object (FormattableText)

장소를 추가로 식별하거나 검색어를 세분화하기 위해 도시 또는 지역과 같은 추가 지형지물을 나타냅니다.

{
  "text": {
    object (FormattableText)
  },
  "structuredFormat": {
    object (StructuredFormat)
  }
}

object (FormattableText)

예상 텍스트입니다. 이 텍스트는 장소가 아니라 검색 엔드포인트 (예: 텍스트 검색)에 사용할 수 있는 텍스트 쿼리를 나타냅니다.

text는 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 서로 별개이지만 서로 관련이 있는 두 가지 UI 요소를 표시하려는 개발자는 대신 structuredFormat를 사용하는 것이 좋습니다. 이 둘은 쿼리 예측을 표현하는 두 가지 방법입니다. 사용자는 structuredFormat를 text로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.

요청 input와 languageCode가 다른 언어로 되어 있거나 쿼리의 일부에 현지 언어에서 languageCode로의 번역이 없는 경우 혼합 언어일 수 있습니다.

object (StructuredFormat)

쿼리 예측을 쿼리를 포함하는 기본 텍스트와 추가 명확한 특성 (예: 도시 또는 지역)이 포함된 보조 텍스트로 세분화합니다.

structuredFormat는 서로 다르지만 관련된 두 가지 UI 요소를 표시하려는 개발자에게 권장됩니다. 단일 UI 요소를 표시하려는 개발자는 대신 text를 사용하는 것이 좋습니다. 이 둘은 쿼리 예측을 표현하는 두 가지 방법입니다. 사용자는 structuredFormat를 text로 파싱해서는 안 되며 그 반대의 경우도 마찬가지입니다.