소개
장소 세부정보 (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규) API의 응답 형식이 기존 API의 형식에서 변경되었습니다. 주요 차이점은 응답 장소 객체 변경사항에 설명된 대로 각 메서드에서 반환되는 Place 객체의 형식에 있습니다.
또한 각 API의 응답 객체의 최상위 필드도 변경되었습니다. 다음을 참조하세요.
응답 장소 객체 변경사항
이 표에서는 장소 세부정보 (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규)의 응답에 있는 새
Place 객체와 기존
Place 객체를 비교하여 변경사항을 보여줍니다.
새 응답 객체는 필드 이름에 카멜 표기법을 사용하고, 새 필드를 포함하며, 일부 기존 필드의 이름을 바꿉니다.
| 필드 | Places API (기존) 객체 | Places API (신규) 객체 | 참고 |
|---|---|---|---|
| 주소 구성요소 | 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로 이동 |
|
| 장소 배열 | 기존 Place 객체의 results 배열 |
새 장소 객체의 places 배열 |
|
| 요청 상태 | status |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동 | |
| 오류 메시지 | error_message |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동 | |
| 정보 메시지 | info_messages |
삭제됨 | |
| 페이지 토큰 | next_page_token |
삭제됨 |
주변 검색 응답 변경사항
다음 표에는 주변 지역 검색 (기존)의 응답 객체와 주변 지역 검색 (신규)의 응답 객체의 최상위 필드 변경사항이 나와 있습니다. 새 API의 경우 응답의 최상위 필드는 places 배열뿐입니다.
| 필드 | Nearby Search (기존) | 주변 검색 (신규) | 참고 |
|---|---|---|---|
| 장소 저작자 표시 | html_attributions |
각 장소의 새 장소 객체로 이동됨(place.attributions) |
|
| 장소 배열 | 기존 Place 객체의 results 배열 |
새 장소 객체의 places 배열 |
|
| 요청 상태 | status |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동 | |
| 오류 메시지 | error_message |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동 | |
| 정보 메시지 | info_messages |
삭제됨 | |
| 페이지 토큰 | next_page_token |
삭제됨 |
장소 세부정보 (신규) 응답 변경사항
다음 표에는 장소 세부정보 (기존)의 응답 객체와 장소 세부정보 (신규)의 응답 객체의 최상위 필드 변경사항이 나와 있습니다. 새 API의 경우 응답의 최상위 필드는 places 배열뿐입니다.
| 필드 | Place Details (Legacy) | 장소 세부정보 (신규) | 참고 |
|---|---|---|---|
| 장소 저작자 표시 | html_attributions |
새 장소 객체로 이동(attributions) |
|
| 장소 세부정보 (신규) | 기존 장소 객체를 포함하는 result |
새 장소 객체 | |
| 요청 상태 | status |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동 | |
| 정보 메시지 | info_messages |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동 |