Najczęstsze pytania dotyczące Google Maps Platform

Pierwsze kroki

Warunki korzystania z usługi

Limity wykorzystania i rozliczenia

Korzystanie z Google Maps Platform

Błędy i rozwiązywanie problemów

Usługi Google Maps Platform

Maps JavaScript API

Google Maps SDK na iOS

Google Maps SDK na Androida

Podpisywanie URL

Pierwsze kroki

Czym jest Google Maps Platform?

Google Maps Platform to zestaw interfejsów API i pakietów SDK, które umożliwiają deweloperom umieszczanie Map Google w aplikacjach mobilnych i na stronach internetowych oraz pobieranie danych z Map Google. Dostępnych jest kilka usług. W zależności od potrzeb możesz używać jednego z tych interfejsów API lub ich kombinacji:

Mapy:

Trasy:

Miejsca:

Środowisko:

Jak zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki z Google Maps Platform.

Jakiego interfejsu API potrzebuję?

Aby znaleźć odpowiedni interfejs API na podstawie wymagań funkcjonalnych, skorzystaj z selektora interfejsu API.

Jak zacząć korzystać z interfejsów API w mojej witrynie?

Zapoznaj się z ogólnymi informacjami, przewodnikami dla programistów i przewodnikami na temat interesującego Cię interfejsu API lub pakietu SDK. Zapoznaj się na przykład z przewodnikami dotyczącymi pakietu Maps SDK na Androida lub interfejsu Maps JavaScript API.

W których krajach działa Google Maps Platform?

Zespół Map Google stale udostępnia nowe dane map i poszerza zasięg na świecie. Najbardziej aktualne informacje o zasięgu znajdziesz w danych dotyczących zasięgu w Mapach Google. Dane możesz filtrować za pomocą pola filtra u góry strony. Dane dotyczące zasięgu mogą się zmienić, jeśli umowy licencyjne z dostawcami danych ulegną zmianie.

Zobacz też:

Czy mogę umieścić Mapy Google w swojej witrynie bez korzystania z usług Google Maps Platform?

Tak. Mapy Google umożliwiają teraz umieszczanie mapy, którą wyświetlasz, na swojej stronie lub blogu bez konieczności programowania ani korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.

Jak dostarczać aplikacje Map na urządzenia mobilne?

Aby włączyć mapy w aplikacji na Androida, użyj pakietu Maps SDK na Androida.

Aby włączyć mapy w aplikacji na iOS, użyj pakietu Maps SDK na iOS.

Interfejs Maps JavaScript API został opracowany z myślą o urządzeniach mobilnych i jest odpowiedni dla aplikacji przeglądarkowych kierowanych zarówno na komputery, jak i urządzenia z przeglądarką internetową z pełną implementacją JavaScriptu, np. iPhone firmy Apple.

W przypadku aplikacji kierowanych na urządzenia, które nie nadają się do korzystania z interfejsu Maps JavaScript API, interfejs Maps Static API dostarcza obrazów map w formatach GIF, JPG i PNG, w tym znaczników i polilinii. Pamiętaj, że korzystanie z interfejsu Maps Static API poza aplikacjami działającymi w przeglądarce wymaga połączenia obrazu mapy z Mapami Google.

W jakich przeglądarkach interfejsy Maps JavaScript API i Maps Embed API są obsługiwane?

Interfejsy Maps JavaScript API i Maps Embed API obsługują te przeglądarki:

Komputer
  • aktualna wersja przeglądarki Microsoft Edge (Windows), z wyjątkiem trybu IE;
  • 2 najnowsze główne stabilne wersje Firefoxa (Windows, macOS, Linux).
  • 2 najnowsze główne stabilne wersje Chrome (Windows, macOS, Linux).
  • 2 ostatnie główne stabilne wersje Safari (macOS).
Android
  • Aktualna wersja Chrome na Androidzie w wersji 4.1 lub nowszej.
  • WebView w Chrome na Androida w wersji 4.4 lub nowszej.
iOS
  • przeglądarka Safari na urządzeniach mobilnych w aktualnej i poprzedniej głównej wersji iOS.
  • UIWebView i WKWebView w bieżącej i poprzedniej głównej wersji iOS.
  • Aktualna wersja Chrome na iOS.
Czy mogę drukować mapy z interfejsu Maps JavaScript API?

Drukowanie z interfejsu Maps JavaScript API nie jest obsługiwane. Dzieje się tak, ponieważ obsługa drukowania jest niejednolita w przypadku najczęściej używanych przeglądarek.

Jak mogę otrzymywać powiadomienia o zmianach w usługach Google Maps Platform?

Zasubskrybuj blog Google Maps Platform, aby otrzymywać informacje o różnych ofertach Google Geo dla programistów.

Jak skontaktować się z zespołem pomocy technicznej?

Informacje o dostępnych opcjach pomocy znajdziesz w artykule Pomoc i zasoby Google Maps Platform.

Kiedy dostępny jest zespół pomocy technicznej?
Zespół pomocy jest dostępny przez całą dobę 5 dni w tygodniu (od poniedziałku do piątku od 9:00 czasu tokijskiego do 17:00 czasu pacyficznego), z wyjątkiem dni świątecznych w danym regionie.
Jak mogę odzyskać dostęp do mojego konta Google?

Jeśli utraciłeś(-aś) dostęp do konta Google (np. jan.kowalski@mojafirma.com lub jan.kowalski@gmail.com), możesz spróbować przywrócić dostęp do konta, odzyskując lub resetując hasło. Otwórz artykuł Jak odzyskać konto Google lub Gmail w Pomocy dotyczącej konta Google.

Jak mogę odzyskać dostęp do konkretnego projektu?

Jeśli utracisz dostęp do projektu, w którym zarządzasz implementacją Google Maps Platform, możesz spróbować go odzyskać.

Jeśli masz dostęp do konta Google powiązanego z projektem:

Jeśli nie masz dostępu do konta Google powiązanego z projektem:

Czy mogę używać pakietu SDK Map i Miejsc na iOS na komputerach Mac z procesorami ARM?

Programowanie na nowych Macach z procesorami Arm jest możliwe, ale wymaga kompilowania i uruchamiania na fizycznym urządzeniu z iOS. Jest to tymczasowe ograniczenie, które ma na celu umożliwienie nam dodania większego wsparcia dla programowania na symulatorach.

Warunki korzystania z usługi

Jakie są warunki korzystania z usług Google Maps Platform?

Warunki korzystania z Google Maps Platform są dostępne pod adresem:

https://cloud.google.com/maps-platform/terms

Czy moja witryna spełnia warunki korzystania z Google Maps Platform?

Platformy Google Maps możesz używać w swoich aplikacjach, o ile Twoja witryna spełnia Warunki korzystania z usługi Google Maps Platform.

Są jednak sposoby korzystania z Google Maps Platform, których nie chcemy tolerować. Na przykład mapy, które wskazują miejsca, w których można kupić narkotyki, lub inne nielegalne działania. Szanujemy też prywatność użytkowników, dlatego Mapy Google nie mogą być wykorzystywane do identyfikowania prywatnych informacji o osobach.

