Przewodnik po migracji identyfikatorów klienta

Przegląd

Aby rozpocząć, wykonaj następujące czynności:

1. Sprawdzanie bieżącego użycia identyfikatora klienta
2. Przygotowywanie kluczy interfejsu API
3. Sprawdzanie ustawień limitu
4. Aktualizowanie kodu
5. Monitorowanie ruchu związanego z identyfikatorem klienta
6. Wstrzymywanie identyfikatora klienta
7. Samodzielna tymczasowa reaktywacja identyfikatora klienta

Sprawdzanie bieżącego wykorzystania identyfikatora klienta

Zanim rozpoczniesz proces migracji, przygotuj te informacje:

• Usługi Google Maps Platform, z których korzystasz za pomocą identyfikatora klienta.
• Aplikacje, witryny lub systemy, w których używasz identyfikatora klienta.

W maju 2025 r. Google wysłał do klientów, których dotyczy ten problem, e-maila z powiadomieniem o wycofaniu identyfikatora klienta. Te informacje znajdziesz też w e-mailu z powiadomieniem.

W konsoli Cloud możesz sprawdzić najnowszy stan wykorzystania identyfikatora klienta na stronie danych Google Maps.

Lista usług Google Maps Platform:

1. W konsoli Cloud otwórz stronę Wskaźniki.
2. Filtruj wykorzystanie, korzystając z tych ustawień:
   • Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
3. Ustaw ten filtr.
   • Grupowanie według: interfejs API

Wskazówki dotyczące aplikacji, witryn lub systemów:

Konsola Cloud nie wyświetla szczegółów aplikacji, witryn ani systemów. Możesz jednak znaleźć pewne wskazówki dotyczące źródeł ruchu związanego z identyfikatorem klienta. Wykonaj te czynności:

1. W konsoli Cloud otwórz stronę Wskaźniki.
2. Wybierz z menu usługę Maps Platform.
3. Filtruj wykorzystanie, korzystając z tych ustawień:
   • Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
4. Ustaw ten filtr.
   • Grupuj według: platformy lub domeny
5. Powtórz czynności od kroku 2 w przypadku każdej usługi Google Maps Platform, w której chcesz sprawdzić ruch.

Przygotowywanie kluczy interfejsu API

Wszystkie identyfikatory klienta są powiązane z projektem Google Cloud, a użycie klucza interfejsu API z tego projektu zapewni Ci dostęp do tych samych funkcji, do których wcześniej miałeś dostęp za pomocą identyfikatora klienta. Zalecamy migrację do powiązanego projektu, aby uniknąć problemów z limitami lub brakującymi funkcjami.

1. Znajdź projekt w chmurze, z którym jest połączony Twój identyfikator klienta:
   • Najczęstsze pytania dotyczące migracji portalu
2. Sprawdź, czy Twój projekt w chmurze jest połączony z otwartym kontem rozliczeniowym.
3. Utwórz nowy klucz interfejsu API na potrzeby migracji identyfikatora klienta.
   • Możesz ponownie użyć dowolnych kluczy interfejsu API w projekcie w chmurze.
   • Możesz używać wielu kluczy interfejsu API z tego samego projektu w chmurze, na przykład do rozdzielania ruchu w poszczególnych usługach Maps Platform lub do rozdzielania ruchu z różnych platform (przeglądarki, aplikacji mobilnej itp.). Sprawdzone metody zarządzania kluczami interfejsu API znajdziesz w przewodniku po zabezpieczeniach.

Zabezpiecz klucz interfejsu API

Pamiętaj, aby zabezpieczyć klucz interfejsu API, aby chronić go przed nieautoryzowanym dostępem.

• Ustaw ograniczenie aplikacji dla klucza interfejsu API (np. witryny, adresy IP, aplikacje na Androida lub aplikacje na iOS).
• Ustaw ograniczenia interfejsów API dla klucza interfejsu API.

Więcej informacji znajdziesz we wskazówkach dotyczących bezpieczeństwa Google Maps Platform.

W przypadku interfejsów Maps JavaScript API, Maps Static API i Street View Static API możesz przenieść zaufane witryny odsyłające w identyfikatorze klienta do ograniczeń klucza interfejsu API. Listę zaufanych odsyłających znajdziesz w konsoli Cloud.

Sprawdź ustawienia limitów

Sprawdź, czy w projekcie w chmurze masz oczekiwane ustawienia limitu. Tę czynność musisz wykonać tylko wtedy, gdy wywołujesz usługi po stronie klienta interfejsu Maps JavaScript API za pomocą identyfikatora klienta. Ustawienia limitów możesz sprawdzić i dostosować na stronie limitów Map Google.

