새 장소 세부정보, 주변 검색, 텍스트 검색 API의 응답 형식이 기존 API의 형식에서 변경되었습니다. 주요 차이점은 응답 장소 객체 변경사항에 설명된 대로 각 메서드에서 반환하는 Place 객체의 형식입니다.
또한 응답 객체의 최상위 필드도 API마다 변경되었습니다. 다음을 참조하세요.
응답 장소 객체 변경사항
이 표에는 장소 세부정보 (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규) 응답의 새
Place 객체 변경사항이 기존
Place 객체와 비교하여 나와 있습니다.
새 응답 객체는 필드 이름에 케이멜케이싱을 사용하고, 새 필드를 포함하며, 기존 필드의 일부 이름을 바꿉니다.
| 필드 | 기존 장소 객체 | 새 장소 객체 | 참고 |
|---|---|---|---|
| 주소 구성요소 | address_components |
addressComponents |
|
| 장소 마이크로포맷 주소 | adr_address |
adrFormatAddress |
|
| 비즈니스 상태 | business_status |
businessStatus |
|
| 다음 주 영업시간 | current_opening_hours |
currentOpeningHours |
|
| 장소 요약 | editorial_summary |
editorialSummary |
|
| 형식이 지정된 주소 | formatted_address |
formattedAddress |
|
| 국가 전화번호 | formatted_phone_number |
nationalPhoneNumber |
|
| 위치 | geometry.location |
location |
|
| 표시 영역 | geometry.viewport |
viewport |
|
| 장소 기여 분석 | html_attributions |
attributions |
기존 API의 응답의 최상위 필드 |
| 아이콘 URL | icon |
삭제되었습니다. iconMaskBaseUri 및 iconBackgroundColor를 사용합니다. 자세한 내용은 장소 아이콘을 참고하세요. |
|
| 아이콘 배경 색상 | icon_background_color |
iconBackgroundColor |
|
| 아이콘 마스크 URL | icon_mask_base_uri |
iconMaskBaseUri |
|
| 국제 전화번호 | international_phone_number |
internationalPhoneNumber |
|
| 텍스트 장소 이름 | name |
displayName |
이제 텍스트 장소 이름에 displayName.text로, language에 displayName.languageCode로 액세스할 수 있습니다. |
| 영업시간 | opening_hours |
regularOpeningHours |
|
| 사진 | photos |
photos |
새 Place 객체에서 photos 형식이 변경되었습니다. 자세한 내용은 사진 참조 변경을 참고하세요. |
| 장소 ID | place_id |
id |
|
| Plus Code | plus_code |
plusCode |
|
| 가격 수준 | price_level |
priceLevel |
|
| 등급 | rating |
rating |
|
| 리뷰 | reviews |
reviews |
|
| 오늘부터 다음 주까지의 보조 영업시간(예외 및 기타 모든 데이터 포함) | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| 장소 유형 | types |
types |
|
| 장소의 Google 지도 URL | url |
googleMapsUri |
|
| 사용자 평점 수 | user_ratings_total |
userRatingCount |
|
| UTC 오프셋 | utc_offset |
utcOffsetMinutes |
|
| 도로명과 마을을 포함한 주소의 약어 | vicinity |
shortFormattedAddress |
|
| 장소 웹사이트 | website |
websiteUri |
|
| 휠체어 접근성 정보 | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance님이 이제 accessibilityOptions.wheelchairAccessibleEntrance에 있습니다. |
| 장소 속성 | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| 리소스 이름 | places/PLACE_ID 형식의 name 필드 |
기존 API에서 name 필드에는 장소 이름이 텍스트 문자열로 포함되었습니다. 새 API에서는 이 정보가 displayName에 있습니다. |
|
| 장소 기본 유형 | primaryTypeName |
신규 | |
| 기본 유형을 텍스트 문자열로 배치 | primaryTypeDisplayName |
신규 | |
| 예외 및 기타 모든 데이터를 포함한 정규 주간 보조 영업시간 | regularSecondaryOpeningHours |
신규 | |
| 장소에서 허용하는 결제 옵션 | paymentOptions |
신규 | |
| 장소 주차 옵션 | parkingOptions |
신규 | |
| 장소와 관련된 하위 도착 페이지 목록 | subDestinations |
신규 | |
| 주유소의 연료 옵션에 관한 최신 정보 | fuelOptions |
신규 | |
| 장소의 전기자동차 충전 정보 | evChargeOptions |
신규 | |
| 장소 속성 | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
신규 |
텍스트 검색 응답 변경사항
다음 표에는 기존 텍스트 검색의 응답 객체 및 텍스트 검색 (신규)의 응답 객체의 최상위 필드 변경사항이 나와 있습니다. 새 API의 경우 응답의 유일한 최상위 필드는 places 배열입니다.
| 필드 | 텍스트 검색 (기존) | 텍스트 검색(신규) | 참고 |
|---|---|---|---|
| 장소 기여 분석 | html_attributions |
각 장소의 새 장소 객체로 place.attributions로 이동 |
|
| 장소 배열 | 기존 장소 객체의 results 배열 |
새 장소 객체의 places 배열 |
|
| 요청 상태 | status |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동함 | |
| 오류 메시지 | error_message |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동함 | |
| 정보 메시지 | info_messages |
삭제됨 | |
| 페이지 토큰 | next_page_token |
삭제됨 |
주변 검색 응답 변경사항
다음 표에는 기존 주변 검색의 응답 객체 및 주변 검색 (신규)의 응답 객체의 최상위 필드 변경사항이 나와 있습니다. 새 API의 경우 응답의 유일한 최상위 필드는 places 배열입니다.
| 필드 | 주변 검색 (기존) | 주변 검색 (신규) | 참고 |
|---|---|---|---|
| 장소 기여 분석 | html_attributions |
각 장소의 새 장소 객체로 place.attributions로 이동 |
|
| 장소 배열 | 기존 장소 객체의 results 배열 |
새 장소 객체의 places 배열 |
|
| 요청 상태 | status |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동함 | |
| 오류 메시지 | error_message |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동함 | |
| 정보 메시지 | info_messages |
삭제됨 | |
| 페이지 토큰 | next_page_token |
삭제됨 |
장소 세부정보 응답 변경사항
다음 표에는 기존 장소 세부정보의 응답 객체 및 장소 세부정보 (신규)의 응답 객체의 최상위 필드 변경사항이 나와 있습니다. 새 API의 경우 응답의 유일한 최상위 필드는 places 배열입니다.
| 필드 | 장소 세부정보 (기존) | Place Details (신규) | 참고 |
|---|---|---|---|
| 장소 기여 분석 | html_attributions |
새 장소 객체로 attributions로 이동함 |
|
| 장소 세부정보 | 기존 장소 객체가 포함된 result |
새 장소 객체 | |
| 요청 상태 | status |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동함 | |
| 정보 메시지 | info_messages |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동함 |