Places API(기존) 빠른 참조

2026년 10월부터는 새 Google Cloud 프로젝트에서 Places API(기존)를 더 이상 사용 설정할 수 없습니다. 기존 프로젝트는 계속해서 완벽하게 지원됩니다. 새로운 기능과 개선된 성능을 사용하려면 Places API(신규)로 이전하세요.

Places API(기존): 주요 정보

  • 제품: Places API(기존)
  • 다른 이름: Places API(기존 웹 서비스), Places API 웹 서비스(maps/api/place)
  • 카테고리: 장소
  • 플랫폼: 웹 서비스(REST)
  • 실행 위치: 서버(백엔드 코드)
  • 출시 단계: GA
  • 수명 주기: 기존
  • 대체: Places API(신규)
  • 개요: Places API(기존) 개요

Places API(기존): 사용 시기

다음과 같은 경우 Places API(기존)를 사용하세요.

  • 이미 Places API(기존)가 사용 설정되어 있고 maps.googleapis.com/maps/api/place 엔드포인트를 호출하는 기존 프로젝트를 유지합니다.
  • 마이그레이션하는 동안 기존 장소 검색, 주변 지역 검색, 텍스트 검색, 세부정보, 포토 또는 자동 완성(기존) 호출이 계속 작동해야 합니다.

다음과 같은 경우에는 Places API(기존)를 사용하지 마세요.

  • 새 Google Cloud 프로젝트를 시작합니다. 2026년 10월부터는 새 프로젝트에 Places API(기존)를 사용 설정할 수 없습니다. 대신 Places API(신규)를 사용하세요.
  • 주변 지역 검색 및 텍스트 검색에 새로운 기능, OAuth 인증 또는 필드 마스크가 필요하므로 요청한 필드에 대해서만 비용을 지불합니다. 대신 Places API(신규)를 사용하세요.
  • 새 코드에 장소 찾기(기존) 또는 검색어 자동 완성(기존)이 필요합니다. 텍스트 검색(신규) 및 자동 완성(신규)으로 대체됩니다. 대신 Places API(신규)를 사용하세요.

Places API(기존): 설정

Places API(기존): 일반적인 실수

  • 문제: 장소 세부정보(기존) 요청에서 fields 매개변수를 생략하거나 필드를 지정하지 않으면 API가 모든 필드를 반환하고 모든 필드에 대해 요금을 청구합니다. 해결 방법: 항상 fields 매개변수를 설정하거나 필드 마스크를 사용하여 장소 세부정보(신규)로 이전하세요. /maps/documentation/places/web-service/legacy/details를 참고하세요.
  • 문제: 주변 지역 검색(기존) 및 텍스트 검색(기존)은 반환할 필드를 지정하는 기능을 지원하지 않습니다. 항상 고정된 필드 집합(장소 세부정보 필드의 하위 집합)을 반환하고 Basic Data, Contact Data, Atmosphere Data SKU를 트리거합니다. 해결 방법: 필드 마스크를 사용하여 주변 검색(신규) 또는 텍스트 검색(신규)으로 이전하거나, fields 매개변수와 함께 장소 찾기(기존)를 사용하여 필요한 필드만 요청하고 비용을 지불합니다. /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku를 참고하세요.
  • 문제: photo_reference는 캐시할 수 없고 만료될 수 있으므로 저장된 참조가 작동하지 않습니다. 해결 방법: 사진을 요청하기 전에 장소 세부정보, 장소 찾기, 주변 지역 검색 또는 텍스트 검색 응답에서 새로운 photo_reference를 가져옵니다. /maps/documentation/places/web-service/legacy/photos를 참고하세요.
  • 문제: Places API(기존)가 사용 설정되지 않은 프로젝트에서 Places API(기존)를 호출하면 REQUEST_DENIED와 함께 '프로젝트에 사용 설정되지 않은 기존 API를 호출하고 있습니다…'라는 오류 메시지가 반환됩니다. LegacyApiNotActivatedMapError)를 사용하세요. 2026년 10월부터는 새 프로젝트에서 Places API(기존)를 사용 설정할 수 없습니다. 해결 방법: 새 프로젝트에 Places API(신규)를 사용하고 기존 앱을 이전합니다. 이전하는 동안 기존 페이지의 의견 양식을 통해 기존 API의 단기 활성화를 요청할 수 있습니다. /maps/legacy#LegacyApiNotActivatedMapError를 참고하세요.

Places API(기존): 기존 및 지원 중단된 기능

  • permanently_closed 응답 필드: 2020년 5월 26일부터 지원 중단됨 대체: business_status 필드. 이전 가이드를 참고하세요.
  • reference 응답 필드: 2019년 9월 3일부터 지원 중단되었습니다. 대체: place_id 필드. 이전 가이드를 참고하세요.
  • 주변 지역 검색(기존) name 요청 매개변수: 지원 중단됨. 대체: keyword 매개변수. 이전 가이드를 참고하세요.