새로운 장소 세부정보, 주변 검색, 텍스트 검색 API의 응답 형식이 기존 API의 형식에서 변경되었습니다. 주요 차이점은 응답 장소 객체 변경사항에 설명된 대로 각 메서드에서 반환하는 Place
객체의 형식입니다.
또한 API마다 응답 객체의 최상위 필드도 변경되었습니다. 참고:
응답 Place 객체 변경사항
이 표에서는 장소 세부정보 (신규), 주변 검색 (신규), 텍스트 검색 (신규)의 응답에서 새로운
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 |
신규 |
텍스트 검색 응답 변경사항
다음 표에서는 기존 텍스트 검색의 응답 객체와 텍스트 검색 (신규)의 응답 객체에서 최상위 필드에 변경된 사항을 보여줍니다. 새 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 (기존) | Place Details (New) | Notes |
---|---|---|---|
장소 저작자 표시 | html_attributions |
새 Place 객체로 attributions 이동됨 |
|
장소 세부정보 | 기존 Place 객체를 포함하는 result |
새로운 Place 객체 | |
요청 상태 | status |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동했습니다. | |
모든 정보 메시지 | info_messages |
표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동했습니다. |