소개
Places API (신규)에는 다음 API가 포함되어 있습니다.
이 문서에는 이러한 새로운 API의 개요가 포함되어 있습니다.
장소 세부정보 (신규)
장소 ID는 Google 장소 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 장소 ID를 사용하면 장소 세부정보 (신규) 요청을 시작하여 특정 시설 또는 관심 장소에 관한 세부정보를 요청할 수 있습니다. 장소 세부정보 (신규) 요청은 전체 주소, 전화번호, 사용자 평점, 리뷰 등 표시된 장소에 관한 포괄적인 정보를 반환합니다.
장소 ID를 가져오는 방법은 다양합니다. 다음과 같은 방법을 사용할 수 있습니다.
장소 사진 (신규)
Place Photos (신규)를 사용하면 Google 장소 데이터베이스에 저장된 수백만 장의 사진에 액세스하여 고품질 사진 콘텐츠를 애플리케이션에 추가할 수 있습니다. 장소 사진 (신규) API를 사용하면 사진에 액세스하고 이미지를 애플리케이션에 가장 적합한 크기로 조정할 수 있습니다.
Place Photos (신규) API에 대한 모든 요청에는 반환할 사진을 고유하게 식별하는 사진 리소스 이름이 포함되어야 합니다. 다음과 같은 방법을 사용하여 사진 리소스 이름을 가져올 수 있습니다.
장소 세부정보 (신규), 텍스트 검색 (신규) 또는 주변 지역 검색 (신규) 요청의 응답에 사진 리소스 이름을 포함하려면 요청의 필드 마스크에 photos 필드를 포함해야 합니다.
텍스트 검색 (신규) 및 주변 지역 검색 (신규)
Places API에는 다음 두 가지 검색 API가 포함되어 있습니다.
-
장소를 검색할 텍스트 문자열을 지정할 수 있습니다. 예: 'Spicy Vegetarian Food in Sydney, Australia' 또는 'Fine seafood dining near Palo Alto, CA'.
가격대, 현재 영업 상태, 평점 또는 특정 장소 유형과 같은 세부정보를 지정하여 검색을 세분화할 수 있습니다. 결과를 특정 위치로 편향시키거나 검색을 특정 위치로 제한하도록 지정할 수도 있습니다.
-
장소 유형 목록과 함께 검색할 지역을 지정할 수 있습니다. 중심점의 위도 및 경도 좌표와 반지름(미터)으로 정의된 원으로 지역을 지정합니다.
장소의 특성을 정의하는 하나 이상의 장소 유형을 지정합니다. 예를 들어 지정된 지역의 쇼핑몰에 있는 피자 레스토랑을 검색하려면 '
pizza_restaurant' 및 'shopping_mall'을 지정합니다.
두 검색의 주요 차이점은 텍스트 검색 (신규)을 사용하면 임의의 검색 문자열을 지정할 수 있는 반면 주변 지역 검색 (신규)에는 검색할 특정 영역이 필요하다는 것입니다.
자동 완성 (신규) 및 세션 토큰
자동 완성 (신규)은 HTTP 요청에 대한 응답으로 장소 예상 검색어 와 쿼리 예상 검색어를 반환하는 웹 서비스입니다. 요청에서 텍스트 검색 문자열과 검색 영역을 제어하는 지리적 경계를 지정합니다.
세션 토큰은 자동 완성 (신규) 호출을 세션으로 추적하는 사용자 생성 문자열입니다. 자동 완성 (신규)은 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 선택 단계를 결제 목적의 개별 세션으로 그룹화합니다.
새 필드, 속성, 접근성 옵션
Places API (신규)에는 장소에 관한 자세한 정보를 사용자에게 제공하기 위한 새로운 필드, 속성, 접근성 옵션이 포함되어 있습니다. 이러한 측면은 다음 섹션에서 설명합니다.
필드
Places API (신규)에는 다음과 같은 여러 가지 새로운 필드가 포함되어 있습니다.
| 필드 | 설명 |
|---|---|
regularSecondaryOpeningHours |
특정 작업의 특정 시간을 설명합니다. 보조 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 예를 들어 레스토랑은 드라이브 스루 영업시간 또는 배달 영업시간을 보조 영업시간으로 지정할 수 있습니다. |
paymentOptions |
장소에서 허용하는 결제 옵션입니다. 장소는 둘 이상의
결제 옵션을 허용할 수 있습니다. 결제 옵션 데이터를 사용할 수 없는 경우
결제 옵션 필드가 설정 해제됩니다. 옵션은 다음과 같습니다.
|
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 기반 요약을 사용할 수 있습니다.
- 장소 요약: 특정 장소와 관련된 짧은 개요 요약입니다.
- 리뷰 요약: 리뷰 작성자가 장소에 관해 작성한 내용을 이해하기 쉬운 요약입니다.
- 지역 요약: 주변 지역의 인기 있는 장소에 관한 개요를 제공합니다. 여기에는 동네 요약 및 EV 충전소 요약이 포함됩니다.
Google은 최신 사용 가능한 정보를 기반으로 요약이 최신 상태로 유지되도록 자주 요약을 재생성합니다. Places API (신규) 요청을 하면 앱에 최신 데이터가 표시됩니다.
새로운 Places API로 이전
기존 Places API (신규) 고객이며 새 API를 사용하도록 앱을 이전하려면 다음 이전 문서를 참고하세요.