Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

AI Studio의 Google Maps Platform

Google AI Studio(AIS)에 Google Maps Platform을 통합하면 개발자가 대화형 지도, 실제 장소 데이터, 경로 기능이 포함된 AI 기반 웹 앱을 빠르게 프로토타입으로 제작하고 배포할 수 있습니다.

지도 데모 키 통합을 사용하면 Google Cloud 결제 계정을 만들거나 개발 컨텍스트를 벗어나지 않고도 AI Studio 내에서 바로 위치 인식 기능이 있는 AI 프로토타입을 생성할 수 있습니다. 이미 Google Cloud를 사용하고 있다면 결제 프로젝트를 연결하여 일일 데모 할당량 한도 없이 모든 Google Maps Platform 제품에 액세스하거나, 지도 데모 키로 시작하고 확장할 준비가 되면 프로젝트를 연결할 수 있습니다.

주요 특징

간편한 온보딩: Google Cloud를 처음 사용하든 이미 Cloud 프로젝트가 있든 관계없이 신용카드를 입력하거나 Google Cloud 콘솔을 탐색하지 않고도 AI Studio에서 바로 지도 데모 키를 가져올 수 있습니다.
자동 인텐트 감지: AI Studio는 주변 장소 검색, 대화형 지도 표시, 경로 계산과 같은 지리 공간 프롬프트를 식별하고 Google Maps Platform 추천 및 기술을 자동으로 구성합니다.
즉각적인 프로토타입 제작: 데모 사용자 인증 정보가 백그라운드에서 자동으로 프로비저닝되므로 AI 생성 코드가 즉시 실행됩니다.
원활한 확장: 앱을 확장할 준비가 되면 Cloud Billing 계정을 연결하거나 기존의 청구된 Cloud 프로젝트를 연결하여 할당량 제한을 삭제합니다.

시작 방법

AI Studio는 Google Maps Platform 사용자 인증 정보를 프로비저닝하고 앱의 보안 비밀 설정에 안전하게 저장합니다. 시작하는 방법은 Google Cloud를 처음 사용하는지 여부에 따라 다릅니다.

Google Cloud를 처음 사용하는 경우: AI Studio에서 시작할 수 있도록 무료 프로젝트와 지도 데모 키를 만듭니다.
기존 Google Cloud 사용자: 지도 데모 키(API 하위 집합 및 일일 할당량 한도 포함)를 사용하여 무료 프로토타입 제작을 선택하거나 기존 청구 Cloud 프로젝트를 연결하여 프로덕션 등급 할당량으로 전체 액세스 권한을 얻을 수 있습니다.

지도 데모 키에는 지도 데모 프로젝트 서비스 약관이 적용됩니다.

기능	새 사용자	기존 사용자(무료 프로토타입 제작)	기존 사용자(결제된 Cloud 프로젝트 연결)
사용자 인증 정보 유형	지도 데모 키	지도 데모 키	표준 Google Cloud API 키
결제 설정	신용카드나 Google Cloud 결제 계정이 필요하지 않음	신용카드나 Google Cloud 결제 계정이 필요하지 않음	Google Cloud Billing 계정이 있어야 합니다.
API 범위	다음을 포함한 모든 Google Maps Platform API(Route Optimization, Solar, Nav Connect 제외): Maps JavaScript API(장소 UI 키트 포함) Android용 Maps SDK 및 iOS Places API Routes API 및 Compute Routes Matrix Geocoding 및 Geolocation API Address Validation API Maps Static 및 스트리트 뷰 Static API Air Quality, Pollen, Weather API Aerial View API 지도 환경 상담사 도구	흔히 사용되는 프로토타입 제작 API(지원되는 기능 참고): Maps JavaScript API(장소 UI 키트 포함) Places API(사진 및 리뷰와 같은 사용자 제작 콘텐츠 제외) Routes API 및 Compute Routes Matrix Geocoding API Weather API 지도 환경 에이전트 도구	Google Maps Platform API 포트폴리오(Route Optimization, Solar, Nav Connect 포함) 100%
일일 한도	API당 하루 100회 호출	API당 하루 100회 호출	표준 할당량 및 월별 무료 사용량
키 제한사항	자동화된 인플로우 보안 비밀 관리	자동화된 인플로우 보안 비밀 관리	맞춤 HTTP 리퍼러, IP 또는 앱 제한사항
사용 의도	프로토타입 제작, 테스트, AI Studio 웹 앱	프로토타입 제작, 테스트, AI Studio 웹 앱	프로덕션 웹 및 모바일 앱
프로덕션 경로	Cloud Billing 계정을 프로젝트에 연결합니다. 키가 계속 작동합니다.	AI Studio에서 결제된 Cloud 프로젝트 연결	이미 프로덕션에 즉시 사용 가능

문제 해결 및 할당량

AI Studio를 통해 제공되는 데모 키는 대화형 개발 세션을 위해 설계된 일일 요청 한도에 따라 작동합니다. 일일 요청 한도는 API당 하루 100회 호출입니다.

할당량 초과 오류

데모 키를 사용하는 동안 앱에 RESOURCE_EXHAUSTED 또는 할당량 초과 오류가 표시되는 경우:

일일 재설정: 데모 키 할당량은 24시간마다 자동으로 재설정됩니다. 재설정 주기 후에 테스트를 재개할 수 있습니다.
표준 키 할당량 중복: 표준 API 키를 사용 중인데 데모 환경 제한을 언급하는 할당량 오류 메시지가 표시되면 Google Cloud 콘솔 할당량 페이지에서 프로젝트의 할당량 한도를 확인하세요.
더 많은 사용량을 위한 업그레이드: 프로토타입 제작 요구사항이 일일 데모 한도를 초과하는 경우 표준 Google Cloud 계정으로 업그레이드하여 전체 프로덕션 할당량을 잠금 해제하세요.

API를 사용할 수 없음 오류

지도 데모 키를 사용하여 프로토타입을 제작하는 기존 Google Cloud 사용자인 경우 API 키 제한 오류(예: Maps JavaScript API의 ApiTargetBlockedMapError)로 인해 요청이 실패하면 해당 키의 지원되는 API 목록에 API가 없는 것입니다. 사용하려면 결제된 Cloud 프로젝트를 연결하세요.

프로덕션 키로 업그레이드

앱이 프로덕션 준비가 되었거나 더 높은 할당량 한도가 필요한 경우 Google Cloud 콘솔에서 Cloud Billing 계정을 연결하여 프로젝트를 업그레이드하세요. 기존 데모 API 키는 계속 작동하므로 앱 코드를 업데이트할 필요가 없습니다.

이미 Cloud Billing 계정이 있는 경우 데모 키를 건너뛸 수도 있습니다. AI Studio에서 Google Maps Platform을 사용 설정할 때 결제된 Cloud 프로젝트 중 하나를 선택하면 처음부터 전체 API 범위와 표준 할당량이 포함된 표준 API 키를 받을 수 있습니다.