Zanim zaczniesz tworzyć i wprowadzać aplikację, powinnaś/powinieneś skorzystać z usług prawnika, aby ustalić, czy aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform. Inżynierowie Google mogą oferować tylko pomoc techniczną i nie są uprawnieni do udzielania porad prawnych. Google zastrzega sobie prawo do zawieszenia lub zakończenia korzystania z usługi w dowolnym momencie, dlatego uważnie przeczytaj Warunki korzystania z interfejsów API Map Google.

Czy mogę uzyskać bezpośredni dostęp do elementów mapy i zdjęć satelitarnych?

Nie możesz uzyskiwać dostępu do elementów mapy ani zdjęć satelitarnych za pomocą żadnego mechanizmu oprócz platformy Mapy Google (np. tworzenie własnego interfejsu API mapowania lub użycie skryptu do zbiorczego pobierania elementów mapy). Dostęp aplikacji do płytek zostanie zablokowany, jeśli aplikacja będzie do nich uzyskiwać dostęp poza Google Maps Platform. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform.

Czy mogę używać usług Google Maps Platform do śledzenia aplikacji?

Nie ma żadnych ograniczeń dotyczących wyświetlania danych w czasie rzeczywistym (śledzenia) w usługach Google Maps Platform, o ile aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Czy mogę korzystać z Map Google w aplikacji niebędącej aplikacją internetową?

Tak, usług Google Maps Platform można teraz używać w aplikacjach niebędących aplikacjami internetowymi, pod warunkiem że są one zgodne z innymi ograniczeniami określonymi w Warunkach korzystania z usługi Google Maps Platform.

Interfejs Maps JavaScript API jest obsługiwany tylko w jednej z  obsługiwanych przeglądarek.

Czy mogę używać usług Google Maps Platform w witrynie chronionej hasłem?

Tak, Mapy Google, Trasy, Miejsca i Środowisko mogą być używane w przypadku aplikacji z prywatnym dostępem. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform.

Czy mogę utworzyć aplikację, która zawiera dane z Platformy Map Google w dokumencie?

Jeśli aplikacja wygeneruje dokument w formie elektronicznej lub wydrukowanej, nie może on zawierać żadnych danych z Platformy Map Google, w tym obrazów. Więcej informacji znajdziesz w sekcji „Brak zautomatyzowanego pozyskiwania danych” w Warunkach korzystania z Google Maps Platform.

Jak mogę zrezygnować z umieszczania swoich treści w wynikach wyszukiwania Google?

Nie zbieramy już tych danych. Używanie parametru indexing zostało wycofane i nie ma żadnego wpływu. Nie musisz już wyraźnie rezygnować z tej usługi, ale zachęcamy do jak najszybszego usunięcia tego parametru.

Aby usunąć stronę lub witrynę z wyników wyszukiwania, postępuj zgodnie z  instrukcjami podanymi w Centrum pomocy.

Czy mogę wygenerować obraz mapy za pomocą interfejsu Maps Static API, który przechowuję i wyświetlam w swojej witrynie?

Nie możesz przechowywać i przesyłać kopii obrazów wygenerowanych za pomocą interfejsu Maps Static API w swojej witrynie. Wszystkie strony internetowe, które wymagają obrazów statycznych, muszą zawierać link do atrybutu src tagu HTML img lub atrybutu CSS background-image tagu HTML div bezpośrednio do interfejsu Maps Static API, aby wszystkie obrazy map wyświetlały się w treści HTML strony internetowej i były udostępniane bezpośrednio użytkownikom przez Google.

Limity wykorzystania i rozliczenia

Jak skonfigurować rozliczenia za projekt?
Zobacz Pierwsze kroki z Google Maps Platform.
Jak klienci korzystający z bezpłatnego poziomu Google Cloud przechodzą na płatne konto?
Program Google Cloud w wersji bezpłatnej oferuje klientom bezpłatny okres próbny z 300 USD do wykorzystania w dowolnej usłudze Google Cloud, w tym w interfejsach API Google Maps Platform (GMP). Po zakończeniu bezpłatnego okresu próbnego musisz przełączyć się na płatne konto, aby nadal korzystać z tych usług. Aby przejść na płatne konto, otwórz konsolę Google Cloud.
Czy Google Maps Platform ma limity wykorzystania?

Nie ma maksymalnej dziennej liczby żądań, które możesz wysyłać do usług Google Maps Platform. Jedynie limity wykorzystania są związane z maksymalną liczbą zapytań na minutę (QPM).

W tabeli poniżej podano limity użycia poszczególnych interfejsów API. Limity kwoty możesz wyświetlać i modyfikować w Cloud Console.

Interfejs API Limit wykorzystania
Weryfikacja adresu 6000 QPM
Aerial View: Lookup Video 180 QPM i 100 000 QPD
Widok z lotu: renderowanie filmu 100 QPM i 100 QPD
Jakość powietrza 6000 QPM
Mapy dynamiczne 30 000 QPM
Wysokość 6000 QPM
Geokodowanie 3000 QPM
Geolokalizacja 6000 QPM
Interfejs Map Tiles API: kafelki 2D i kafelki Street View 6000 QPM i 15 000 QPD
Map Tiles API: fotorealistyczne kafelki 3D 10 000 QPD
Map Tiles API: fotorealistyczne kafelki 3D: renderowanie 12 000 QPM
Nawigacja: żądania ustawiania miejsca docelowego 30 tys. QPM
Miejsca 6000 QPM
Pyłek 6000 QPM
Drogi 30 tys. QPM
Trasy: obliczanie tras 3000 QPM
Trasy: obliczanie macierzy tras 3000 EPM
Panele słoneczne 600 QPM
Mapy statyczne 30 tys. QPM
Street View Image API 30 tys. QPM
Strefa czasowa 30 tys. QPM

Aby kontrolować wydatki, możesz monitorować wykorzystanie interfejsu API i ustawiać limity dzienne dla wszystkich żądań wysyłanych do płatnych interfejsów API.

Produkty Google Maps Platform muszą być wdrażane zgodnie ze standardowymi Warunkami korzystania z usługi Google Maps Platform.

Jak obliczamy koszty wykorzystania?

Informacje o cenach usług Google Maps Platform znajdziesz na liście cen.

Więcej informacji o płatnościach za interfejsy API Google Maps Platform znajdziesz w artykule Omówienie płatności i cen w Google Maps Platform.

Jak są zliczane wczytania map w Google Maps Platform?

Opłata za pojedyncze wczytanie mapy jest naliczana, gdy:

  • Strona internetowa lub aplikacja wyświetla mapę za pomocą interfejsu Maps JavaScript API.
  • Aplikacja wysyła żądanie pojedynczego obrazu mapy do interfejsu Maps Static API.

Panorama Street View jest naliczana osobno od wczytania mapy:

  • Za każde żądanie wysłane do interfejsu API Street View Static pobierana jest opłata za statyczne panoramy Street View, które są umieszczane w ramach osadzania statycznych (nieinterakcyjnych) panoram Street View.
  • Za każdą instancję obiektu panoramy w interfejsie Maps JavaScript API, pakiecie Maps SDK na Androida lub pakiecie Maps SDK na iOS naliczana jest opłata za dynamiczną panoramę Street View.

