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