소개
Places API (신규)에는 다음 API가 포함됩니다.
이 문서에는 이러한 새 API에 대한 개요가 포함되어 있습니다.
Place Details (신규)
장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 장소 ID를 사용하면 장소 세부정보 (신규) 요청을 시작하여 특정 시설 또는 관심 장소에 관한 세부정보를 요청할 수 있습니다. 장소 세부정보 (신규) 요청은 전체 주소, 전화번호, 사용자 평점, 리뷰 등 지정된 장소에 관한 포괄적인 정보를 반환합니다.
장소 ID를 가져오는 방법에는 여러 가지가 있습니다. 이 옵션은 다음과 같습니다.
장소 사진 (신규)
장소 사진 (신규)을 사용하면 Google 장소 데이터베이스에 저장된 수백만 장의 사진에 액세스하여 애플리케이션에 고품질 사진 콘텐츠를 추가할 수 있습니다. Place Photos (New) API를 사용하면 사진에 액세스하고 이미지를 애플리케이션에 가장 적합한 크기로 조정할 수 있습니다.
Place Photos (New) API에 대한 모든 요청에는 반환할 사진을 고유하게 식별하는 사진 리소스 이름이 포함되어야 합니다. 다음을 사용하여 사진 리소스 이름을 가져올 수 있습니다.
Place Details (신규), Text Search (신규) 또는 Nearby Search (신규) 요청의 응답에 사진 리소스 이름을 포함하려면 요청의 필드 마스크에 photos 필드를 포함해야 합니다.
텍스트 검색 (신규) 및 주변 검색 (신규)
Places API에는 다음 두 가지 검색 API가 포함됩니다.
-
장소를 검색할 텍스트 문자열을 지정할 수 있습니다. 예: '오스트레일리아 시드니의 매운 채식 음식' 또는 '캘리포니아 팔로 알토 근처의 고급 해산물 식당'
가격 수준, 현재 영업 상태, 평점, 특정 장소 유형과 같은 세부정보를 지정하여 검색을 세분화할 수 있습니다. 결과를 특정 위치에 편향되도록 지정하거나 검색을 특정 위치로 제한할 수도 있습니다.
-
장소 유형 목록과 함께 검색할 지역을 지정할 수 있습니다. 중심점의 위도 및 경도 좌표와 반지름(미터)으로 정의된 원으로 지역을 지정합니다.
장소의 특성을 정의하는 장소 유형을 하나 이상 지정합니다. 예를 들어 '
pizza_restaurant' 및 'shopping_mall'을 지정하여 지정된 지역의 쇼핑몰에 위치한 피자 레스토랑을 검색합니다.
두 검색의 주요 차이점은 텍스트 검색 (신규)을 사용하면 임의의 검색 문자열을 지정할 수 있지만 주변 검색 (신규)을 사용하려면 검색할 특정 영역이 필요하다는 점입니다.
자동 완성 (신규) 및 세션 토큰
자동 완성 (신규)은 HTTP 요청에 대한 응답으로 장소 예상 검색어 및 검색어 예상 검색어를 반환하는 웹 서비스입니다. 요청에서 텍스트 검색 문자열과 검색 지역을 제어하는 지리적 경계를 지정합니다.
세션 토큰은 자동 완성 (신규) 호출을 세션으로 추적하는 사용자가 생성한 문자열입니다. 자동 완성 (신규)은 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 선택 단계를 결제 목적의 개별 세션으로 그룹화합니다.
새로운 필드, 속성, 접근성 옵션
Places API (신규)에는 사용자에게 장소에 관한 자세한 정보를 제공하는 새로운 필드, 속성, 접근성 옵션이 포함되어 있습니다. 이러한 측면은 다음 섹션에서 설명합니다.
필드
Places API (신규)에는 다음과 같은 몇 가지 새로운 필드가 포함되어 있습니다.
| 필드 | 설명 |
|---|---|
regularSecondaryOpeningHours |
특정 작업의 특정 시간을 설명합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 음식점은 드라이브 스루 시간 또는 배달 시간을 보조 시간으로 지정할 수 있습니다. |
paymentOptions |
장소에서 허용하는 결제 옵션 장소에서 2개 이상의 결제 옵션을 허용할 수 있습니다. 결제 옵션 데이터를 사용할 수 없는 경우 결제 옵션 필드가 설정되지 않습니다. 옵션은 다음과 같습니다.
|
parkingOptions |
장소에서 제공하는 주차 옵션입니다. 옵션은 다음과 같습니다.
|
subDestinations |
특정 장소와 관련된 고유한 장소입니다. 예를 들어 공항 터미널은 공항의 하위 도착지로 간주됩니다. |
fuelOptions |
주유소에서 제공되는 연료 옵션에 관한 최신 정보입니다. 이 정보는 정기적으로 업데이트됩니다. 다음과 같은 옵션이 있습니다.
|
evChargeOptions |
이 충전소의 전기자동차 (EV) 충전기 수입니다. 일부 EV 충전기에는 커넥터가 여러 개 있지만 각 충전기는 한 번에 한 대의 차량만 충전할 수 있습니다. 따라서 이 필드는 특정 시점에 사용 가능한 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 |
장소에 휠체어 이용 가능 좌석이 있습니다. |
AI 기반 요약
Places API (신규) AI 기반 요약은 Gemini 모델 기능을 사용하여 사용자가 어디로 갈지 결정하는 데 도움이 되는 장소 및 지역에 관한 요약을 반환합니다.
AI 기반 요약은 다양한 입력의 데이터를 종합하여 사용자가 장소에 대한 정보를 바탕으로 더 나은 결정을 내릴 수 있도록 지원합니다. 예를 들어 새로운 음식점을 이용해 보려고 할 때 AI 기반 요약을 통해 일반적인 메뉴의 하이라이트가 표시되거나 분위기를 파악할 수 있으며 사용자 리뷰에서 테마를 추출할 수 있습니다. 새로운 도시를 방문하는 경우 AI 기반 요약을 통해 주변 명소와 편의시설을 간략하게 살펴볼 수 있습니다.
Places API에 AI 기반 기능이 추가됨 (신규)
AI 기반 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 검색 (신규)에서 지원됩니다. Places API (신규) 응답에서 다음과 같은 AI 기반 요약을 사용할 수 있습니다.
- 장소 요약: 특정 장소와 관련된 짧은 개요 요약입니다.
- 리뷰 요약: 리뷰 작성자가 장소에 대해 작성한 내용을 요약하여 한눈에 볼 수 있도록 제공합니다.
- 지역 요약: 주변 지역의 인기 장소와 주변 장소에 대한 개요를 제공합니다. 여기에는 주변 환경 요약 및 전기자동차 충전소 요약이 포함됩니다.
Google은 사용 가능한 최신 정보를 바탕으로 이러한 요약을 자주 재생성하여 최신 상태를 유지합니다. Places API (신규) 요청을 하면 앱에 최신 데이터가 표시됩니다.
새 Places API로 이전
기존 Places API (신규) 고객이며 새 API를 사용하도록 앱을 이전하려면 다음 이전 문서를 참고하세요.