Po załadowaniu mapy, stałego obrazu mapy lub panoramy Street View przez stronę internetową lub aplikację wszelkie interakcje użytkownika z tymi elementami, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie powodują dodatkowego wczytywania mapy ani nie wpływają na limity użytkowania.

Dodanie znacznika nie spowoduje dodatkowego wczytania mapy, ale może spowodować obciążenia związane ze sposobem określenia lokalizacji pinezki (np. wczytywanie lub ponowne wczytywanie klasy google.maps.Map()).

Jak mogę monitorować użycie?

Wykorzystanie poszczególnych interfejsów API możesz monitorować w konsoli Google Cloud.

  1. Wybierz projekt zawierający interfejs API, który chcesz sprawdzić.
  2. Na liście interfejsów API w panelu kliknij nazwę interfejsu API.
  3. U góry strony kliknij Dane lub Limity.

Aby wyświetlić raport o ruchu i informacje rozliczeniowe dotyczące całego projektu, wykonaj te czynności:

  1. Jeśli jeszcze tego nie zrobiono, skonfiguruj rozliczenia.
  2. Otwórz stronę płatności w konsoli Cloud.
  3. Wybierz projekt.
  4. Na pasku bocznym po lewej stronie kliknij Raporty. Aby wyświetlić raporty dotyczące konta rozliczeniowego, użyj filtrów na pasku bocznym po prawej stronie.

Więcej informacji znajdziesz w artykułach Google Maps Platform Reporting, Google Maps Platform Monitoring i Ustawianie limitu kwoty.

Co się stanie, jeśli przekroczę limit częstotliwości żądań (QPM)?

Jeśli przekroczysz limity QPM danego produktu Platformy Map Google, interfejs API zwróci komunikat o błędzie. Jeśli wielokrotnie przekroczysz limity, dostęp do interfejsu API może zostać tymczasowo zablokowany.

Jeśli przekroczysz limity liczby żądań na minutę lub w inny sposób nadużywasz usługi, żądania zwrócą określony komunikat o błędzie. Jeśli nadal będziesz przekraczać limity, dostęp do Google Maps Platform może zostać zablokowany.

Uwaga: te interfejsy API usług internetowych mają odpowiednik na stronie klienta dostępny w Maps JavaScript API: Elevation i Geocoding.

Przekroczono limity wykorzystania

Jeśli przekroczysz limity wykorzystania, otrzymasz w odpowiedzi kod stanu OVER_QUERY_LIMIT.

Ten komunikat oznacza, że usługa internetowa przestała dostarczać zwykłe odpowiedzi i zwróciła tylko kod stanu OVER_QUERY_LIMIT, dopóki nie będzie można ponownie jej użyć. Ten scenariusz może wystąpić w ciągu kilku sekund, jeśli błąd został zgłoszony, ponieważ aplikacja wysłała zbyt wiele żądań na minutę.

Jeśli regularnie przekraczasz limity wykorzystania w ujęciu liczby żądań na minutę, rozważ zmniejszenie wykorzystania przez optymalizację aplikacji pod kątem bardziej efektywnego korzystania z produktów Google Maps Platform lub poproś o zwiększenie limitu. Więcej informacji znajdziesz w przewodniku Optymalizacja.

Moja witryna ma dużo ruchu. Czy mogę korzystać z usług Google Maps Platform?

Tak. Zalecamy jednak zapoznanie się z ograniczeniami korzystania dotyczącymi wszystkich interfejsów Google Maps Platform, z których korzysta Twoja aplikacja.

Jeśli masz konto rozliczeniowe, a przekroczysz limit bezpłatnego korzystania i nie masz na nim prawidłowej formy płatności (np. karty kredytowej lub przelewu bankowego), interfejs API przestanie działać, dopóki nie dodasz prawidłowej formy płatności.

Jak będzie obliczane i fakturowane wykorzystanie?

Korzystanie jest obliczane na koniec każdego dnia i obliczane według cen podanych w cenniku. Pod koniec każdego miesiąca łączna kwota za korzystanie jest obciążana formą płatności powiązaną z Twoim kontem rozliczeniowym. Więcej informacji znajdziesz w artykule Płatności za korzystanie z Google Maps Platform.

Ile kosztuje korzystanie z Google Maps Platform?

Aby poznać koszty poszczególnych interfejsów API, zapoznaj się z cennikiem. Jeśli Twoja aplikacja generuje żądania lub objętość map do wczytania do limitu bezpłatnego wykorzystania w danym miesiącu, nie naliczymy opłaty. Korzystanie z usługi powyżej limitu bezpłatnego jest obciążane na koncie rozliczeniowym. Więcej informacji znajdziesz w artykule Płatności za korzystanie z Google Maps Platform.

Czy ceny są dostępne w innych walutach?

W konsoli mogą być dostępne dodatkowe waluty. Jeśli wybierzesz inną walutę, stawki zostaną przeliczone z odpowiednika w USD podanego w naszym arkuszu z cenami.

Mam skonfigurowane płatności. Jak wyświetlić rachunek?

Google obciąża Cię na początku każdego miesiąca opłatą za aktywność z poprzedniego miesiąca, korzystając z  określonej przez Ciebie formy płatności. Szczegółowe informacje o rachunku znajdziesz w artykule Płatności za korzystanie z Google Maps Platform.

Dodatkowe zasoby:

Jak zabezpieczyć się przed wysokimi kosztami w przypadku niespodziewanego wzrostu wykorzystania?

Google Maps Platform umożliwia ustawienie dziennych limitów próśb i maksymalnych dziennych limitów naliczania opłat. Możesz ustawić maksymalny dzienny limit wykorzystania, aby zapobiec nieoczekiwanym wzrostom. Możesz też ustawić alerty dotyczące budżetu, aby otrzymywać e-maile z powiadomieniami, gdy obciążenia na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg.

Ustawianie maksymalnego dziennego limitu rozliczeniowego:

Aby uniknąć wysokich rachunków, możesz ustawić dzienny limit korzystania, aby chronić się przed nieoczekiwanym wzrostem wykorzystania. Ten limit możesz zmienić w Cloud Console.

Konfigurowanie alertów dotyczących budżetu i zarządzanie nimi:

Skonfiguruj alerty dotyczące budżetu, aby wysyłać e-maile do administratorów rozliczeń, gdy obciążenia na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg. Administratorzy rozliczeń będą otrzymywać e-maile z powiadomieniami, gdy szacunkowe obciążenia na koncie rozliczeniowym przekroczą próg o 50%, 90% i 100%.

Dotarła do mnie wiadomość, że mój projekt jest połączony z „kontem przejściowym Google Maps Platform”, ale nie mam dostępu do tego konta. Co mam zrobić?

„Konto przejściowe Google Maps Platform” zostało utworzone, aby pomóc niektórym klientom przejść na nasz plan taryfowy „Pay-as-you-go”. Dzięki temu konto przejściowe umożliwiło Google jednorazowe uznanie, dzięki któremu klienci mogli nadal korzystać z Google Maps Platform do limitu bezpłatnego poziomu. Po przekroczeniu tego limitu konto rozliczeniowe zostanie zamknięte, a Ty utracisz dostęp do usługi. Aby uniknąć przerw w działaniu usługi, skonfiguruj własne konto rozliczeniowe i nadal korzystaj z miesięcznego bezpłatnego limitu korzystania. Aby zmienić konto rozliczeniowe projektu:

  1. Utwórz nowe konto rozliczeniowe (jeśli masz już konto rozliczeniowe, możesz pominąć ten krok).
  2. Powiąż konto rozliczeniowe z projektem.
