Integracja Google Maps Platform w Google AI Studio (AIS) umożliwia deweloperom szybkie tworzenie prototypów i wdrażanie aplikacji internetowych opartych na AI, które zawierają interaktywne mapy, dane o miejscach w świecie rzeczywistym i funkcje wyznaczania trasy.
Dzięki integracji z kluczem demonstracyjnym Map możesz generować funkcjonalne prototypy AI z wykrywaniem lokalizacji bezpośrednio w AI Studio bez konieczności tworzenia konta rozliczeniowego Google Cloud czy opuszczania środowiska programistycznego. Jeśli korzystasz już z Google Cloud, możesz połączyć projekt z płatnościami, aby uzyskać dostęp do wszystkich usług Google Maps Platform bez dziennych limitów wersji demonstracyjnej, lub zacząć od klucza demonstracyjnego Map i połączyć projekt, gdy będziesz gotowy na skalowanie.
Najważniejsze funkcje
- Bezproblemowe rozpoczęcie korzystania: uzyskaj klucz demonstracyjny Map bezpośrednio w AI Studio bez podawania danych karty kredytowej i korzystania z konsoli Google Cloud, niezależnie od tego, czy dopiero zaczynasz korzystać z Google Cloud, czy masz już projekty Cloud.
- Automatyczne wykrywanie intencji: AI Studio identyfikuje prompty geoprzestrzenne (np. wyszukiwanie miejsc w pobliżu, wyświetlanie interaktywnych map lub obliczanie tras) i automatycznie konfiguruje rekomendacje oraz umiejętności Google Maps Platform.
- Błyskawiczne prototypowanie: dane logowania do wersji demonstracyjnej są automatycznie udostępniane za kulisami, dzięki czemu kod wygenerowany przez AI działa natychmiast.
- Płynne skalowanie: gdy aplikacja będzie gotowa do skalowania, połącz konto rozliczeniowe Cloud lub połącz istniejący projekt w chmurze, aby usunąć wszelkie ograniczenia dotyczące limitów.
Jak zacząć
AI Studio udostępnia dane logowania do Google Maps Platform i bezpiecznie przechowuje je w ustawieniach obiektów tajnych aplikacji. Sposób rozpoczęcia zależy od tego, czy dopiero zaczynasz korzystać z Google Cloud:
- Nowi użytkownicy Google Cloud: AI Studio tworzy bezpłatny projekt i klucz demonstracyjny Map, aby ułatwić Ci rozpoczęcie pracy.
- Dotychczasowi użytkownicy Google Cloud: możesz wybrać bezpłatne prototypowanie za pomocą klucza demonstracyjnego Map (z podzbiorem interfejsów API i dziennymi limitami) lub uzyskać pełny dostęp z limitami na poziomie produkcyjnym, łącząc istniejący rozliczany projekt w chmurze.
Klucze demonstracyjne Map podlegają Warunkom korzystania z usługi w ramach projektu demonstracyjnego Map.
| Funkcja | Nowy użytkownik | Obecny użytkownik (bezpłatne prototypowanie) | Dotychczasowy użytkownik (łączenie projektu w chmurze z płatnościami) |
|---|---|---|---|
| Typ danych logowania | klucz demonstracyjny Map | klucz demonstracyjny Map | Standardowy klucz interfejsu API Google Cloud |
| Konfiguracja płatności | Nie jest wymagana karta kredytowa ani konto rozliczeniowe Google Cloud. | Nie jest wymagana karta kredytowa ani konto rozliczeniowe Google Cloud. | Wymaga konta rozliczeniowego Cloud |
| Zakres interfejsu API |
Wszystkie interfejsy API Google Maps Platform (z wyjątkiem Route Optimization, Solar i Nav Connect), w tym:
|
Często używane interfejsy API do prototypowania (zobacz obsługiwane funkcje):
|
100% interfejsów API Google Maps Platform (w tym Route Optimization, Solar i Nav Connect) |
| Limity dzienne | 100 wywołań dziennie na interfejs API | 100 wywołań dziennie na interfejs API | Standardowe limity i miesięczne bezpłatne wykorzystanie |
| Ograniczenia klucza | Automatyczne zarządzanie obiektami tajnymi w przepływie | Automatyczne zarządzanie obiektami tajnymi w przepływie | Niestandardowe ograniczenia dotyczące odsyłającego adresu HTTP, adresu IP lub aplikacji |
| Zamiar użycia | Prototypowanie, testowanie i aplikacje internetowe AI Studio | Prototypowanie, testowanie i aplikacje internetowe AI Studio | produkcyjne aplikacje internetowe i mobilne, |
| Ścieżka do wersji produkcyjnej | Połącz konto rozliczeniowe Cloud z projektem. Klucz będzie nadal działać. | Łączenie rozliczanego projektu w chmurze w AI Studio | Gotowe do wykorzystania w środowisku produkcyjnym |
Rozwiązywanie problemów i limity
Klucze demonstracyjne udostępniane przez AI Studio działają w ramach dziennych limitów żądań, które zostały zaprojektowane z myślą o interaktywnych sesjach programistycznych. Dzienny limit żądań wynosi 100 wywołań dziennie na interfejs API.
Błędy przekroczenia limitu
Jeśli podczas korzystania z klucza demonstracyjnego aplikacja otrzyma błąd RESOURCE_EXHAUSTED lub błąd przekroczenia limitu:
- Codzienne resetowanie: limity kluczy demonstracyjnych są automatycznie resetowane co 24 godziny. Po zakończeniu cyklu resetowania możesz wznowić testowanie.
- Pokrywanie się limitów standardowego klucza: jeśli używasz standardowego klucza interfejsu API i wyświetla się komunikat o błędzie dotyczący limitu, który wspomina o ograniczeniach środowiska demonstracyjnego, sprawdź limity przydziału projektu na stronie Limitów w konsoli Google Cloud.
- Przejście na wyższy poziom: jeśli Twoje potrzeby związane z prototypowaniem przekraczają dzienne limity wersji demonstracyjnej, przejdź na standardowe konto Google Cloud, aby odblokować pełne limity produkcyjne.
Błędy związane z niedostępnością interfejsu API
Jeśli jesteś użytkownikiem Google Cloud i tworzysz prototypy za pomocą klucza demonstracyjnego Map, a żądanie nie powiedzie się z powodu błędu ograniczenia klucza interfejsu API (np. ApiTargetBlockedMapError w Maps JavaScript API), oznacza to, że interfejs API nie znajduje się na liście obsługiwanych interfejsów API dla tego klucza. Aby z niego korzystać, połącz projekt Cloud z rozliczeniami.
Przejście na klucz produkcyjny
Gdy aplikacja będzie gotowa do produkcji lub będzie wymagać wyższych limitów, połącz konto rozliczeniowe Cloud w konsoli Google Cloud, aby uaktualnić projekt. Dotychczasowy klucz interfejsu API wersji demonstracyjnej nadal działa, więc nie musisz aktualizować kodu aplikacji.
Jeśli masz już konto rozliczeniowe Cloud, możesz też pominąć klucz demonstracyjny: gdy włączysz Google Maps Platform w AI Studio, wybierz jeden ze swoich projektów w chmurze z włączonymi płatnościami, aby od razu uzyskać standardowy klucz interfejsu API z pełnym zakresem interfejsu API i standardowymi limitami.
Przydatne materiały
- Uzyskiwanie i używanie klucza demonstracyjnego Map
- Umiejętności agenta Google Maps Platform
- Maps Grounding Lite (MCP)
- Google Maps Platform Code Assist