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