Google AI Studio (AIS)의 Google Maps Platform 통합을 통해 개발자는 대화형 지도, 실제 장소 데이터, 라우팅 기능을 갖춘 AI 기반 웹 앱을 신속하게 프로토타입으로 제작하고 배포할 수 있습니다.
지도 데모 키 통합을 사용하면 Google Cloud 결제 계정을 만들거나 개발 컨텍스트를 벗어나지 않고도 AI Studio 내에서 직접 위치 인식 기능이 있는 AI 프로토타입을 생성할 수 있습니다.
주요 특징
- 원활한 온보딩: 신용카드를 입력하거나 Google Cloud 콘솔을 탐색하지 않고 AI Studio에서 직접 지도 데모 키를 받으세요.
- 자동 의도 감지: AI Studio는 지리 공간 프롬프트(예: 주변 장소 검색, 대화형 지도 표시, 경로 계산)를 식별하고 Google Maps Platform 추천 및 스킬을 자동으로 구성합니다.
- 즉각적인 프로토타입 제작: 데모 사용자 인증 정보가 백그라운드에서 자동으로 프로비저닝되므로 AI 생성 코드가 즉시 실행됩니다.
- 원활한 확장: 앱을 확장할 준비가 되면 Google Cloud 콘솔에서 계정을 업그레이드하여 할당량 제한을 삭제하세요.
데모 키와 표준 키의 차이점 이해
AI Studio에서 빌드할 때 프로젝트는 앱의 보안 비밀 설정에 안전하게 저장된 자동으로 프로비저닝된 지도 데모 키를 사용합니다.
| 기능 | 지도 데모 키 | 표준 Google Cloud API 키 |
|---|---|---|
| 결제 설정 | 신용카드 또는 Google Cloud 결제 계정이 필요하지 않습니다. | Google Cloud 결제 계정이 필요합니다. |
| API 적용 범위 | 모든 Google Maps Platform API (Route Optimization, Solar, Nav Connect 제외) | Google Maps Platform API 포트폴리오의 100% |
| 키 제한사항 | 자동화된 인플로 보안 비밀 관리 | 맞춤 HTTP 리퍼러, IP 또는 앱 제한사항 |
| 사용 의도 | 프로토타입 제작, 테스트, AI Studio 웹 앱 | 프로덕션 웹 및 모바일 앱 |
지원되는 API 및 기능
데모 키는 다음을 비롯한 거의 모든 Google Maps Platform API를 지원하여 신속한 프로토타입 제작을 지원합니다.
| 제품/API | 주요 기능 |
|---|---|
| Maps JavaScript API | 웹 앱에서 동적 대화형 지도, 마커, 정보 창을 렌더링합니다. |
| Android용 Maps SDK 및 iOS | 모바일 앱에 대화형 지도 및 위치 기능을 추가합니다. |
| Places API | 현지 장소를 검색하고 장소 세부정보, 사진, 사용자 평점, 리뷰를 가져옵니다. |
| Routes API 및 Compute Routes Matrix | 운전 및 도보 경로를 계산하고, 거리를 계산하고, 이동 시간을 추정합니다. |
| 지오코딩 및 Geolocation API | 주소를 좌표로 변환하고 휴대폰 또는 Wi-Fi를 사용하여 기기 위치를 삼각 측량합니다. |
| Address Validation API | 우편 데이터를 기반으로 실제 주소를 확인하고 구성요소의 형식을 지정합니다. |
| 지도 Static 및 스트리트 뷰 Static API | 정적 지도 이미지 또는 360도 거리 수준 파노라마를 삽입합니다. |
| 환경 API | 대기질, 꽃가루, 날씨 조건에 관한 실시간 데이터와 과거 데이터에 액세스합니다. |
| Aerial View API | 실제 위치의 몰입감 넘치는 시네마틱 3D 항공 동영상을 생성합니다. |
문제 해결 및 할당량
AI Studio를 통해 제공되는 데모 키는 대화형 개발 세션을 위해 설계된 일일 요청 한도에 따라 작동합니다. 일일 요청 한도는 API당 일일 100회 호출입니다.
할당량 초과 오류
데모 키를 사용하는 동안 앱에 RESOURCE_EXHAUSTED 또는 할당량 초과 오류가 표시되는 경우 다음 단계를 따르세요.
- 일일 재설정: 데모 키 할당량은 24시간마다 자동으로 재설정됩니다. 재설정 주기 후 테스트를 재개할 수 있습니다.
- 표준 키 할당량 중복: 표준 API 키를 사용하고 데모 환경 제한을 언급하는 할당량 오류 메시지가 표시되면 Google Cloud 콘솔 할당량 페이지에서 프로젝트의 할당량 한도를 확인하세요.
- 더 많은 볼륨을 위해 업그레이드: 프로토타입 제작에 필요한 볼륨이 일일 데모 한도를 초과하는 경우 표준 Google Cloud 계정으로 업그레이드하여 전체 프로덕션 할당량을 이용하세요.
프로덕션 키로 업그레이드
앱이 프로덕션 준비가 되었거나 할당량 한도를 높여야 하는 경우 Google Cloud 콘솔을 통해 계정을 업그레이드할 수 있습니다. 기존 데모 API 키는 계속 작동하므로 앱 코드를 업데이트할 필요가 없습니다.
유효한 결제 수단을 제공하여 계정을 업그레이드하세요.