Dlaczego mój limit to 1 żądanie dziennie? Jak mogę zwiększyć ten limit?

Jeśli nie utworzysz i nie połączysz z projektem konta rozliczeniowego, interfejsy API Maps Platform będą ograniczone do 1 żądania dziennie. Możesz uzyskać wyższy limit, tworząc i dołączając konto rozliczeniowe. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Gdy utworzysz i połączysz konto rozliczeniowe, dzienny limit miejsca na dane zostanie usunięty. W konsoli Cloud możesz ustawić limit, aby zapobiec nieoczekiwanym wydatkom.

Otrzymaliśmy powiadomienie o naruszeniu zasad dotyczących płatności. Jak rozwiązać ten problem?

Otrzymaliśmy to powiadomienie, ponieważ stwierdziliśmy, że Twoje konto korzystało z kilku kont rozliczeniowych. Jest to naruszenie warunków Google określonych w Warunkach korzystania z usługi Google Maps Platform. Zgodnie z tymi warunkami tworzenie wielu kont rozliczeniowych jest zabronione. Więcej informacji znajdziesz w Najczęstszych pytaniach dotyczących naruszeń zasad dotyczących kont rozliczeniowych.

Korzystanie z Google Maps Platform

Jakich kluczy lub danych logowania powinienem używać w różnych usługach Map?

Za każdym razem, gdy używasz usług Google Maps Platform, musisz podać klucz interfejsu API, aby potwierdzić żądanie. Google Maps Platform jest dostępna w przypadku aplikacji na Androida, iOS lub internet oraz usług internetowych HTTP.

Klucz API:

  • Klucz interfejsu API to unikalny identyfikator, który generujesz w konsoli Cloud.
  • Przykład wczytywania interfejsu API za pomocą klucza: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Podpis cyfrowy:

  • Podpis cyfrowy jest generowany za pomocą tajnego klucza do podpisywania adresów URL udostępnionego przez Google. Podpisy cyfrowe są używane w przypadku interfejsów Maps Static API i Street View Static API.

Ograniczenia:

  • Ograniczenia kluczy interfejsu API są opcjonalne, ale ze względów bezpieczeństwa zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API. Więcej informacji znajdziesz w sprawdzonych metodach zapewniania bezpieczeństwa interfejsu API.
  • Możesz dodać do klucza interfejsu API ograniczenie aplikacji. Po wprowadzeniu ograniczenia klucz będzie działać tylko na platformach, które obsługują tego typu ograniczenia. Dostępne są 4 typy ograniczeń aplikacji. Interfejsy API stosujące ten sam typ ograniczenia mogą używać tego samego klucza z ograniczeniem.
  • Możesz też dodać do klucza API ograniczenie dotyczące interfejsu API. Więcej informacji znajdziesz w artykule Pobieranie, dodawanie i ograniczanie klucza interfejsu API.

Tabela poniżej wskazuje klucz/uprawnienia i ograniczenia aplikacji dotyczące każdego interfejsu API/pakietu SDK Google Maps Platform.

Interfejs API/pakiet SDK Dane logowania i ograniczenia aplikacji
Maps SDK na Androida Klucz interfejsu API z ograniczeniem dotyczącym Androida1
Pakiet SDK Miejsc na Androida Klucz interfejsu API z ograniczeniem dotyczącym Androida1
Pakiet SDK do nawigacji na Androida Klucz interfejsu API z ograniczeniem dotyczącym Androida1
Maps SDK na iOS Klucz interfejsu API z ograniczeniem na iOS1
Places SDK na iOS Klucz interfejsu API z ograniczeniem na iOS1
Pakiet Navigation SDK na iOS Klucz interfejsu API z ograniczeniem na iOS1
Maps JavaScript API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1
Map Tiles API Klucz interfejsu API z ograniczeniem adresu IP1
Maps Datasets API Token OAuth
Aerial View API Klucz interfejsu API z ograniczeniem adresu IP1
Maps Static API Klucz API z ograniczeniem strony odsyłającej HTTP1 + Podpis cyfrowy2
Street View Static API Klucz API z ograniczeniem strony odsyłającej HTTP1 + podpis cyfrowy2
Maps Embed API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1
Adres Validation API Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs Elevation API Klucz interfejsu API z ograniczeniem adresu IP1
Geocoding API Klucz interfejsu API z ograniczeniem adresu IP1
Geolocation API Klucz interfejsu API z ograniczeniem adresu IP1
Places API Klucz interfejsu API z ograniczeniem adresu IP1
Roads API Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs Routes API Klucz interfejsu API z ograniczeniem adresu IP1
Time Zone API Klucz interfejsu API z ograniczeniem adresu IP1
Air Quality API Klucz interfejsu API z ograniczeniem adresu IP1
Pollen API Klucz interfejsu API z ograniczeniem adresu IP1
Solar API Klucz interfejsu API z ograniczeniem adresu IP1
1 Ograniczenia klucza interfejsu API są opcjonalne, ale ze względów bezpieczeństwa zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API.
2 W zależności od sposobu użycia interfejsu Maps Static API i interfejsu Street View Static API może być wymagana podpis cyfrowy. Niezależnie od zastosowania, zdecydowanie zalecamy używanie zarówno klucza interfejsu API, jak i podpisu cyfrowego do uwierzytelniania żądań.
Jak zmienić typ ograniczenia klucza z odwołującego adresu HTTP na ograniczenie adresu IP?

Ważne: jeśli używasz interfejsów API usług internetowych z kluczem API, który ma ograniczenia dotyczące odsyłającego, Twoje żądania nie będą realizowane i będzie wyświetlany komunikat o błędzie: „Klucze API nie mogą mieć ograniczeń dotyczących odsyłającego, gdy są używane z tym interfejsem API”. Zamiast tego użyj klucza API z ograniczeniami adresów IP.

Zanim zmienisz typ ograniczenia klucza API z odwołującego HTTP na adres IP, upewnij się, że wszystkie interfejsy API, które używają klucza API, obsługują typ ograniczenia adresu IP. Interfejsy API tego samego typu mogą używać tego samego klucza. Jeśli musisz zastosować więcej niż 1 ograniczenie, dodaj osobny klucz z wymaganym ograniczeniem. Dowiedz się, jak dodać nowy klucz API.

Dowiedz się więcej o ograniczeniach klucza interfejsu API związanych z usługami Google Maps Platform.

Aby przełączyć klucz interfejsu API z ograniczeniem strony odsyłającej HTTP na ograniczenie adresu IP:

  1. W konsoli Cloud otwórz stronę Dane logowania.
  2. Wybierz projekt, który zawiera klucz API, który chcesz edytować.
  3. Na stronie Dane logowania na liście kluczy API wybierz nazwę klucza API, aby edytować jego szczegóły.
  4. W sekcji Ograniczenie klucza na stronie wybierz „Adresy IP (serwery WWW, zadania cron itp.)” i wstaw odpowiednie adresy IP serwera, a następnie kliknij Zapisz.