Więcej informacji o raportach dotyczących wykorzystania limitów

Zwiększenie limitu dla usług po stronie klienta w Maps JavaScript API

Jeśli korzystasz z tych usług w Maps JavaScript API, po migracji klucza interfejsu API zauważysz wzrost wykorzystania limitu.

Sprawdź bieżącą konfigurację limitów i obecne wykorzystanie, a następnie odpowiednio dostosuj limity.

1. Sprawdź, czy używasz usług po stronie klienta interfejsu Maps JavaScript API z identyfikatorem klienta.
   • W konsoli Cloud otwórz stronę Dane.
   • Filtruj wykorzystanie za pomocą tych ustawień:
     • Grupowanie według: metoda interfejsu API
     • Dane logowania: wybierz tylko „project_number:<numerical identifier>”.
   • Następnie na wykresie „Ruch według metody API” zobaczysz listę nazw metod wraz z ruchem.

• Jeśli nie używasz tych metod interfejsu API, nie musisz się martwić ustawieniami limitu, ponieważ ruch z identyfikatora klienta już wykorzystuje limit projektu.
• Szacowanie wykorzystania limitu identyfikatora klienta
  • W przypadku każdej usługi sprawdź szczegółowość danych w sekundach i w dniach.
  • Wykres na sekundę: pomnóż szczytowy ruch przez 60, aby uzyskać dodatkowe limity na minutę.
  • Wykres dzienny: szczytowy ruch powinien odpowiadać dodatkowemu limitowi dziennemu.
• Dostosuj limit w odpowiednich usługach Google Maps Platform.
  • Na podstawie nazwy metody znalezionej w kroku 1 dostosuj limit w odpowiednich usługach.

Zaktualizuj kod

Zastąp parametr klienta parametrem klucza

Zaktualizuj dane uwierzytelniające z URL&client={value} na URL&key={value} w wychodzących wywołaniach interfejsu GMP API. Jeśli Twoje aplikacje używają protokołu HTTP do uzyskiwania dostępu do usług GMP, zaktualizuj je, aby korzystały z protokołu HTTPS.

Aktualizowanie parametru kanału na potrzeby raportowania

Możesz śledzić wykorzystanie poszczególnych kanałów, określając parametr kanału w żądaniach do interfejsu API. Klucze interfejsu API obsługują tylko wartości liczbowe w przypadku parametru channel. Jeśli używasz identyfikatora klienta z wartościami nienumerycznymi w przypadku parametru kanału, zmień go na obsługiwaną wartość numeryczną.

Więcej informacji znajdziesz w sekcji Raportowanie w Google Maps Platform.

Usuwanie parametru podpisu w przypadku usług internetowych

W przypadku tych interfejsów API usług internetowych parametr podpisu nie jest potrzebny, gdy uzyskujesz do nich dostęp za pomocą klucza interfejsu API. Usuń tylko parametr podpisu z żądań do interfejsu API.

• Directions API (starsza wersja)
• Distance Matrix API (starsza wersja)
• Geocoding API
• Elevation API
• Time Zone API

Więcej informacji znajdziesz w omówieniu abonamentu Premium.

Klucz tajny podpisywania dla interfejsów Imagery API

Interfejsy Maps Static API i Street View Static API nadal wymagają parametru podpisu. Akceptują niewielką liczbę żądań bez podpisu na potrzeby testowania, ale gdy w środowisku produkcyjnym zostanie osiągnięty próg, zaczną zwracać błędy. Zastąp klucz tajny podpisywania dla identyfikatora klienta kluczem tajnym dla klucza interfejsu API. Możesz użyć tego samego algorytmu podpisywania, ale musisz użyć innego klucza tajnego podpisywania. Więcej informacji znajdziesz w artykule Używanie podpisu cyfrowego.

Monitorowanie ruchu generowanego przez identyfikator klienta

Po wdrożeniu sprawdź, czy ruch został prawidłowo przeniesiony, korzystając z paneli w konsoli Cloud. Zaczniesz zauważać spadek ruchu związanego z identyfikatorem klienta, który na panelu w przypadku grupowania według danych logowania jest wyświetlany w formacie „project_number:123456”.

Wstrzymywanie identyfikatora klienta

