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

주변 검색 응답 변경사항

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

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

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

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

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