Places API 응답 이전

유럽 경제 지역 (EEA) 개발자

소개

Place Details (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규) 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로 이동되었습니다.
장소 배열 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 삭제됨

장소 세부정보 (신규) 응답 변경사항

다음 표에는 Place Details (기존)의 응답 객체와 Place Details (신규)의 응답 객체에 관한 최상위 필드 변경사항이 나와 있습니다. 새 API의 경우 응답의 유일한 최상위 필드는 places 배열입니다.

필드 장소 세부정보 (기존) 장소 세부정보 (신규) 참고
장소 저작자 표시 html_attributions 새 장소 객체에 attributions로 이동되었습니다.
장소 세부정보 (신규) result 기존 장소 객체를 포함하는 새 장소 객체
요청 상태 status 표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동되었습니다.
정보 메시지 info_messages 표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동되었습니다.