Places API (신규)에는 다음과 같은 API가 포함되어 있습니다.
이 문서에는 이러한 새 API의 개요가 포함되어 있습니다.
Place Details (New)
장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도 장소 ID를 사용하면 특정 장소에 대한 세부정보를 요청할 수 있습니다. 장소 세부정보 (신규)를 시작하여 시설 또는 관심 장소에 대해 알릴 수 있습니다. 요청을 수행합니다. Place Details (New) 요청은 전체 주소, 전화번호, 사용자 평점 및 리뷰.
장소 ID를 가져오는 방법에는 여러 가지가 있습니다. 이 옵션은 다음과 같습니다.
장소 사진 (신규)
Place Photo (New) API를 사용하면 고화질 사진 콘텐츠를 추가할 수 있습니다. 애플리케이션에 저장된 수백만 장의 사진에 대한 액세스를 제공하여 Google 지역 정보 데이터베이스 Place Photo (New) API를 사용하여 애플리케이션에 맞게 최적의 크기로 이미지를 조정할 수 있습니다.
Place Photo (New) API에 대한 모든 요청에는 사진 리소스 이름, 는 반환할 사진을 고유하게 식별합니다. 사진 리소스를 얻을 수 있습니다. 사용하여 이름을 지정할 수 있습니다.
장소 세부정보 (신규)의 응답에 사진 리소스 이름을 포함하려면
텍스트 검색 (신규) 또는 주변 검색 (신규) 요청에 포함할 수 있도록
요청의 필드 마스크에 있는 photos 필드
텍스트 검색 (신규) 및 주변 검색 (신규)
Places API에는 다음 두 가지 검색 API가 포함되어 있습니다.
-
장소를 검색할 텍스트 문자열을 지정합니다. 예를 들면 다음과 같습니다. "호주 시드니의 매콤한 채식주의자 음식" 또는 '주변 고급 해산물 레스토랑' Palo Alto, CA').
가격 수준, 가격 책정, 가격 책정과 같은 세부정보를 지정하여 현재 영업 상태, 평점, 특정 장소 유형 등이 있습니다. 그 외에 를 사용하여 결과를 특정 위치로 편중하거나 검색 범위를 제한할 수 있습니다. 특정 위치로 이동합니다.
-
장소 유형 목록과 함께 검색할 지역을 지정할 수 있습니다. 위도와 경도로 정의된 원으로 지역을 지정합니다. 중심점의 좌표와 반경(미터)입니다.
장소의 특성을 정의하는 하나 이상의 장소 유형을 있습니다. 예를 들어 '
pizza_restaurant'를 지정합니다. 및 'shopping_mall' ~ 지정된 지역의 쇼핑몰에 있는 피자 식당을 검색 리전으로 나뉩니다
두 검색의 주요 차이점은 텍스트 검색 (신규)을 사용하면 임의 검색 문자열을 지정하는 반면 주변 검색 (신규)은 특정 검색 영역
자동 완성 (신규) 및 세션 토큰
자동 완성 (신규)은 장소 예상 검색어 및 검색어를 반환하는 웹 서비스입니다. HTTP 요청에 대한 응답으로 쿼리 예측을 수행합니다. 요청에서 텍스트 지정 검색 문자열과 검색 영역을 제어하는 지리적 경계가 포함됩니다.
세션 토큰은 자동 완성 (신규) 호출을 다음과 같이 추적하는 사용자 생성 문자열입니다. 세션. Autocomplete (신규)는 세션 토큰을 사용하여 쿼리를 그룹화하고 사용자 자동완성 검색의 선택 단계를 개별 세션으로 있습니다.
새로운 필드, 속성, 접근성 옵션
Places API (신규)에는 새로운 필드, 속성, 접근성 옵션이 추가되었습니다. 는 사용자에게 장소에 대한 자세한 정보를 제공합니다. 이러한 측면은 다음 섹션에 설명되어 있습니다.
필드
Places API (신규)에는 다음과 같은 새로운 필드가 몇 가지 추가되었습니다.
| 필드 | 설명 |
|---|---|
regularSecondaryOpeningHours |
특정 작업의 특정 시간을 설명합니다. 2차 영업시간은 비즈니스의 기본 영업시간과 다릅니다. 대상 예를 들어 음식점은 드라이브스루 시간 또는 배달을 지정할 수 있습니다. 시간을 보조 시간으로 선택합니다. |
paymentOptions |
장소에서 사용할 수 있는 결제 옵션입니다. 허용되는 장소 수에는
결제 옵션 1개가 있어야 합니다. 결제 옵션 데이터를 사용할 수 없는 경우
결제 옵션 필드가 설정되지 않습니다. 옵션은 다음과 같습니다.
|
parkingOptions |
장소에서 제공하는 주차 옵션입니다. 옵션은 다음과 같습니다.
|
subDestinations |
특정 장소와 관련된 고유한 장소 대상 예를 들어 공항 터미널은 공항에 있습니다. |
fuelOptions |
매장에서 구매할 수 있는 연료 옵션에 관한 최신 정보입니다.
주유소가 생겨났습니다. 이 정보는 정기적으로 업데이트됩니다. 옵션은 다음과 같습니다.
|
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 고객으로 앱을 이전하려는 경우 사용하려면 다음 이전 문서를 참고하세요.