Przewodnik po migracji identyfikatorów klienta

Przegląd

Aby rozpocząć, wykonaj te czynności:

  1. Sprawdź bieżące wykorzystanie identyfikatora klienta
  2. Przygotuj klucze interfejsu API
  3. Sprawdź ustawienia limitów
  4. Zaktualizuj kod
  5. Monitoruj ruch związany z identyfikatorem klienta
  6. Wstrzymaj identyfikator klienta
  7. Tymczasowa reaktywacja identyfikatora klienta w ramach samoobsługi

Sprawdzanie bieżącego wykorzystania identyfikatora klienta

Zanim rozpoczniesz proces migracji, przygotuj te informacje:

  • Usługi 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 Cloud Console możesz sprawdzić najnowszy stan wykorzystania identyfikatora klienta na stronie Statystyki Map Google

Aby wyświetlić listę usług Maps Platform:

  1. W Cloud Console otwórz stronę Statystyki.
  2. Przefiltruj wykorzystanie za pomocą tych ustawień:
    • Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
  3. Ustaw ten filtr:
    • Pogrupowano według: interfejsu API

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

Cloud Console 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 Cloud Console otwórz stronę Statystyki.
  2. W menu wybierz usługę Maps Platform.
  3. Przefiltruj wykorzystanie za pomocą tych ustawień:
    • Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
  4. Ustaw ten filtr:
    • Grupuj według: platformy lub domeny
  5. Powtórz kroki od 2 do 5 dla każdej usługi Maps Platform, w przypadku której chcesz sprawdzić ruch.

Przygotowywanie kluczy interfejsu API

Wszystkie identyfikatory klienta są powiązane z projektem w chmurze Google Cloud, a użycie klucza interfejsu API z tego projektu zapewni Ci dostęp do tych samych funkcji, do których wcześniej uzyskiwał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 Cloud, z którym jest powiązany Twój identyfikator klienta:
  2. Sprawdź, czy Twój projekt Cloud 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 istniejących kluczy interfejsu API w projekcie Cloud.
    • Możesz używać wielu kluczy interfejsu API z tego samego projektu Cloud, np. aby oddzielić ruch dla każdej usługi Maps Platform lub oddzielić ruch z różnych platform (przeglądarki, aplikacji mobilnej itp.). Więcej informacji o sprawdzonych metodach zarządzania kluczami interfejsu API znajdziesz w przewodniku dotyczącym bezpieczeństwa.

Zabezpieczanie klucza interfejsu API

Zabezpiecz 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 interfejsu API dla klucza interfejsu API.

Więcej informacji znajdziesz w przewodniku dotyczącym bezpieczeństwa Google Maps Platform.

W przypadku interfejsów Maps JavaScript API, Maps Static API i Street View Static API możesz przenieść zaufane odsyłacze z identyfikatora klienta do ograniczeń klucza interfejsu API. Listę zaufanych odsyłaczy znajdziesz w Cloud Console.

Sprawdzanie ustawień limitów

Sprawdź, czy w projekcie Cloud masz ustawienia limitów, których oczekujesz. Musisz to zrobić tylko wtedy, gdy wywołujesz usługi po stronie klienta Maps JavaScript API z identyfikatora klienta. Ustawienia limitów możesz sprawdzić i dostosować na stronie Limity Map Google.

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

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

Jeśli używasz tych usług w Maps JavaScript API, po migracji na klucz interfejsu API zobaczysz wzrost wykorzystania limitu.

Sprawdź bieżącą konfigurację limitu i bieżące wykorzystanie, a następnie odpowiednio dostosuj limity.

  1. Sprawdź, czy używasz usług po stronie klienta Maps JavaScript API z identyfikatorem klienta.
    • W Cloud Console otwórz stronę Statystyki.
    • Przefiltruj wykorzystanie za pomocą tych ustawień:
      • Pogrupowano według: metody API
      • Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
    • Następnie na wykresie „Ruch według metody API” zobaczysz listę nazw metod i ich ruchu.

Metoda interfejsu API

Usługa po stronie klienta

Usługa, w której należy dostosować limit

google.routes.Directions.Javascript

Usługa wyznaczania trasy

Directions API

google.routes.DistanceMatrix.Javascript

Usługa macierzy odległości

Distance Matrix API

google.maps.Elevation.Javascript

Usługa wysokości

Elevation API

google.places.Geocoding.Javascript

Usługa geokodowania

Geocoding API

google.places.*.Javascript, inne niż google.places.Geocoding.Javascript

Biblioteka Miejsc

