Gdzie można zarządzać identyfikatorem klienta w konsoli Google Cloud
Funkcja zarządzania identyfikatorem klienta w abonamencie Premium jest dostępna w konsoli Cloud u dołu strony Dane logowania w Google Maps Platform, w sekcji Identyfikator klienta.
Dalsze zadania związane z zarządzaniem identyfikatorem klienta, takie jak autoryzacja URL i zarządzanie tajnym kluczem podpisywania identyfikatora klienta, znajdziesz na osobnej stronie identyfikatora klienta. Aby to zrobić, kliknij ikonę edycji po prawej stronie sekcji Identyfikator klienta.
Ważne: abonament Premium Google Maps Platform nie jest już dostępny dla nowych klientów ani rejestracji.
Upewnij się, że zespół ma dostęp do niezbędnych zasobów
Użyj konsoli Google Cloud
Dlaczego to ważne: Google Cloud Console zapewnia dostęp do informacji takich jak raporty o wykorzystaniu, kanały wiadomości i zasoby dla deweloperów. Co ważne, Cloud Console pozwala przesyłać zgłoszenia do zespołu pomocy Google Maps Platform, jeśli podczas programowania lub uruchamiania napotkasz problemy techniczne.
Przed premierą aplikacji włącz dostęp do Cloud Console wszystkim deweloperom odpowiedzialnym za jej konserwację. Jeśli napotkasz problemy techniczne, dostęp do Cloud Console pozwoli członkom Twojego zespołu na kontakt z zespołem pomocy, a nasz zespół pomocy będzie mógł skontaktować się z odpowiednimi osobami z Twojej organizacji. Zespół pomocy może na przykład skontaktować się z Twoją organizacją, jeśli wykryjemy nieprawidłowy ruch lub nietypowe zachowanie, które mogłoby doprowadzić do awarii Twojej aplikacji. Zapewnienie nam możliwości skontaktowania się z odpowiednimi programistami może pomóc w zapobieżeniu nieoczekiwanej przerwie w działaniu usługi.
Subskrybowanie grup e-mailowych z powiadomieniami
Dlaczego to ważne: aby być na bieżąco z zmianami i zmianami w interfejsach API Map Google, zalecamy zasubskrybowanie co najmniej jednej z tych grup e-mailowych:
- google-maps-platform-notifications – aktualności techniczne i informacje dotyczące usług internetowych i interfejsów API Google Maps Platform, powiadomienia o przerwach w działaniu usługi oraz ogłoszenia o nowych funkcjach platformy (około 3–5 wiadomości miesięcznie).
- google-maps-js-api-v3-notify – nowe wersje interfejsu Google Maps JavaScript API (ok. 4 wiadomości rocznie).
Optymalizacja aplikacji
Skonfiguruj zaporę sieciową, aby umożliwić dostęp do usług Google Maps Platform
Dlaczego to jest ważne: usługi Google Maps Platform korzystają z różnych domen, z których część nie należy do domeny *google.com. Jeśli znajdujesz się za restrykcyjną zaporą sieciową, musisz zezwolić na dostęp do domen używanych przez poszczególne usługi interfejsów API Map Google. Jeśli zapora sieciowa nie zezwala na dostęp do tych domen, żądania do interfejsu API będą kończyć się niepowodzeniem, co może spowodować awarię aplikacji. Zobacz pełną listę domen używanych przez interfejsy API Map Google.
Nie zalecamy zarządzania ograniczeniami zapory sieciowej według adresu IP, ponieważ adresy IP powiązane z tymi domenami nie są statyczne.
Uwaga: usługi Google Maps Platform używają portów 80 (http) i 443 (https) do obsługi ruchu przychodzącego i wychodzącego. Te usługi wymagają też żądań GET, POST, PUT, DELETE i HEAD. Skonfiguruj zaporę sieciową, aby zezwalała na ruch przez te porty i zezwalała na żądania w zależności od interfejsu API i przypadku użycia.
Autoryzuj domeny SSL do użycia z interfejsem Maps JavaScript API
Dlaczego to ważne: jeśli używasz interfejsu Maps JavaScript API z domeną SSL, koniecznie autoryzuj swoje domeny HTTPS, aby mieć pewność, że Twoje żądania nie zostaną odrzucone. Pamiętaj, że autoryzacja http://yourdomain.com nie włącza automatycznie jego odpowiednika SSL (https://yourdomain.com). Sprawdź listę autoryzowanych domen w konsoli Cloud, przewijając w dół do sekcji Identyfikator klienta. Aby rozwiązać problemy związane z używaniem interfejsów API po stronie klienta z domeną SSL, sprawdź, czy jakieś elementy strony są wczytywane przez HTTP. Wyświetl przewodnik na temat rozwiązywania problemów z autoryzacją.
Wybierz odpowiednią wersję interfejsu API
Dlaczego to ważne: przed programowaniem aplikacji warto wiedzieć, które wersje interfejsów API zostały wycofane. Wybór rozwiązania do niewycofanych wersji interfejsów API pozwoli Ci zaoszczędzić czas i pieniądze, gdy wycofane wersje staną się niedostępne.
W szczególności należy poznać schemat obsługi wersji używany przez interfejs Maps JavaScript API, aby uniknąć przypadkowego użycia niewłaściwej wersji API w swoim środowisku.
Na przykład eksperymentalne wersje interfejsu API mogą być odpowiednie w środowisku programistycznym lub testowym, ale zdecydowanie odradzamy stosowanie wersji eksperymentalnej w środowisku produkcyjnym. Nasza gwarancja jakości usług dotyczy tylko stabilnych wersji interfejsu API, dlatego w środowisku produkcyjnym należy używać tylko wersji stabilnych.
Zobacz przewodnik po wersjach interfejsu Maps JavaScript API.
Wybór między projektowaniem po stronie klienta lub po stronie serwera
Dlaczego to ważne: wybór podejścia po stronie klienta czy po stronie serwera to decyzja dotycząca architektury i ma absolutnie kluczowe znaczenie dla stabilności i skalowalności aplikacji. Ogólnie do przetwarzania rekordów w trybie offline (czyli poza Twoją aplikacją) powinno się stosować podejście po stronie serwera. W przypadku tych części aplikacji, które wchodzą w interakcje z użytkownikami (czyli przetwarzania ich żądań w czasie rzeczywistym), powinno być podejście po stronie klienta.
Główną przyczyną przekraczania limitów, a tym samym niedziałających aplikacji, jest wdrożenie po stronie serwera podejścia, które powinno być realizowane po stronie klienta. Zdecydowanie zalecamy zapoznanie się ze strategiami geokodowania przed projektowaniem lub uruchamianiem aplikacji, które korzystają z wywołań po stronie serwera.
Zoptymalizuj wykorzystanie limitu
Dlaczego to ważne: poznanie sposobu zużywania limitu przez aplikację (tzw. środki w interfejsach API Map Google) pomoże Ci zmniejszyć kwotę, jaką płacisz. Jeśli na przykład korzystasz z interfejsu Maps JavaScript API, aplikacja zużywa środki w interfejsie Maps API przy każdym wczytaniu mapy. Zapoznaj się z przewodnikiem dotyczącym wskaźników i limitów wykorzystania w abonamencie Premium.
Zarządzanie wykorzystaniem limitu usług internetowych
Przed uruchomieniem usługi ważne jest, aby zrozumieć różne błędy związane z limitami (na przykład OVER_QUERY_LIMIT, User Rate Limit
Exceeded) i skonfigurować odpowiednią logikę w aplikacji, aby móc reagować na takie błędy po przekroczeniu limitu. Zacznij od zapoznania się z najczęstszymi pytaniami o limity wykorzystania.
Informacje o kodach stanu zwracanych przez każdy interfejs API znajdziesz w przewodniku dla programistów dotyczącym tego interfejsu API. Odpowiednie informacje znajdziesz na przykład w przewodniku dotyczącym kodów stanu interfejsu Directions API.
Zrozumienie i wdrożenie tych pojęć znacznie zmniejsza ryzyko przekroczenia dozwolonego limitu, zablokowania aplikacji przez Google lub awarii.
Przeprowadzaj testy obciążenia swojej aplikacji
Dlaczego to ważne: przeprowadź testy obciążenia swojej aplikacji, aby mieć pewność, że będzie w stanie obsłużyć duże liczby żądań bez przekraczania limitów interfejsów API Map Google.
Chociaż Google Maps Platform może obsługiwać bardzo duży ruch, testowanie w działających usługach Google może sprawić, że aplikacja przekroczy dozwolony limit, co może spowodować zablokowanie jej przez Google. Odpowiadasz też za opłaty za korzystanie związane z testowaniem obciążenia.
Zamiast tego testując aplikację, należy upewnić się, że jest ona w stanie radzić sobie z dużą liczbą żądań bez przekraczania limitów interfejsów API Map Google i blokowania jej przez Google. Aby bezpiecznie osiągnąć ten cel, przeprowadź testy obciążenia za pomocą fałszywego (fałszywego) interfejsu API – usługi, która może przyjmować dużą liczbę żądań – i odpowiedz na żądania prawidłowymi odpowiedziami bez angażowania Google Maps Platform. Przykład: jeśli limit dla interfejsu Geocoding API wynosi 20 zapytań na sekundę, testowanie w aplikacji powinno sprawdzić, czy może ona obsłużyć 600 zapytań na sekundę bez wysyłania do Geocoding API więcej niż 20 zapytań na sekundę.
Jeśli planujesz przeprowadzenie poważnych testów obciążenia, skontaktuj się z zespołem pomocy Google, aby uzyskać wskazówki i upewnić się, że Google wie o planowanych testach.