Jak uzyskać nowy klucz interfejsu API?
Zobacz Pierwsze kroki z Google Maps Platform.
Jak mogę znaleźć zmiany wprowadzone w każdej wersji interfejsów API Map Google?

Informacje o zmianach wersji wielu interfejsów Map API są dostępne pod tymi linkami:

Możesz też sprawdzić, w której wersji Google Maps Platform pojawił się dany błąd i w której został naprawiony, korzystając z narzędzia do śledzenia problemów z Google Maps Platform na stronie:

https://issuetracker.google.com/bookmark-groups/76561

Jak mogę asynchronicznie wczytać interfejs API na stronie po jej załadowaniu?

Wystarczy, że podczas wczytywania interfejsu API określisz parametr wywołania zwrotnego. Więcej informacji i przykładowy kod znajdziesz w rozdziale Rozpoczynanie dokumentacji interfejsu Maps JavaScript API.

Jak mogę wyświetlać usługi Google Maps Platform w języku innym niż angielski?

Domyślnie interfejs API będzie próbować wczytywać najbardziej odpowiedni język na podstawie lokalizacji użytkownika lub ustawień przeglądarki. Niektóre interfejsy API umożliwiają jawne ustawienie języka podczas wysyłania żądania. Więcej informacji o ustawianiu języka znajdziesz w dokumentacji poszczególnych interfejsów API:

Obsługiwane języki:

Google często aktualizuje listę obsługiwanych języków. Ta lista może nie być wyczerpująca i może ulec zmianie.

Kod języka Język Kod języka Język
af afrikaans ja japoński
sq albański kn kannada
am amharski kk kazachski
ar arabski km khmerski
hy ormiański ko koreański
az azerski ky kirgiski
ue baskijski lo laotański
be białoruski lv łotewski
bn bengalski lt litewski
bs bośniacki mk macedoński
bg bułgarski ms malajski
my birmański ml malajalam
urząd certyfikacji kataloński mr marathi
zh chiński mn mongolski
zh-CN chiński (uproszczony) ne nepalski
zh-HK chiński (Hongkong) nie norweski
zh-TW chiński (tradycyjny) pl polski
h chorwacki pt portugalski
cs czeski pt-BR portugalski (Brazylia)
da duński pt-PT portugalski (Portugalia)
nl niderlandzki pa pendżabski
en angielski ro rumuński
en-AU angielski (Australia) ru rosyjski
en-GB angielski (Wielka Brytania) sr serbski
et estoński si syngaleski
fa perski sk słowacki
fi fiński sl słoweński
fil filipiński es hiszpański
fr francuski es-419 hiszpański (Ameryka Łacińska)
fr-CA francuski (Kanada) sw suahili
gl galicyjski sv szwedzki
ka gruziński ta tamilski
de niemiecki te telugu
el grecki th tajski
gu gudżarati tr turecki
iw hebrajski uk ukraiński
hi hindi ur urdu
hu węgierski uz uzbecki
jest islandzki vi wietnamski
id indonezyjski zu zulu
it włoski

Jak będzie wyglądać mapa w dowolnym z wymienionych wyżej języków, możesz sprawdzić w tej próbnej aplikacji.

Czy można uzyskać dostęp do Google Maps Platform przez protokół HTTPS (TLS)?

Do wszystkich usług Google Maps Platform można należy uzyskiwać dostęp przez HTTPS. Aby zapewnić kompatybilność swoich aplikacji z przyszłością, zdecydowanie zalecamy korzystanie z TLS 1.3 w przypadku HTTPS. Chociaż starsze wersje TLS są nadal obsługiwane, nie zalecamy korzystania ze starszych wersji TLS 1.0 i 1.1.

Wycofany protokół SSL nie jest już obsługiwany.

Więcej informacji znajdziesz w artykule Najczęstsze pytania dotyczące migracji głównego urzędu certyfikacji Google Maps Platform i Google Trust Services – najczęstsze pytania.

Jak zgłosić błąd lub przesłać prośbę o dodanie nowej funkcji w Google Maps Platform?

Jeśli zauważysz działanie, które Twoim zdaniem może być błędem, zacznij od zgłoszenia go na odpowiednim forum. Pozwoli to innym deweloperom zweryfikować błąd i wykluczyć potencjalne problemy z Twoim kodem.

Jeśli chcesz zgłosić prośbę o dodanie funkcji, najpierw zrób to na odpowiednim forum, aby upewnić się, że rozwiązanie spełniające Twoje wymagania nie jest już dostępne.

Gdy potwierdzisz, że wykryłeś/wykryłaś nowy błąd lub że Twoje wymagania nie mogą zostać spełnione przez istniejące funkcje usług Google Maps Platform, zgłoś błąd lub prośbę o wprowadzenie funkcji za pomocą Narzędzia do zgłaszania problemów z Google Maps Platform.

Zanim dodasz błąd lub prośbę o funkcję do Problem Trackera, sprawdź, czy nie zostały one już dodane. Jeśli tak, możesz oznaczyć problem gwiazdką, aby pokazać swoje zainteresowanie i otrzymywać powiadomienia o aktualizacjach.

Jak interfejsy API Google Maps Platform korzystają z plików cookie witryny?

Pakiety SDK Map na Androida i na iOS używają plików cookie zgodnie z Polityką prywatności Google, np. do obliczania liczby aktywnych użytkowników w ciągu dnia i 7 dni oraz do zapobiegania nadużyciom usługi. Te pliki cookie nie są powiązane z żadnym zalogowanym kontem Google i nie są rejestrowane razem z pozostałymi informacjami zebranymi z wywołań interfejsu API.

Nie mogę znaleźć odpowiedzi na moje pytanie. Z kim mogę się skontaktować?

Zespół ds. relacji z deweloperami w Google prowadzi konto na Stack Overflow – stronie z odpowiedziami na pytania i pytaniami edytowanymi wspólnie przez programistów. To świetne miejsce na zadawanie pytań technicznych dotyczących tworzenia i utrzymywania aplikacji na potrzeby Map Google. Więcej informacji o zadawaniu pytań na Stack Overflow znajdziesz na stronie Pomoc.

Aby uzyskać najlepsze wyniki, pamiętaj o tych kwestiach:

  • wyszukiwać bieżących dyskusji; Prawdopodobnie ktoś inny miał podobny problem i znalazł jego rozwiązanie.
  • Jeśli to możliwe, prześlij link do swojej witryny. Dodaj fragmenty kodu tylko wtedy, gdy kod nie jest widoczny online.
  • Podaj wszystkie istotne informacje, w tym wersje przeglądarki, błędy i inne fakty, które mogą być przydatne w rozwiązywaniu tego problemu.

Błędy i rozwiązywanie problemów

Co oznacza ten błąd?

Jeśli podczas wczytywania lub uruchamiania interfejsów Map Google wystąpi błąd, zapoznaj się z tymi linkami, aby znaleźć wyjaśnienia kodów błędów:

Moje mapy są ciemniejsze niż zwykle. Co się dzieje?