Places API
  • Jeśli nie używasz tych metod interfejsu API, nie musisz się martwić ustawieniami limitów, ponieważ ruch związany z identyfikatorem klienta już zużywa limit projektu.
  • Oszacuj wykorzystanie limitu identyfikatora klienta.
    • W przypadku każdej usługi sprawdź zarówno dokładność na sekundę, jak i na dzień.
    • Wykres na sekundę: pomnóż szczytowy ruch przez 60, aby uzyskać dodatkowy limit na minutę.
    • Wykres na dzień: szczytowy ruch powinien być dodatkowym limitem na dzień.
  • Dostosuj limit w odpowiednich usługach Maps Platform.
    • Na podstawie nazwy metody, którą znajdziesz w kroku 1, dostosuj limit w odpowiednich usługach.

Aktualizowanie kodu

Zastąpienie parametru klienta parametrem klucza

Zaktualizuj dane logowania 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 używały protokołu HTTPS.

Aktualizowanie parametru kanału na potrzeby raportowania

Możesz śledzić wykorzystanie według kanałów, określając parametr kanału w żądaniach interfejsu API. Klucze interfejsu API obsługują tylko wartości liczbowe parametru kanału. Jeśli używasz identyfikatora klienta z wartościami nieliczbowymi parametru kanału, zaktualizuj go do wartości liczbowej.

Więcej informacji znajdziesz w artykule 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ń parametr podpisu tylko z żądań interfejsu API.

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

Więcej informacji znajdziesz w artykule Omówienie planu Premium.

Tajny klucz podpisywania w przypadku interfejsów API obrazów

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

Monitorowanie ruchu związanego z identyfikatorem klienta

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

Wstrzymywanie identyfikatora klienta

Zdecydowanie zalecamy deweloperom wstrzymanie identyfikatorów klienta po migracji. Ma to na celu ochronę danych logowania przed niezamierzonym 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ść. Identyfikator klienta możesz wstrzymać w Cloud Console. Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania w planie Premium.

Tymczasowa reaktywacja identyfikatora klienta w ramach samoobsługi

W maju 2026 r. identyfikatory klienta Google Maps Platform weszły w okres stopniowego wycofywania, dlatego dostępność usługi nie jest już gwarantowana. W ramach zaplanowanego procesu wyłączania usługi dostęp będzie okresowo ograniczany. Usługa jest zwykle przywracana automatycznie w ciągu kilku godzin, ale jeśli wymagane jest natychmiastowe przywrócenie, możesz ręcznie reaktywować dostęp.

Aby pilnie przywrócić dostęp, możesz samodzielnie reaktywować usługę w konsoli Google Cloud:

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

Jeśli nie możesz szybko przejść na klucze interfejsu API i chcesz tymczasowo wyłączyć dalsze przerwy, 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 działalność

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

Sprawdzanie raportów rozliczeniowych zamiast statystyk projektu może być przydatne dla użytkowników, którzy nie mają dostępu do statystyk projektu, np. administratorów rozliczeń (zwłaszcza partnerów Maps Platform). Raporty rozliczeniowe mają opóźnienie 1–2 dni, ale pokazują statystyki wykorzystania i koszty 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, tylko dla partnerów) Zastosuj filtr, aby wybrać odpowiednie podrzędne konto rozliczeniowe.
  3. Pogrupuj dane raportu według klucza etykiety goog-maps-api-key-suffix. Ta etykieta wyświetla ostatnie znaki klucza interfejsu API.
  4. Zidentyfikuj ruch związany z identyfikatorem klienta, szukając wpisów, w których brakuje etykiety goog-maps-api-key-suffix lub jest ona pusta, ponieważ ta etykieta nie jest wypełniana w przypadku żądań identyfikatora klienta.
  5. Zignoruj kody SKU, które nie powinny być powiązane z żądaniami interfejsu API, np. kody SKU subskrypcji.

Rozwiązywanie problemów

Jak sprawdzić, czy żądanie kończy się niepowodzeniem?

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

Błąd ApiNotActivatedMapError lub REQUEST_DENIED

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

Błąd RefererNotAllowedMapError

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

Błąd OverQuotaMapError lub OVER_QUERY_LIMIT

Jeśli skonfigurowany limit jest niewystarczający, aby pokryć ruch, zobaczysz błąd OverQuotaMapError lub OVER_QUERY_LIMIT. Zapoznaj się z sekcją „Sprawdzanie ustawień 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 otrzymasz ten komunikat o błędzie, zaktualizuj żądania 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"
}