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ń limitów
4. Aktualizowanie kodu
5. Monitorowanie ruchu związanego z identyfikatorem klienta
6. Wstrzymywanie identyfikatora klienta
7. Tymczasowa samodzielna reaktywacja identyfikatora klienta

Sprawdzanie bieżącego użycia identyfikatora klienta

Zanim rozpoczniesz proces migracji, przygotuj te informacje:

• usługi Maps Platform, z którymi używasz 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 Map Google.

Lista usług Maps Platform:

1. W konsoli Cloud otwórz stronę Wskaźniki.
2. Filtruj wykorzystanie za pomocą tych ustawień:
   • Dane logowania: wybierz tylko „project_number:<numerical identifier>”.
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 usługę Maps Platform z menu.
3. Filtruj wykorzystanie za pomocą tych ustawień:
   • Dane logowania: wybierz tylko „project_number:<numerical identifier>”.
4. Ustaw ten filtr.
   • Grupuj według: platforma lub domena
5. Powtórz czynności od kroku 2 dla każdej usługi 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 istniejących 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 interfejsu 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 strony odsyłające z identyfikatora klienta do ograniczeń klucza interfejsu API. Listę zaufanych stron odsyłających znajdziesz w konsoli Cloud.

Sprawdzanie ustawień limitów

Sprawdź, czy w projekcie w chmurze masz oczekiwane ustawienia limitów. Tę czynność musisz wykonać tylko wtedy, gdy wywołujesz usługi po stronie klienta interfejsu Maps JavaScript API z 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 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 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 konsoli Cloud otwórz stronę Wskaźniki.
   • 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 interfejsu API” zobaczysz listę nazw metod wraz z informacjami o ruchu.

• Jeśli nie używasz tych metod interfejsu API, nie musisz się martwić o ustawienia limitów, ponieważ ruch związany z identyfikatorem klienta już wykorzystuje limit projektu.
• Szacowanie wykorzystania limitu identyfikatorów klienta
  • W przypadku każdej usługi sprawdź szczegółowość na sekundę i na dzień.
  • Wykres na sekundę: pomnóż szczytowy ruch przez 60, aby uzyskać dodatkowy limit na minutę.
  • Wykres dzienny: szczytowe natężenie ruchu powinno odpowiadać dodatkowemu dziennemu limitowi.
• Dostosuj limit w odpowiednich usługach Maps Platform.
  • Na podstawie nazwy metody znalezionej w kroku 1 dostosuj limity 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 API GMP. 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 do interfejsu API. Klucze interfejsu API obsługują tylko wartości liczbowe parametru kanału. Jeśli używasz identyfikatora klienta z dowolnymi wartościami nienumerycznymi w parametrze kanału, zmień je na obsługiwane wartości numeryczne.

Więcej informacji znajdziesz w artykule dotyczącym raportowania 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.

Podpisywanie obiektu tajnego dla interfejsów Imagery API

Maps Static API i Street View Static API nadal wymagają parametru podpisu. W celach testowych akceptują niewielką liczbę żądań bez podpisu, ale gdy zostanie przekroczony próg w środowisku produkcyjnym, zaczynają się niepowodzenia. Zastąp tajny klucz podpisywania dla identyfikatora klienta kluczem dla klucza 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ł pomyślnie przeniesiony, korzystając z paneli konsoli Cloud. Zauważysz spadek ruchu związanego z identyfikatorem klienta, który jest wyświetlany w formacie „project_number:123456” w panelu, gdy grupujesz według danych logowania.

Wstrzymywanie identyfikatora klienta

Zdecydowanie zalecamy deweloperom wstrzymanie identyfikatorów klienta po migracji. Ma to na celu ochronę Twoich danych logowania przed niezamierzonym ruchem i potwierdzenie, że pozostałe przypadki użycia Twojego identyfikatora klienta nie są krytyczne (np.testowanie, pamięć podręczna, boty itp.) i mogą zwracać błędy bez wpływu na działalność firmy. 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

W maju 2026 r. rozpoczęliśmy proces wycofywania identyfikatorów klienta Google Maps Platform, dlatego nie możemy już zagwarantować dostępności usługi. Dostęp będzie okresowo ograniczany w ramach zaplanowanego procesu wyłączania usługi. Zwykle usługa jest przywracana automatycznie w ciągu kilku godzin, ale jeśli potrzebujesz natychmiastowego przywrócenia dostępu, możesz go reaktywować ręcznie.

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

• Przejdź na stronę danych logowania Google Maps Platform.
• Znajdź swój projekt w chmurze połączony z Twoim identyfikatorem klienta.
• Aby przywrócić usługę, kliknij ikonę wyłączenia wstrzymania po prawej stronie wpisu.

Jeśli nie możesz szybko przejść na klucze interfejsu API i chcesz tymczasowo uniknąć dalszych przerw w działaniu, 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 rozliczeniowych zamiast danych projektu może być przydatne dla użytkowników, którzy nie mają dostępu do danych projektu, np. administratorów rozliczeń (zwłaszcza partnerów Google Maps Platform). Chociaż raporty rozliczeniowe mają opóźnienie wynoszące 1–2 dni, ich zaletą jest to, że pokazują statystyki dotyczące wykorzystania i kosztów z okresu dłuższego niż 30 dni.

Aby monitorować użycie identyfikatora klienta w konsoli Google Cloud, wykonaj 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 subkonto rozliczeniowe.
3. Grupuj dane do raportu według klucza etykiety goog-maps-api-key-suffix. Ta etykieta wyświetla końcowe 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ż nie jest ona wypełniana w przypadku żądań identyfikatora klienta.
5. Ignoruj kody SKU, które nie powinny być powiązane 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.

Błąd 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, pojawi się błąd RefererNotAllowedMapError. Sprawdź sekcję „Zabezpiecz klucz interfejsu API” i dodaj swoją domenę do klucza interfejsu API.

Błąd OverQuotaMapError lub OVER_QUERY_LIMIT

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 „Żądania do tego interfejsu API muszą być wysyłane przez SSL”

Jeśli pojawi się ten komunikat o błędzie, zmień żą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"
}