W niektórych okolicznościach może zostać wyświetlona przyciemniona mapa lub „negatywowy” obraz Street View z znakiem wodnym „Tylko do celów rozwojowych”. Takie zachowanie zwykle wskazuje na problemy z kluczem API lub rozliczeniami. Aby korzystać z usług Google Maps Platform, musisz mieć konto rozliczeniowe, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Poniższa procedura pomoże Ci rozwiązać ten problem:


Jak rozwiązać problem z kodami błędów OVER_DAILY_LIMIT lub OVER_QUERY_LIMIT?
Te kody błędów mogą zostać zwrócone z jednego z tych powodów:
  • W żądaniu brakuje klucza interfejsu API.
  • Podany klucz API jest nieprawidłowy.
  • Projekt nie ma przypisanego konta rozliczeniowego.
  • Przekroczono limit wykorzystania.
  • podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność);
  • Przekroczono limity wykorzystania danego interfejsu API.

Aby korzystać z usług Google Maps Platform, musisz mieć konto rozliczeniowe, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Aby rozwiązać ten problem:

Jak rozwiązać problem z kodami błędów kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Jeśli widzisz komunikaty kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED, być może używasz wycofanej wersji pakietu Places SDK na Androida lub iOS. Więcej informacji o nowych pakietach SDK znajdziesz na stronie https://goo.gle/places-sdk-deprecation.
Jak rozwiązać błąd „Ten adres IP, witryna lub aplikacja mobilna nie jest upoważniona do korzystania z tego klucza interfejsu API”?

Ten błąd może wystąpić w różnych sytuacjach:

  • W kluczu interfejsu API masz włączone ograniczenia adresów IP (serwerów), a nieautoryzowany adres IP próbuje wysłać żądanie.
  • W kluczu API masz włączone ograniczenia dotyczące strony odsyłającej HTTP (witryny) i nieautoryzowany odsyłający próbuje wysłać żądanie.
  • Ograniczyłeś/ograniczyłaś dostęp do swoich aplikacji na Androida, ustawiając nazwę pakietu i odcisk cyfrowy, a nieautoryzowana aplikacja na Androida próbuje wysłać żądanie.
  • Ograniczyłeś żądania z aplikacji na iOS, podając identyfikatory pakietów, a nierozpoznana aplikacja na iOS próbuje wysłać żądanie.
  • Wcześniej ten błąd mógł wystąpić, jeśli używasz interfejsów API usług internetowych z kluczem API, który ma ograniczenia dotyczące strony odsyłającej HTTP. Żądania do tych interfejsów API powinny być identyfikowane za pomocą klucza API z ograniczeniami dotyczącymi adresu IP. Zmień typ ograniczenia klucza z ograniczenia odsyłającego HTTP na ograniczenie adresu IP. Więcej informacji o ograniczaniu kluczy interfejsu API znajdziesz w artykule sprawdzonych metod dotyczących kluczy interfejsu API.

Wyświetlanie i edytowanie danych logowania klucza API

Aby wyświetlić klucze interfejsu API i zarządzać ograniczeniami, wykonaj te czynności:

  1. W konsoli Cloud otwórz stronę Dane logowania.
  2. Wybierz projekt, który zawiera klucz interfejsu API, który chcesz sprawdzić.
  3. Aby wyświetlić szczegóły danych logowania, w tym wszelkie ograniczenia ustawione dla klucza, kliknij nazwę klucza na liście kluczy API.
  4. Wyświetlają się pełne dane logowania do wybranego klucza interfejsu API, w tym wszelkie ograniczenia skonfigurowane dla tego klucza. Możesz tu w razie potrzeby zmienić, usunąć lub zaktualizować ograniczenia.
Jak rozwiązać błąd „Nie można używać kluczy API z ograniczeniami dotyczącymi referera z tym interfejsem API”?

Korzystasz z dowolnego interfejsu API usługi internetowej z kluczem API ograniczonym do strony odsyłającej HTTP. Ze względów bezpieczeństwa interfejsy API usług internetowych muszą używać kluczy API ograniczonych do adresów IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP lub utwórz nowy klucz interfejsu API, jeśli Twój klucz jest już używany w interfejsie Maps JavaScript API.

Usługi Google Maps Platform

Muszę przekonwertować adresy na pary szerokość/długość geograficzna. Czy mogę to zrobić za pomocą Google Maps Platform?

Tak, ten proces nazywa się „geokodowaniem”. Interfejs Maps JavaScript API zawiera klasę do wykonywania usługi geokodowania. Klasa: google.maps.Geocoder.

Google udostępnia też interfejs Geocoding API, który oferuje interfejs REST, który może odpowiadać w formatach JSON i XML.

W jakich krajach geokodowanie jest dostępne?

Aby sprawdzić, które kraje są obsługiwane przez geokodery Google Maps Platform, zapoznaj się z danymi dotyczącymi zasięgu Google Maps.

Dokładność zkodowanych geograficznie lokalizacji może się różnić w zależności od kraju, dlatego warto użyć zwróconego pola location_type, aby określić, czy znaleziono wystarczająco dobre dopasowanie do potrzeb Twojej aplikacji. Dostępność danych geokodowania zależy od naszych umów z dostawcami danych, więc może ulec zmianie.

Dlaczego geokodery Google Maps Platform podają inne lokalizacje niż Mapy Google?

Geokoder interfejsu API i geokoder Map Google czasami korzystają z różnych zbiorów danych (w zależności od kraju). Geokoder interfejsu API jest od czasu do czasu aktualizowany o nowe dane, więc z upływem czasu możesz zauważyć, że wyniki się zmieniają lub poprawiają.

Jak należy sformatować zapytania do geokodera, aby zmaksymalizować liczbę udanych żądań?

