Places API 정보 (신규)

Places API (신규)에는 다음 API가 포함됩니다.

이 문서에는 이러한 새 API의 개요가 포함되어 있습니다.

Place Details (신규)

장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 장소 ID를 사용하여 장소 세부정보 (신규) 요청을 시작하여 특정 시설이나 관심 장소에 대한 세부정보를 요청할 수 있습니다. 장소 세부정보 (신규) 요청은 전체 주소, 전화번호, 사용자 평점, 리뷰와 같이 지정된 장소에 대한 포괄적인 정보를 반환합니다.

장소 ID를 가져오는 방법에는 여러 가지가 있습니다. 이 옵션은 다음과 같습니다.

장소 사진 (신규)

장소 사진 (신규) API를 사용하면 Google Places 데이터베이스에 저장된 수백만 개의 사진에 액세스하여 애플리케이션에 고품질 사진 콘텐츠를 추가할 수 있습니다. Place Photo (New) API를 사용하면 사진에 액세스하고 애플리케이션에 맞게 최적의 크기로 이미지를 조정할 수 있습니다.

장소 사진 (신규) API에 대한 모든 요청에는 반환할 사진을 고유하게 식별하는 사진 리소스 이름이 포함되어야 합니다. 다음을 사용하여 사진 리소스 이름을 가져올 수 있습니다.

Place Details (신규), Text Search (신규) 또는 Nearby Search (신규) 요청의 응답에 사진 리소스 이름을 포함하려면 요청의 필드 마스크에 photos 필드를 포함해야 합니다.

텍스트 검색 (신규) 및 주변 검색 (신규)

Places API에는 두 가지 검색 API가 포함되어 있습니다.

  • 텍스트 검색 (신규)

    장소를 검색할 텍스트 문자열을 지정할 수 있습니다. 예: '호주 시드니의 매운 채식 음식' 또는 '캘리포니아 팔로 알토 근처의 고급 해산물 식당'

    가격 수준, 현재 영업 상태, 평점, 특정 장소 유형과 같은 세부정보를 지정하여 검색 범위를 좁힐 수 있습니다. 결과가 특정 위치에 편중되도록 지정하거나 검색을 특정 위치로 제한할 수도 있습니다.

  • 주변 지역 검색 (신규)

    장소 유형 목록과 함께 검색할 지역을 지정할 수 있습니다. 중심점의 위도 및 경도 좌표와 미터 단위의 반지름으로 정의된 원으로 지역을 지정합니다.

    장소의 특성을 정의하는 장소 유형을 하나 이상 지정합니다. 예를 들어 'pizza_restaurant' 및 'shopping_mall'를 지정하여 지정된 지역의 쇼핑몰에 위치한 피자 레스토랑을 검색합니다.

두 검색의 주요 차이점은 텍스트 검색 (신규)을 사용하면 임의의 검색 문자열을 지정할 수 있지만 주변 검색 (신규)을 사용하려면 검색할 특정 영역이 필요하다는 점입니다.

자동 완성 (신규) 및 세션 토큰

자동 완성 (신규)은 HTTP 요청에 대한 응답으로 장소 예상 검색어 및 검색어 예상 검색어를 반환하는 웹 서비스입니다. 요청에서 검색 영역을 제어하는 텍스트 검색 문자열과 지역 경계를 지정합니다.

세션 토큰은 자동 완성 (신규) 호출을 세션으로 추적하는 사용자가 생성한 문자열입니다. 자동 완성 (신규)은 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 선택 단계를 결제 목적의 개별 세션으로 그룹화합니다.

새로운 필드, 속성, 접근성 옵션

Places API (신규)에는 사용자에게 장소에 관한 자세한 정보를 제공하는 새로운 필드, 속성, 접근성 옵션이 포함되어 있습니다. 이러한 측면은 다음 섹션에서 설명합니다.

필드

Places API (신규)에는 다음과 같은 몇 가지 새로운 필드가 포함되어 있습니다.

필드 설명
regularSecondaryOpeningHours 특정 작업의 특정 시간을 설명합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 시간 또는 배달 시간을 보조 시간으로 지정할 수 있습니다.
paymentOptions 장소에서 허용하는 결제 옵션입니다. 장소에서 2개 이상의 결제 옵션을 허용할 수 있습니다. 결제 옵션 데이터를 사용할 수 없는 경우 결제 옵션 필드가 설정되지 않습니다. 옵션은 다음과 같습니다.
  • 신용카드
  • 체크카드
  • 현금으로만 결제 가능
  • NFC 결제
parkingOptions 장소에서 제공하는 주차 옵션입니다. 옵션은 다음과 같습니다.
  • 무료 주차장
  • 유료 주차장
  • 무료 노상 주차
  • 발레파킹
  • 무료 주차장
  • 유료 주차장
subDestinations 특정 장소와 관련된 고유한 장소입니다. 예를 들어 공항 터미널은 공항의 하위 도착지로 간주됩니다.
fuelOptions 주유소에서 이용 가능한 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다. 다음과 같은 옵션이 있습니다.
  • Diesel
  • 일반 휘발유
  • 중급
  • 프리미엄
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • 메탄
  • 바이오디젤
  • 트럭 디젤
evChargeOptions 이 충전소의 전기자동차 (EV) 충전기 수입니다. 일부 전기자동차 충전기에는 커넥터가 여러 개 있지만 각 충전기는 한 번에 한 대의 차량만 충전할 수 있습니다. 따라서 이 필드는 특정 시점에 사용 가능한 전기자동차 충전기 수를 반영합니다.
shortFormattedAddress 사람이 읽을 수 있는 짧은 장소 주소입니다.
primaryType 주어진 결과의 기본 유형입니다. 예를 들어 장소는 cafe 또는 airport로 분류될 수 있습니다. 장소에는 기본 유형이 하나만 있을 수 있습니다. 가능한 값의 전체 목록은 지원되는 유형을 참고하세요.
primaryTypeDisplayName 기본 유형의 표시 이름으로, 해당하는 경우 요청 언어로 현지화됩니다. 가능한 값의 전체 목록은 지원되는 유형을 참고하세요.

속성

Places API (신규)에는 다음과 같은 몇 가지 새로운 속성이 포함되어 있습니다.

속성 설명
outdoorSeating 야외 좌석이 마련된 장소입니다.
liveMusic 라이브 음악을 제공하는 장소입니다.
menuForChildren 어린이 메뉴가 있습니다.
servesCocktails 칵테일을 제공하는 장소입니다.
servesDessert 디저트를 제공하는 장소입니다.
servesCoffee 커피를 제공하는 장소입니다.
goodForChildren 어린이에게 좋은 장소입니다.
allowsDogs 반려견 동반이 허용되는 장소입니다.
restroom 장소에 화장실이 있습니다.
goodForGroups 장소에서 그룹을 수용할 수 있습니다.
goodForWatchingSports 스포츠 경기를 시청하기에 적합한 장소입니다.

접근성 옵션

Places API (신규)에는 다음과 같은 접근성 옵션 필드가 포함됩니다.

필드 설명
wheelchairAccessibleParking 휠체어 이용 가능 주차장이 마련되어 있습니다.
wheelchairAccessibleEntrance 장소에 휠체어 이용 가능 입구가 있습니다.
wheelchairAccessibleRestroom 장소에 휠체어 이용 가능 화장실이 있습니다.
wheelchairAccessibleSeating 장소에 휠체어 이용 가능 좌석이 있습니다.

새 Places API로 이전

기존 Places API 고객이고 새 API를 사용하도록 앱을 이전하려면 다음 이전 문서를 참고하세요.