Zdecydowanie zalecamy deweloperom wstrzymanie identyfikatorów klienta po migracji. Ma to na celu ochronę Twoich danych logowania przed niepożądanym ruchem i potwierdzenie, że pozostałe wykorzystanie identyfikatora klienta nie jest krytyczne (np.testowanie, pamięć podręczna, boty itp.) i może zwracać błędy bez wpływu na działalność. Możesz wstrzymać identyfikator klienta w konsoli Cloud. Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania w abonamencie Premium.

Tymczasowa samodzielna reaktywacja identyfikatora klienta

Identyfikatory klienta Google Maps Platform weszły w okres stopniowego wycofywania w maju 2026 r., więc dostępność usługi nie jest już gwarantowana. Dostęp będzie okresowo ograniczany w ramach zaplanowanego procesu wyłączania usługi. Usługa jest zwykle przywracana automatycznie w ciągu kilku godzin, ale w razie potrzeby możesz ręcznie reaktywować dostęp.

Aby szybko przywrócić dostęp, możesz samodzielnie reaktywować konto w konsoli Google Cloud:

• Otwórz stronę danych logowania do Google Maps Platform.
• Znajdź konkretny projekt w chmurze połączony z identyfikatorem klienta.
• Aby przywrócić usługę, kliknij ikonę wznawiania po prawej stronie wpisu.

Jeśli nie możesz szybko przeprowadzić migracji na klucze interfejsu API i chcesz tymczasowo uzyskać zwolnienie z dalszych przerw w działaniu usługi, skontaktuj się z zespołem pomocy Google Maps Platform i podaj te informacje:

• Identyfikator klienta
• Konkretny przypadek użycia
• Docelowa data migracji
• Ocena wpływu na firmę

Raport dotyczący wykorzystania identyfikatora klienta – z raportów rozliczeniowych

Sprawdzanie raportów dotyczących płatności zamiast danych projektu może być przydatne dla użytkowników, którzy nie mają dostępu do danych projektu, np. administratorów płatności (zwłaszcza partnerów platformy Google Maps). Raporty rozliczeniowe mają opóźnienie wynoszące 1–2 dni, ale pokazują dane o wykorzystaniu i kosztach z okresu dłuższego niż 30 dni.

Wykorzystanie identyfikatora klienta możesz monitorować w konsoli Google Cloud, wykonując te czynności:

1. W konsoli Google Cloud otwórz stronę Płatności > Raporty.
2. (Opcjonalnie, dotyczy tylko partnerów) Zastosuj filtr, aby wybrać odpowiednie konto rozliczeniowe podrzędne.
3. Pogrupuj dane do raportu według klucza etykiety goog-maps-api-key-suffix. Ta etykieta wyświetla ostatnie znaki klucza interfejsu API.
4. Aby zidentyfikować ruch związany z identyfikatorem klienta, wyszukaj wpisy, w których brakuje etykiety goog-maps-api-key-suffix lub jest ona pusta, ponieważ w przypadku żądań dotyczących identyfikatora klienta ta etykieta nie jest wypełniana.
5. Ignoruj kody SKU, które nie są przeznaczone do powiązania z żądaniami do interfejsu API, np. kody SKU subskrypcji.

Rozwiązywanie problemów

Jak możemy sprawdzić, czy nasze żądanie się nie powiodło?

Statystyki błędów możesz sprawdzić na wykresach kodów odpowiedzi.

ApiNotActivatedMapError lub REQUEST_DENIED

Jeśli nie włączysz usługi w projekcie w chmurze, zobaczysz błąd ApiNotActivatedMapError lub REQUEST_DENIED. Postępuj zgodnie z instrukcjami, aby włączyć usługę.

RefererNotAllowedMapError błąd

Jeśli domena źródłowa nie została dodana do klucza interfejsu API, zobaczysz błąd RefererNotAllowedMapError. Zapoznaj się z sekcją „Zabezpiecz klucz interfejsu API” i dodaj swoją domenę do klucza interfejsu API.

OverQuotaMapError lub OVER_QUERY_LIMIT błąd

Jeśli skonfigurowany limit nie wystarcza do obsłużenia ruchu, zobaczysz błąd OverQuotaMapError lub OVER_QUERY_LIMIT. Sprawdź sekcję „Sprawdź ustawienia limitów” i odpowiednio dostosuj limit.

Błąd „Requests to this API must be over SSL” (Żądania do tego interfejsu API muszą być przesyłane przez SSL)

Jeśli pojawi się ten komunikat o błędzie, zaktualizuj żądania do interfejsu API z „http://” na „https://”.

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}