Przegląd
Aby zwiększyć bezpieczeństwo i niezawodność uwierzytelniania, 26 maja 2025 r. wycofaliśmy identyfikatory klienta Maps Platform. Po 31 maja 2026 r. nie będzie można ich już używać.
Zamiast identyfikatora klienta musisz używać danych logowania klucza API, aby uwierzytelniać ruch w usłudze interfejsu API Map Google. Z tego przewodnika dowiesz się, jak przejść z używania identyfikatorów klienta na używanie kluczy interfejsu API.
Aby rozpocząć, wykonaj następujące czynności:
- Sprawdzanie bieżącego użycia identyfikatora klienta
- Przygotowywanie kluczy interfejsu API
- Sprawdzanie ustawień limitu
- Aktualizowanie kodu
- Monitorowanie ruchu z identyfikatora klienta
- Wstrzymywanie identyfikatora klienta
Sprawdzanie bieżącego wykorzystania identyfikatora klienta
Zanim rozpoczniesz proces migracji, podaj 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ło 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 wskaźników Google Maps.
Lista usług Google Maps Platform:
- W konsoli Cloud otwórz stronę Dane.
- Przefiltruj dane o wykorzystaniu, używając tych ustawień:
- Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
- Ustaw ten filtr.
- Pogrupowano 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:
- W konsoli Cloud otwórz stronę Dane.
- Wybierz z menu usługę Google Maps Platform.
- Przefiltruj dane o wykorzystaniu, używając tych ustawień:
- Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
- Ustaw ten filtr.
- Grupuj według: platformy lub domeny
- Powtórz czynności od kroku 2 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 Google Cloud, a użycie klucza interfejsu API z tego projektu zapewni Ci dostęp do tych samych funkcji, z których korzystałeś(-aś) wcześniej za pomocą identyfikatora klienta. Zalecamy przejście na powiązany projekt, aby uniknąć problemów z limitami lub brakującymi funkcjami.
- Znajdź projekt Cloud, z którym jest połączony Twój identyfikator klienta:
- Sprawdź, czy Twój projekt Cloud jest połączony z otwartym kontem rozliczeniowym.
- Utwórz nowy klucz interfejsu API na potrzeby migracji identyfikatora klienta.
- Możesz użyć dowolnych istniejących kluczy interfejsu API w projekcie w Cloud.
- Możesz używać wielu kluczy API z tego samego projektu w Cloud, np. aby rozdzielać ruch dla poszczególnych usług Google Maps Platform lub ruch z różnych platform (przeglądarki, aplikacji mobilnej itp.). Sprawdzone metody zarządzania kluczami interfejsu API znajdziesz w przewodniku po bezpieczeństwie.
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 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 z identyfikatora klienta do ograniczeń klucza interfejsu API. Listę zaufanych witryn odsyłających znajdziesz w konsoli Cloud.
Sprawdzanie ustawień limitu
Sprawdź, czy w projekcie Cloud masz oczekiwane ustawienia limitu. Musisz to zrobić 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 Google Maps.
Więcej informacji o raportach dotyczących limitów
Zwiększenie limitu usług po stronie klienta w interfejsie Maps JavaScript API
Jeśli korzystasz z tych usług w interfejsie Maps JavaScript API, po migracji klucza interfejsu API zobaczysz wzrost wykorzystania limitu.
Sprawdź bieżącą konfigurację limitu, obecne wykorzystanie i odpowiednio dostosuj limity.
- Sprawdź, czy używasz usług po stronie klienta interfejsu Maps JavaScript API z identyfikatorem klienta.
- W konsoli Cloud otwórz stronę Dane.
- Przefiltruj dane o wykorzystaniu, używając tych ustawień:
- Pogrupowano według: metody API
- Dane logowania: wybierz tylko „project_number:<identyfikator numeryczny>”.
- Następnie na wykresie „Natężenie ruchu według metody API” zobaczysz listę nazw metod wraz z natężeniem ruchu.
Metoda interfejsu API |
Usługa po stronie klienta |
Usługa do dostosowywania limitu |
google.routes.Directions.Javascript |
Usługa Directions |
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, z wyjątkiem google.places.Geocoding.Javascript |
biblioteka Miejsc |
Places API |
- Jeśli nie używasz tych metod interfejsu API, nie musisz się martwić ustawieniami limitu, ponieważ ruch z Twojego 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 potrzeby związane z limitem 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.
Aktualizowanie kodu
Zastąp parametr 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 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 interfejsu API. Klucze interfejsu API obsługują tylko wartości liczbowe parametru channel. Jeśli używasz identyfikatora klienta z wartościami nienumerycznymi w przypadku parametru kanału, zmień go na wartość numeryczną.
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. Usuwaj parametr podpisu tylko z żądań 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 interfejsów API zdjęć
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 tajny klucz podpisywania kluczem 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 Cloud Console. 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 negatywnego wpływu na działalność. Identyfikator klienta możesz wstrzymać w konsoli Cloud. Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania w abonamencie Premium.
Rozwiązywanie problemów
Jak 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 Google Cloud, 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 domenę do klucza interfejsu API.
OverQuotaMapError lub OVER_QUERY_LIMIT
Jeśli skonfigurowany limit nie wystarcza na pokrycie ruchu, zobaczysz ikonę OverQuotaMapError lub OVER_QUERY_LIMIT. Sprawdź sekcję „Sprawdź ustawienia limitu” 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, zmień w żądaniach interfejsu API „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"
}