Geokoder służy do mapowania adresów ulic na współrzędne geograficzne. Aby zmaksymalizować prawdopodobieństwo uzyskania pomyślnego wyniku, zalecamy stosowanie następujących wytycznych dotyczących formatowania żądań geokodowania:

  • Określ adresy w formacie używanym przez krajową pocztę danego kraju.
  • nie określać dodatkowych elementów adresu, takich jak nazwy firm, numery pokoi, numery pięter czy numery lokali, które nie są uwzględnione w adresie zgodnie z definicją poczty danego kraju; Może to spowodować wyświetlanie odpowiedzi z ZERO_RESULTS.
  • Formatuj kody plusa w ten sposób (znaki plusa są zastępowane w adresach URL przez znak %2B, a spacje przez znak %20):
    • Kod globalny to 4-znakowy kod obszaru i 6-znakowy lub dłuższy kod lokalny (849VCWC8+R9 to 849VCWC8%2BR9).
    • Kod złożony to kod lokalny o długości co najmniej 6 znaków z wyraźną lokalizacją (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Jeśli to możliwe, zamiast nazwy budynku użyj numeru domu.
  • W miarę możliwości używaj adresów numerycznych zamiast podawania ulic przecinających się.
  • nie podawaj „wskazówek”, takich jak pobliskie punkty orientacyjne;
Jakie formatowanie adresu amerykańskiego na drodze numerowanej należy zastosować do celów geokodowania?

Geokoder platformy Mapy Google wymaga, aby amerykańskie autostrady z numerami były określane w adresach w ten sposób:

  • County Roads: "Co Road NNN" gdzie NNN to numer drogi. Przykład: "Co Road 82"
  • Drogi stanowe: "State NNN" gdzie State to pełna nazwa stanu, a NNN to numer drogi. Przykład: "California 82"
  • Amerykańskie autostrady: "US NNN" gdzie NNN to numer autostrady. np. "US 101"
  • Autostrada międzystanowa w USA: "Interstate NNN" gdzie NNN to numer autostrady międzystanowej. Przykład: "Interstate 280"
Kiedy należy używać klasy geokodowania API, a kiedy usługi geokodowania HTTP?

Zapoznaj się z dokumentem Strategie kodowania adresów, który zawiera szczegółowe informacje o zaletach i ograniczeniach różnych strategii kodowania adresów.

Jak mogę udostępnić wskazówki dojazdu za pomocą Google Maps Platform?

Usługa obliczania tras w interfejsie Routes API umożliwia wyświetlanie wskazówek dojazdu dla pojedynczych i wieloetapowowych tras. Opcje routingu pomagają określić trasę, korzystając z określonego środka transportu (samochód), jednej lub wielu tras oraz ograniczeń (bez dróg płatnych). Te usługi są dostępne w tych formach:

Interfejs żądania/odpowiedzi HTTP (używany w aplikacjach mobilnych i innych) jest zgodny z Maps SDK na Androida i innymi usługami internetowymi Map Google.

W jakich krajach dostępne są wskazówki dojazdu?

Aby sprawdzić, w których krajach można wyznaczać trasy samochodowe w usługach Google Maps Platform, zapoznaj się z danymi dotyczącymi zasięgu Map Google. Dostępność danych dotyczących wskazówek dojazdu zależy od naszych umów z dostawcami danych i może ulec zmianie.

W jakich krajach dostępne są wskazówki dojazdu transportem publicznym?

Interfejs Routes API obsługuje wszystkich partnerów Google Transit, z wyjątkiem Indian Railway Catering and Tourism Corporation oraz tych w Japonii.

Które funkcje KML i GeoRSS są obsługiwane w interfejsie Maps JavaScript API?

Klasa KmlLayer w interfejsie Maps JavaScript API umożliwia deweloperom nakładanie na mapę plików KML/KMZ i GeoRSS. Dokumentację i przykłady znajdziesz w klasie KmlLayer.

Jakie są limity rozmiaru i złożoności plików KML, które można wyświetlać za pomocą klasy KmlLayer interfejsu Maps JavaScript API?

Ograniczenia rozmiaru i złożoności wyświetlania KML za pomocą klasy KmlLayer są opisane w artykule Omówienie warstwy KML.

Jak mogę wyrenderować na mapie pliki KML hostowane na stronach intranetowych?

Klasa KmlLayer, która generuje nakładki KML w interfejsie Maps JavaScript API, korzysta z usługi hostowanej przez Google do pobierania i analizowania plików KML na potrzeby renderowania. W związku z tym nie można wyświetlać plików KML, które nie są hostowane pod adresem URL dostępnym publicznie lub wymagają uwierzytelniania.

Jeśli chcesz tworzyć aplikacje korzystające z plików KML hostowanych w witrynach intranetowych, zalecamy renderowanie pliku KML po stronie klienta za pomocą zewnętrznych bibliotek JavaScript. Plik KML jest analizowany przez przeglądarkę, więc wydajność może być niższa niż w przypadku korzystania z klasy KmlLayer.

Jaka jest maksymalna liczba wierzchołków znacznika lub ścieżki obsługiwana przez interfejs Maps Static API?

API Maps Static nie ma limitu liczby znaczników ani wierzchołków ścieżki. W przypadku ikon niestandardowych możesz określić maksymalnie 5 niepowtarzalnych ikon na żądanie, ale każda z nich może być używana wielokrotnie na mapie.

Pamiętaj, że adresy URL interfejsu Maps Static API mogą zawierać maksymalnie około 8192 znaków, co ogranicza liczbę wierzchołków ścieżki i znaczników, które można określić na podstawie liczby miejsc po przecinku użytych podczas określania pary współrzędnych szerokości i długości geograficznej. Informacje o tym, jak liczba użytych miejsc po przecinku ma się do dokładności na Ziemi, znajdziesz w artykule na Wikipedii Stopnie dziesiętne.

Dlaczego nie mam dostępu do usług Google Maps Platform w przypadku niektórych krajów?

Interfejsów API Map Google nie można używać na terytoriach objętych zakazem. Zapoznaj się też z Warunkami korzystania z usługi.

Jak zgłosić problem z mapą Google?
Wyślij opinię w Mapach Google, aby zgłosić błędne lub brakujące informacje na mapie, takie jak:
  • nieprawidłowe adresy lub błędne lokalizacje znaczników.
  • nieprawidłowe nazwy dróg,
  • nieprawidłowe informacje o drodze jedno- lub dwukierunkowej,
  • drogę przebiegającą nieprawidłowo,
  • zamknięte drogi,
  • nieistniejące drogi,

Aby poprawić informacje o miejscu lub firmie, zaproponuj zmianę.

Jeśli treści w Mapach Google należy usunąć z powodów prawnych, prześlij wniosek prawny.

W przypadku pilnych lub pilnych próśb prześlij zgłoszenie do zespołu pomocy, podając szczegółowe informacje o tym, co należy naprawić.

Jak jest monitorowana wydajność usług używanych z interfejsem Maps JavaScript API?

Niektóre funkcje po stronie klienta są instrumentowane w celu raportowania powodzenia lub niepowodzenia w celu obliczenia docelowo poziomu usług (SLO). Te informacje są wysyłane do Google pod adresem maps.googleapis.com/maps_api_js_slo/log w przypadku połączeń, które rejestrują informacje o czasie obsługi klienta. Informacje te obejmują stan powodzenia, opóźnienie oraz wersję/kanał interfejsu Maps JavaScript API. Połączenia mogą być grupowane w partie ze względu na wydajność. Aby mieć pewność, że te wywołania nie są blokowane na poziomie przeglądarki, konieczne może być zezwolenie na maps.googleapis.com w zasadach bezpieczeństwa treści. Na przykład: Content-Security-Policy: default-src 'self' maps.googleapis.com; z nagłówkami HTTP lub <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> z metatagami HTML.

Maps JavaScript API

Jak długo po załadowaniu będzie działać interfejs Maps JavaScript API?

Musisz odświeżyć stronę, która wczytuje interfejs Maps JavaScript API, co najmniej raz na 5 dni.

Google Maps SDK na iOS

Jak rozwiązać problem: kGMSPlacesRateLimitExceeded?
Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK na iOS. Wersja 2.7.0 pakietu SDK Miejsca na iOS została wyłączona i nie jest już dostępna. Zaktualizuj aplikację do najnowszej wersji tak szybko, jak to możliwe. Szczegółowe informacje znajdziesz w przewodniku po migracji.
Podczas debugowania na urządzeniu z iOS 8.x występują awarie. Co mam zrobić?

Jeśli napotkasz problemy podczas debugowania na urządzeniach z iOS 8.x, wykonaj te czynności, aby wyłączyć przechwytywanie klatek przez procesor graficzny w uruchomionym schemacie XCode:

  1. W Xcode kliknij Produkt, Schemat, Zarządzaj schematami.
  2. Wybierz schemat i kliknij Edytuj….
  3. Ustaw opcję Przechwytywanie ramek przez GPU na Wyłączone. Pamiętaj, że ta opcja może nie być dostępna na wszystkich urządzeniach.
Opcja Xcode GPU Frame Capture na stronie Generic iOS device (Typowe urządzenie z iOS)
Jaki wpływ na pakiet SDK Map Google na iOS mają zaokrąglone i szersze ekrany?

Począwszy od iPhone’a X ekrany iPhone’ów mają zaokrąglone rogi, wycięcie na górze dla komory czujnika oraz wskaźnik u dołu ekranu, który umożliwia dostęp do ekranu głównego. W pakiecie SDK iOS 11.0 firma Apple dodała interfejs Safe Area API, który umożliwia deweloperom umieszczanie elementów w obszarze, który nie zostanie przycięty przez nowy kształt ekranu.

Pakiet SDK Map Google na iOS zawiera wiele elementów wizualnych i elementów sterujących, takich jak selektor wnętrza i link do zgłaszania problemów. W wersji 2.4 te elementy wizualne i elementy sterujące mogły być przycięte przez nowy kształt ekranu. W układzie poziomym selektor podłogi w pomieszczeniu może być przycięty przez wycięcie lub wskaźnik przycisku Wróć.

W wersji 2.5 pakietu SDK Map Google na iOS te problemy z układem są automatycznie rozwiązywane. Gdy aplikacja jest używana na iPhonie X lub nowszym, odstępy w elementach GMSMapView i GMSPanoramaView są zwiększane, aby elementy wizualne nie były przycinane.

Domyślnie zawsze uwzględniamy wypełnienie. Pakiet SDK Map Google na iOS zakłada, że wypełnienie ma być dodane w bezpiecznym obszarze. Jeśli zaprojektujesz interfejs z założenia, że wszystko znajduje się w bezpiecznym obszarze, będzie on działać bez dodatkowych działań.

Jeśli zaprojektowany przez Ciebie interfejs nie działa z domyślnym dostosowaniem, wprowadziliśmy do klasy GMSMapView nową właściwość o nazwie paddingAdjustmentBehavior. GMSMapView umożliwia teraz wybór jednego z 3 zachowań dotyczących dopasowania: „Zawsze” (domyślnie), „Automatycznie” i „Nigdy”.

Jeśli GMSMapView ma używać zachowania „Zawsze”, zawsze będzie dodawać do wypełnienia obszary bezpieczne. To ustawienie pozwala projektować interfejs z założenia, że wszystkie miejsca docelowe znajdują się na krawędziach bezpiecznej strefy. Jest to wartość domyślna.

Jeśli GMSMapView ma używać zachowania „Automatyczne”, zawsze wybierze większy obszar wypełnienia lub obszar bezpieczny. To ustawienie pozwala dodać odstęp od krawędzi ekranu, jednocześnie zapewniając, że wszystkie elementy pozostają w bezpiecznym obszarze.

Jeśli GMSMapView ma ustawione zachowanie „Nigdy”, nigdy nie doda do wypełnienia obszarów bezpiecznych. Takie działanie było możliwe przed wydaniem wersji 2.5. Może być przydatne, jeśli margines już uwzględnia bezpieczną strefę lub jeśli inne zachowania nie działają prawidłowo w Twoim interfejsie. Twoim obowiązkiem jest dbanie o to, aby logo Google i powiadomienia o prawach autorskich były zawsze widoczne, zgodnie z Warunkami korzystania z usługi Google Maps Platform.

W przypadku GMSPanoramaView nie ma opcjonalnej właściwości dopełniania. Oznacza to, że nie trzeba dostosowywać żadnych marginesów. GMSPanoramaView zawsze stosuje marginesy, aby wszystkie elementy wizualne znalazły się w bezpiecznej strefie.

Google Maps SDK na Androida

Jak rozwiązać problem: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK na Androida. Wersja pakietu SDK Miejsca na Androida, która korzysta z usług Google Play, została wyłączona i nie jest już dostępna. Zaktualizuj aplikację, aby jak najszybciej korzystać z najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.
Zamiast mapy aplikacja wyświetla tylko puste szare płytki. Jak mogę rozwiązać ten problem?

Puste szare kafelki zamiast mapy mogą się wyświetlać z powodu problemów z uwierzytelnianiem. Aby rozwiązać te problemy, wykonaj czynności opisane poniżej, korzystając z polecenia adb logcat.

  1. Sprawdź, czy masz zainstalowany adb. Jeśli nie, możesz postępować zgodnie z instrukcją dotyczącą adb na Androida.
  2. Zainstaluj aplikację, która powoduje problem, na urządzeniu lub w emulatorze Androida. Jeśli używasz emulatora Androida, sprawdź, czy w ustawieniach emulatora jest uwzględniony Sklep Play.
  3. W terminalu Android Studio uruchom adb logcat -e "Google Maps Android API". Wyświetli to tylko te wiersze, w których komunikat dziennika jest zgodny z „Google Maps Android API”. (Opcjonalnie możesz wyprowadzić dziennik do pliku tekstowego, dodając: > logcat.txt)
  4. Odtwórz problem na urządzeniu i sprawdź, czy nie występują typowe błędy, takie jak:
    • W pliku manifestu występuje odwołanie do nieprawidłowego lub niezamierzonego klucza interfejsu API.
    • W projekcie nie włączono płatności.
    • Pakiet SDK nie jest włączony w interfejsach API projektu.
    • Do ograniczeń klucza interfejsu API został dodany nieprawidłowy odcisk cyfrowy SHA-1.
    • Usługi Google Play są zależne od innych usług, które nie są uwzględnione w pliku build.gradle.

Podpisywanie URL

Czy mogę podpisywać adresy URL za pomocą JavaScriptu?

Zdecydowanie zalecamy, aby nie podpisywać adresów URL za pomocą JavaScriptu, ponieważ spowoduje to ujawnienie tajnego klucza do podpisywania adresów URL użytkownikom końcowym. Dlatego podpisy powinny być generowane tylko przez komponenty po stronie serwera.

Dlaczego otrzymuję odpowiedź HTTP 403 „Forbidden” na żądania wysyłane do usługi internetowej interfejsu API Map Google?

Odpowiedź HTTP 403 wskazuje na problem z uprawnieniami, prawdopodobnie dlatego, że podpis nie został zweryfikowany w przypadku tego żądania. Oto możliwe przyczyny:

  1. Podpis został podany, ale jest nieprawidłowy w przypadku tego żądania.
  2. żądanie zawiera klucz API w ramach subskrypcji Google Maps Platform Premium, ale nie zawiera podpisu, a usługa, do której się odwołujesz, wymaga, aby żądania wysyłane za pomocą klucza API zawierały prawidłowy podpis;
  3. Podpisano, ale nie podano klucza interfejsu API Google Maps Platform Premium Plan.