새 Places API 정보

새 Places API에는 다음 API가 포함됩니다.

이 문서에서는 이러한 새 API를 간략하게 설명합니다.

장소 세부정보 API

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

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

Place Photo API

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

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

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

텍스트 검색 및 주변 검색

Places API에는 두 가지 검색 API가 있습니다.

  • 텍스트 검색 (신규)

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

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

  • 주변 검색 (신규)

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

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

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

Autocomplete API 및 세션 토큰

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

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

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

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 휠체어 이용가능 좌석이 마련되어 있습니다.

New Places API로 이전

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