Places API 응답 이전

새 장소 세부정보, 주변 검색, 및 텍스트 검색 API가 기존 API의 형식에서 변경되었습니다. 주요 차이점은 다음에 설명된 대로 각 메서드에서 반환하는 Place 객체의 형식 응답 장소 객체 변경

또한 응답 객체의 최상위 필드에도 확인할 수 있습니다 참고:

응답 Place 객체 변경사항

이 표는 새 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 photos의 형식이 Place 객체. 자세한 내용은 사진 참조로 변경
장소 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 객체로 place.attributions 이동됨
장소 배열 기존 Place 객체의 results 배열 새 Place 객체의 places 배열
요청 상태 status 표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동했습니다.
오류 메시지 error_message 표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동했습니다.
모든 정보 메시지 info_messages 삭제됨
페이지 토큰 next_page_token 삭제됨

주변 검색 응답 변경사항

다음 표에서는 응답의 최상위 필드 관련 변경사항을 보여줍니다. 객체 기존 주변 검색과 응답 객체 주변 검색 (신규)용. 새 API의 경우 응답은 places 배열입니다.

필드 주변 검색 (기존) 주변 검색 (신규) 참고
장소 저작자 표시 html_attributions 새 Place로 이전함 각 장소에 대한 객체를 place.attributions로 표시
장소 배열 기존 Place 객체의 results 배열 places 새 Place 객체
요청 상태 status 표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동했습니다.
오류 메시지 error_message 표준 HTTP 응답 (HTTP 응답 코드 및 메시지)으로 이동했습니다.
모든 정보 메시지 info_messages 삭제됨
페이지 토큰 next_page_token 삭제됨

장소 세부정보 응답 변경사항

다음 표에서는 응답의 최상위 필드 관련 변경사항을 보여줍니다. 객체 (기존 장소 세부정보 및 응답) 객체 를 사용하세요. 새 API의 경우 응답은 places 배열입니다.

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