Najczęstsze pytania dotyczące Google Maps Platform

Pierwsze kroki

Warunki korzystania z usługi

Limity wykorzystania i rozliczenia (limity)

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

Co to 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 ofert. W zależności od potrzeb możesz używać jednego z tych interfejsów API i pakietów SDK lub ich kombinacji:

Mapy:

Trasy:

Miejsca:

Środowisko:

Jak zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki z Google Maps Platform.

Którego interfejsu API potrzebuję?

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

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

Zapoznaj się z omówieniem, przewodnikiem dla deweloperów i przewodnikiem dla początkujących dotyczącymi konkretnego interfejsu API lub pakietu SDK, który Cię interesuje. Zapoznaj się na przykład z przewodnikami po Maps SDK na Androida lub Maps JavaScript API.

Które kraje obejmuje Google Maps Platform?

Zespół Map Google stale publikuje nowe dane map i zwiększa zasięg międzynarodowy. Najnowsze informacje o dostępności znajdziesz w danych o dostępności Map Google. Dane możesz filtrować za pomocą pola filtra u góry strony. Dane o zasięgu mogą się zmienić, jeśli zmienią się umowy licencyjne z dostawcami danych.

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 wyświetlanej mapy w witrynie lub na 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 umieścić mapy w aplikacji na Androida, użyj Maps SDK na Androida.

Aby umieścić mapy w aplikacji na iOS, użyj Maps SDK na iOS.

Interfejs Maps JavaScript API został opracowany z myślą o urządzeniach mobilnych i nadaje się do aplikacji przeglądarkowych przeznaczonych zarówno na komputery, jak i na urządzenia z przeglądarką internetową z pełną implementacją JavaScriptu, takie jak Apple iPhone.

W przypadku aplikacji przeznaczonych na urządzenia, które nie obsługują Maps JavaScript API, Maps Static API dostarcza obrazy map w formatach GIF, JPG i PNG, w tym znaczniki i linie łamane. Pamiętaj, że używanie interfejsu Maps Static API poza aplikacjami działającymi w przeglądarce wymaga, aby obraz mapy był połączony z Mapami Google.

Które przeglądarki obsługują interfejsy Maps JavaScript API i Maps Embed API?

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

Komputer
  • Aktualna wersja Microsoft Edge (Windows), z wyjątkiem trybu IE.
  • 2 najnowsze główne stabilne wersje przeglądarki Firefox (Windows, macOS, Linux).
  • 2 najnowsze główne wersje stabilne Chrome (Windows, macOS, Linux).
  • 2 najnowsze główne wersje stabilne Safari (macOS).
Android
  • Aktualna wersja Chrome na Androida 4.1 lub nowszego.
  • Chrome WebView na Androidzie 4.4 lub nowszym.
iOS
  • Mobile Safari w obecnej i poprzedniej głównej wersji iOS.
  • UIWebView i WKWebView w obecnej i poprzedniej wersji głównej systemu 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 niespójna w popularnych przeglądarkach.

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

Zasubskrybuj bloga Google Maps Platform, aby otrzymywać najnowsze informacje o różnych ofertach Google Geo dla deweloperów.

Jak skontaktować się z pomocą techniczną?

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

Kiedy dostępna jest pomoc techniczna?
Zespół pomocy jest dostępny przez całą dobę w dni robocze (od poniedziałku od godziny 9:00 czasu tokijskiego do piątku do godziny 17:00 czasu pacyficznego) z wyjątkiem dni wolnych od pracy w danym regionie. Pomoc dotyczy problemów związanych z niedostępnością usługi.
Jak odzyskać dostęp do konta Google?

Jeśli nie masz dostępu do swojego konta Google (np. jan@mojafirma.com lub jan@gmail.com), możesz spróbować go odzyskać, odzyskując lub resetując hasło. Przeczytaj artykuł Jak odzyskać konto Google lub Gmail w Centrum pomocy 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ć pakietów Maps SDK i Places SDK na iOS na komputerach Mac z procesorami ARM?

Programowanie na nowych komputerach Mac z procesorami ARM jest możliwe, ale wymaga kompilowania i uruchamiania na fizycznym urządzeniu z iOS. Jest to tymczasowe ograniczenie, które usuniemy, gdy dodamy więcej opcji programowania na symulatorach.

Zapoznanie się z warunkami korzystania z usługi

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

Warunki korzystania z usługi Google Maps Platform są dostępne na stronie:

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

Czy moja witryna jest zgodna z Warunkami korzystania z usługi Google Maps Platform?

Możesz używać Google Maps Platform w swoich aplikacjach, o ile Twoja witryna jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Istnieją jednak pewne sposoby korzystania z Google Maps Platform, których nie chcemy widzieć. Na przykład mapy, które wskazują miejsca, gdzie można kupić narkotyki, lub inne nielegalne działania. Szanujemy też prywatność użytkowników, dlatego nie należy używać Google Maps Platform do identyfikowania informacji prywatnych o osobach.

Przed utworzeniem i uruchomieniem aplikacji skonsultuj się z własnym doradcą prawnym, aby ustalić, czy jest ona 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 należy uważnie przeczytać Warunki korzystania z interfejsów API Map Google.

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

Nie możesz uzyskiwać dostępu do fragmentów mapy ani zdjęć satelitarnych za pomocą żadnego mechanizmu innego niż Google Maps Platform (np. przez utworzenie własnego interfejsu API Map Google lub użycie skryptu do zbiorczego pobierania fragmentów). Dostęp aplikacji do kafelków zostanie zablokowany, jeśli będzie ona uzyskiwać do nich 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ę używać Map Google w aplikacji innej niż internetowa?

Tak, produktów Google Maps Platform można teraz używać w aplikacjach innych niż aplikacje internetowe, 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 wtedy, gdy jest uruchamiany w jednej z obsługiwanych przeglądarek.

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

Tak, usług Mapy Google, Trasy, Miejsca i Środowisko można używać w aplikacjach z dostępem prywatnym. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform.

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

Jeśli aplikacja generuje dokument w formie elektronicznej lub drukowanej, nie mogą się w nim znajdować żadne dane z Google Maps Platform, w tym obrazy. Więcej informacji znajdziesz w sekcji „Zakaz scrapowania” w Warunkach korzystania z usługi Google Maps Platform.

Jak mogę zrezygnować z uwzględniania moich treści w wynikach wyszukiwania Google?

Nie zbieramy już tych danych. Użycie parametru indexing zostało wycofane i nie ma żadnego wpływu. Nie musisz już wyraźnie rezygnować z tej funkcji, ale zachęcamy do usunięcia tego parametru przy najbliższej okazji.

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

Czy mogę wygenerować obraz mapy za pomocą interfejsu Maps Static API, który będę przechowywać i udostępniać w mojej witrynie?

Nie możesz przechowywać i udostępniać kopii obrazów wygenerowanych za pomocą interfejsu Maps Static API ze swojej witryny. Wszystkie strony internetowe, które wymagają obrazów statycznych, muszą łączyć atrybut src tagu HTML img lub atrybut CSS background-image tagu HTML div bezpośrednio z Maps Static API, aby wszystkie obrazy map były wyświetlane w treści HTML strony internetowej i udostępniane bezpośrednio użytkownikom przez Google.

Limity wykorzystania i płatności

Jak skonfigurować płatności w projekcie?
Zobacz Pierwsze kroki z Google Maps Platform.
Czym jest bezpłatny okres próbny Google Cloud i jak użytkownicy bezpłatnego okresu próbnego mogą przejść na płatne konto?

Bezpłatny okres próbny Google Cloud to 91-dniowy program, który pozwala nowym użytkownikom wypróbować najpopularniejsze usługi Google Cloud, w tym interfejsy API Google Maps Platform (GMP), bez żadnych zobowiązań finansowych. Rejestracja w bezpłatnym okresie próbnym powoduje utworzenie konta rozliczeniowego, na którym znajduje się 300 USD środków na powitanie, które możesz wydać na GMP.

Jeśli nie przejdziesz na płatne konto rozliczeniowe przed upływem 91 dni lub jeśli wydasz 300 USD bezpłatnych środków, Twoje konto rozliczeniowe bezpłatnej wersji próbnej zostanie zamknięte, a wszystkie powiązane z nim projekty i zasoby zostaną zatrzymane. Aby zachować zasoby utworzone podczas bezpłatnego okresu próbnego i zapewnić nieprzerwane działanie usług, przejdź na płatne konto rozliczeniowe. Dowiedz się więcej o bezpłatnej wersji próbnej.

Czy Google Maps Platform ma limity wykorzystania (limity)?

Nie ma maksymalnych limitów dziennych liczby żądań, które możesz wysyłać do usług Google Maps Platform. Jedyne limity wykorzystania dotyczą maksymalnej liczby zapytań na minutę (QPM).

W tabeli poniżej znajdziesz limity wykorzystania poszczególnych interfejsów API. Limity przydziałów możesz wyświetlać i modyfikować w konsoli Cloud.

Interfejs API Limit wykorzystania
Address Validation 6000 zapytań na minutę
Widok z lotu ptaka: wyszukiwanie filmu 180 zapytań na minutę i 100 000 zapytań dziennie
Widok z lotu ptaka: renderowanie filmu 100 zapytań na minutę i 100 zapytań dziennie
Jakość powietrza 6000 zapytań na minutę
Maps JavaScript API: mapy 3D 30 000 zapytań na minutę
Maps JavaScript API: mapy dynamiczne 30 000 zapytań na minutę
Wysokość 6000 zapytań na minutę
Geocoding 3000 zapytań na minutę
Geolokalizacja 6000 zapytań na minutę
Maps Grounding Lite: wyszukiwanie miejsc, sprawdzanie pogody, obliczanie tras 300 zapytań na minutę na narzędzie
Maps Grounding Lite: rozpoznawanie nazw, rozpoznawanie adresów URL Map 600 QPM na metodę,
Map Tiles API: Fragmenty mapy 2D 6000 zapytań na minutę i 15 000 zapytań dziennie
Map Tiles API: kafelki Street View 6000 zapytań na minutę i 15 000 zapytań dziennie
Map Tiles API: fotorealistyczne kafelki 3D 12 000 zapytań na minutę i 10 000 żądań głównych dziennie.
Nawigacja: prośby o ustawienie miejsca docelowego 30 000 zapytań na minutę
Miejsca 6000 zapytań na minutę
Places Aggregate 1200 zapytań na minutę
Pollen 6000 zapytań na minutę
Drogi 30 000 QPM
Trasy: obliczanie tras 3000 zapytań na minutę
Trasy: Compute Routes – Matrix 3000 EPM
Solar 600 zapytań na minutę
Mapy statyczne 30 000 zapytań na minutę
Street View Image API 30 000 zapytań na minutę
Strefa czasowa 30 000 zapytań na minutę
Pogoda 6000 zapytań na minutę

Aby kontrolować wydatki, możesz monitorować wykorzystanie interfejsu API i ustawić limity dzienne dla wszystkich żądań do dowolnego płatnego interfejsu API.

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

Jak obliczany jest koszt wykorzystania?

Przegląd cen usług Google Maps Platform znajdziesz w cenniku.

Więcej informacji o tym, jak rozliczane są interfejsy API Google Maps Platform, znajdziesz w artykule Omówienie płatności i cen w Google Maps Platform.

Jak są zliczane wczytania mapy w Google Maps Platform?

Pojedyncze wczytanie mapy jest naliczane, gdy wystąpi dowolne z tych zdarzeń:

  • Strona internetowa lub aplikacja wyświetla mapę za pomocą interfejsu Maps JavaScript API.
  • Aplikacja żąda pojedynczego obrazu mapy z interfejsu Maps Static API.

Opłaty za panoramy Street View są naliczane oddzielnie od opłat za wczytywanie map:

  • Opłata za statyczną panoramę Street View jest naliczana za każde żądanie wysłane do Street View Static API w celu umieszczenia statycznej (nieinteraktywnej) panoramy Street View.
  • Opłata za dynamiczną panoramę Street View jest naliczana za każde utworzenie instancji obiektu panoramy w aplikacji korzystającej z interfejsu Maps JavaScript API, pakietu Maps SDK na Androida lub pakietu Maps SDK na iOS.

Po wczytaniu przez stronę internetową lub aplikację mapy, statycznego obrazu mapy lub panoramy Street View żadne interakcje użytkownika, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie powodują dodatkowych wczytań mapy ani nie wpływają na limity wykorzystania.

Dodanie znacznika nie spowoduje dodatkowych wczytań mapy, ale może wygenerować opłaty związane z określaniem lokalizacji pinezki (np. wczytanie lub ponowne wczytanie klasy google.maps.Map()).

Jak mogę monitorować wykorzystanie?

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 Wskaźniki lub Limity.

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

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

Więcej informacji znajdziesz w artykułach Raportowanie w Google Maps Platform, Monitorowanie w Google Maps Platform i Ustawianie limitu.

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

Jeśli przekroczysz limity QPM danej usługi Google Maps Platform, interfejs API zwróci komunikat o błędzie. Jeśli będziesz wielokrotnie przekraczać limity, Twój dostęp do interfejsu API może zostać tymczasowo zablokowany.

Jeśli przekroczysz limity QPM żądań lub w inny sposób nadużyjesz usługi, żądania zwrócą konkretny komunikat o błędzie. Jeśli nadal będziesz przekraczać limity, Twój dostęp do Google Maps Platform może zostać zablokowany.

Uwaga: te interfejsy API usług internetowych mają odpowiedniki po stronie klienta dostępne w Maps JavaScript API: Elevation, 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 wysyłać normalne odpowiedzi i zaczęła zwracać tylko kod stanu OVER_QUERY_LIMIT, dopóki nie zostanie ponownie zezwolone na większe wykorzystanie. Może to nastąpić w ciągu kilku sekund, jeśli błąd został odebrany, ponieważ aplikacja wysłała zbyt wiele żądań na minutę.

Jeśli regularnie przekraczasz limity wykorzystania QPM, rozważ zmniejszenie wykorzystania przez optymalizację aplikacji pod kątem bardziej efektywnego korzystania z usług Google Maps Platform lub poproś o zwiększenie limitu. Więcej informacji znajdziesz w przewodniku po optymalizacji.

Moja witryna generuje duży ruch. Czy mogę korzystać z usług Google Maps Platform?

Tak. Zalecamy jednak zapoznanie się z limitami wykorzystania wszystkich usług Google Maps Platform, z których korzysta Twoja aplikacja.

Jeśli masz konto rozliczeniowe, ale przekroczysz limit bezpłatnego wykorzystania i nie masz na koncie rozliczeniowym 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 rozliczane wykorzystanie?

Wykorzystanie jest obliczane na koniec każdego dnia, a cena jest ustalana zgodnie z cennikiem. Na koniec każdego miesiąca forma płatności powiązana z Twoim kontem rozliczeniowym jest obciążana opłatą za całkowite wykorzystanie. Więcej informacji znajdziesz w sekcji Płatności w Google Maps Platform.

Ile kosztuje korzystanie z Google Maps Platform?

Przegląd kosztów poszczególnych interfejsów API znajdziesz w cenniku. Jeśli Twoja aplikacja generuje żądania generowania lub wczytania mapy do wysokości bezpłatnego limitu wykorzystania w danym miesiącu, nie naliczymy opłaty za wykorzystanie. Wykorzystanie, które przekracza limit bezpłatnego wykorzystania, jest obciążane na Twoim koncie rozliczeniowym. Więcej szczegółów znajdziesz w sekcji Płatności w Google Maps Platform.

Czy ceny są dostępne w innych walutach?

W konsoli mogą być dostępne dodatkowe waluty. Gdy wybierzesz inną walutę, stawki zostaną przeliczone z równowartości w USD podanej w naszym arkuszu cen.

Płatności zostały skonfigurowane. Jak mogę wyświetlić rachunek?

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

Dodatkowe zasoby:

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

Google Maps Platform umożliwia ustawianie dziennych limitów żądań i maksymalnych dziennych limitów płatnych. Możesz ograniczyć maksymalny limit dzienny wykorzystania, aby chronić się przed nieoczekiwanymi wzrostami. Możesz też ustawić alerty dotyczące budżetu, aby otrzymywać e-maile z powiadomieniami, gdy obciążenia konta rozliczeniowego osiągną ustawiony przez Ciebie próg.

Ustawianie maksymalnego dziennego limitu obciążenia:

Aby uniknąć wysokich rachunków, możesz ustawić dzienny limit wykorzystania, który zabezpieczy Cię przed nieoczekiwanym wzrostem użycia. Możesz zmienić ten limit w konsoli Cloud.

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

Skonfiguruj alerty dotyczące budżetu, aby wysyłać e-maile z powiadomieniami do administratorów rozliczeń, gdy opłaty na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg. Gdy szacowane opłaty na koncie rozliczeniowym przekroczą 50%, 90% i 100% progu, administratorzy rozliczeń otrzymają e-maile z powiadomieniami.

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 abonament płatności według wykorzystania. To konto przejściowe umożliwiło Google przyznanie tym klientom jednorazowych środków, dzięki którym mogli oni nadal korzystać z Google Maps Platform do limitu bezpłatnego poziomu. Po przekroczeniu tego limitu konto rozliczeniowe zostanie zamknięte i utracisz dostęp do usługi. Aby uniknąć przerw w działaniu usługi, zalecamy skonfigurowanie własnego konta rozliczeniowego i dalsze korzystanie z miesięcznego bezpłatnego limitu wykorzystania. 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 został ustawiony na 1 żądanie dziennie? Jak mogę zwiększyć ten limit?

Jeśli nie utworzysz konta rozliczeniowego i nie połączysz go z projektem, interfejsy API Google Maps Platform będą ograniczone do 1 żądania dziennie. Możesz zwiększyć limit, tworząc i dołączając konto rozliczeniowe. Aby dowiedzieć się, jak to zrobić, przeczytaj artykuł Pierwsze kroki z Google Maps Platform.

Po utworzeniu i dołączeniu konta rozliczeniowego dzienny limit zostanie usunięty. Możesz ustawić limit w konsoli Cloud, aby uniknąć nieoczekiwanych wydatków.

Otrzymałem(-am) powiadomienie o naruszeniu zasad dotyczących płatności. Jak rozwiązać ten problem?

Otrzymujesz to powiadomienie, ponieważ ustaliliśmy, że na Twoim koncie używanych jest kilka kont rozliczeniowych. Stanowi to naruszenie warunków Google, które zostały określone w Warunkach korzystania z 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 związanych z kontem rozliczeniowym.

Korzystanie z Google Maps Platform

Których kluczy lub danych uwierzytelniających należy używać w przypadku różnych usług Map?

Za każdym razem, gdy korzystasz z usług Google Maps Platform, musisz dołączyć klucz interfejsu API, aby zweryfikować żądanie. Google Maps Platform jest dostępna w aplikacjach na Androida, iOS i aplikacjach internetowych oraz w usługach internetowych HTTP.

Klucz interfejsu API:

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

Podpis cyfrowy:

  • Podpis cyfrowy jest generowany przy użyciu klucza tajnego do podpisywania URL-a dostarczonego przez Google. Podpisy cyfrowe są używane w interfejsach Maps Static API i Street View Static API.

Ograniczenia:

  • Ograniczenia kluczy interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API, aby zwiększyć bezpieczeństwo. Więcej informacji znajdziesz w artykule o sprawdzonych metodach dotyczących bezpieczeństwa interfejsów API.
  • Do klucza interfejsu API możesz dodać ograniczenie aplikacji. Po ograniczeniu klucz będzie działać tylko na platformach, które obsługują dany typ ograniczenia. Dostępne są 4 typy ograniczeń aplikacji. Interfejsy API, które wymuszają ten sam typ ograniczenia, mogą używać tego samego klucza z ograniczeniami.
  • Możesz też dodać do klucza interfejsu API ograniczenie dotyczące interfejsu API. Więcej informacji znajdziesz w artykule Uzyskiwanie, dodawanie i ograniczanie klucza interfejsu API.

W tabeli poniżej znajdziesz klucz/dane logowania i ograniczenie aplikacji dla każdego interfejsu API/pakietu SDK Google Maps Platform.

API/SDK Ograniczenie dotyczące danych logowania i 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
Navigation SDK na Androida Klucz interfejsu API z ograniczeniem dotyczącym Androida1
Maps SDK na iOS Klucz interfejsu API z ograniczeniem dotyczącym iOS1
Pakiet SDK Miejsc na iOS Klucz interfejsu API z ograniczeniem dotyczącym iOS1
Pakiet SDK do nawigacji na iOS Klucz interfejsu API z ograniczeniem dotyczącym iOS1
Maps JavaScript API Klucz interfejsu API z ograniczeniem odsyłającego 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 interfejsu API z ograniczeniem odsyłacza HTTP1 + podpis cyfrowy2
Street View Static API Klucz interfejsu API z ograniczeniem odsyłacza HTTP1 + podpis cyfrowy2
Maps Embed API Klucz interfejsu API z ograniczeniem odsyłającego HTTP1
Address Validation API Klucz interfejsu API z ograniczeniem adresu IP1
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
Places Aggregate API Klucz interfejsu API z ograniczeniem adresu IP1
Roads API Klucz interfejsu API z ograniczeniem adresu IP1
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
Weather API Klucz interfejsu API z ograniczeniem adresu IP1
1 Ograniczenia kluczy interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API, aby zwiększyć bezpieczeństwo.
2 W zależności od sposobu użycia interfejsy Maps Static API i Street View Static API mogą wymagać podpisu cyfrowego. Niezależnie od sposobu użycia zdecydowanie zalecamy korzystanie zarówno z klucza interfejsu API, jak i podpisu cyfrowego do uwierzytelniania żądań.
Jak zmienić typ ograniczenia klucza z odsyłającego adresu HTTP na ograniczenie adresu IP?

Ważne: jeśli używasz dowolnego interfejsu API usługi sieciowej z kluczem interfejsu API, który ma ograniczenia dotyczące stron odsyłających, żądania będą kończyć się niepowodzeniem i wyświetleniem komunikatu o błędzie: „Klucze interfejsu API nie mogą mieć ograniczeń dotyczących stron odsyłających, gdy są używane z tym interfejsem API”. Zamiast tego używaj klucza interfejsu API z ograniczeniami adresów IP.

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

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

Aby zmienić ograniczenie klucza interfejsu API z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP:

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

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

Możesz też sprawdzić, w której wersji Google Maps Platform dany błąd został wprowadzony i naprawiony, korzystając z narzędzia Issue Tracker Google Maps Platform na stronie:

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

Jak mogę asynchronicznie wczytać interfejs API na stronę 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 sekcji Pierwsze kroki w dokumentacji interfejsu Maps JavaScript API.

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

Domyślnie interfejs API próbuje wczytać 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 obsługiwane języki. 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
eu 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
ca kataloński mr marathi
zh chiński mn mongolski
zh-CN chiński (uproszczony) ne nepalski
zh-HK chiński (Hongkong) no norweski
zh-TW chiński (tradycyjny) pl polski
godz. 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 (cyrylica)
et estoński sr-Latn serbski (alfabet łaciński)
fa perski si syngaleski
fi fiński sk słowacki
fil filipiński sl słoweński
fr francuski es hiszpański
fr-CA francuski (Kanada) es-419 hiszpański (Ameryka Łacińska)
gl galicyjski sw suahili
ka gruziński sv szwedzki
de niemiecki ta tamilski
el grecki te telugu
gu gudżarati th tajski
iw hebrajski tr turecki
hi hindi uk ukraiński
hu węgierski ur urdu
jest islandzki uz uzbecki
id indonezyjski vi wietnamski
it włoski zu zulu

W tej przykładowej aplikacji możesz zobaczyć, jak będzie wyglądać mapa w każdym z wymienionych powyżej języków.

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

Dostęp do wszystkich interfejsów Google Maps Platform można i powinno się uzyskiwać przez HTTPS. Aby zapewnić zgodność aplikacji z przyszłymi standardami, zdecydowanie zalecamy używanie protokołu TLS 1.3 w przypadku HTTPS. Chociaż starsze wersje TLS są nadal obsługiwane, odradzamy korzystanie z wycofanych starszych wersji TLS 1.0 i 1.1.

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

Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących migracji głównego urzędu certyfikacji Google Maps Platform i najczęstszych pytaniach dotyczących Google Trust Services.

Jak zgłosić błąd lub poprosić o nową funkcję w Google Maps Platform?

Jeśli zauważysz zachowanie, które Twoim zdaniem może być błędem, zacznij od zgłoszenia go na odpowiednim forum. Dzięki temu inni deweloperzy będą mogli zweryfikować błąd i wykluczyć potencjalne problemy z kodem.

Aby poprosić o dodanie funkcji, najpierw zgłoś to na odpowiednim forum, aby upewnić się, że rozwiązanie spełniające Twoje wymagania nie jest już dostępne.

Gdy potwierdzisz, że udało Ci się zidentyfikować 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 dodanie funkcji za pomocą narzędzia Issue Tracker Google Maps Platform.

Zanim dodasz błąd lub prośbę o dodanie funkcji do narzędzia Issue Tracker, sprawdź, czy nie zostały już dodane. Jeśli tak, możesz oznaczyć problem gwiazdką, aby wyrazić swoje zainteresowanie i otrzymywać powiadomienia o aktualizacjach.

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

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

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

Zespół Google ds. relacji z programistami jest obecny na Stack Overflow – witrynie z pytaniami i odpowiedziami dla programistów, którą można wspólnie edytować. To świetne miejsce, aby zadawać pytania techniczne dotyczące tworzenia i utrzymywania aplikacji Map Google. Więcej informacji o zadawaniu pytań na Stack Overflow znajdziesz na stronie Pomoc.

Aby uzyskać najlepsze wyniki, podczas wysyłania prośby o pomoc pamiętaj o tych kwestiach:

  • Przeszukaj bieżące dyskusje. Być może ktoś inny miał podobny problem i znalazł rozwiązanie.
  • Jeśli to możliwe, prześlij link do swojej witryny. Fragmenty kodu publikuj tylko wtedy, gdy nie można go wyświetlić online.
  • Podaj wszystkie istotne informacje, w tym wersje przeglądarek, błędy i wszystkie inne fakty, które mogą być przydatne podczas rozwiązywania tego problemu.

Błędy i rozwiązywanie problemów

Co oznacza ten błąd?

Jeśli podczas wczytywania lub uruchamiania interfejsów API Map Google wystąpi błąd, skorzystaj z tych linków, aby znaleźć wyjaśnienia kodów błędów:

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

W pewnych okolicznościach może zostać wyświetlona przyciemniona mapa lub „negatyw” zdjęcia Street View ze znakiem wodnym z tekstem „for development purposes only” (tylko do celów programistycznych). Zwykle oznacza to problemy z kluczem interfejsu API lub płatnościami. 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, wykonaj te czynności:


Jak rozwiązać problemy z kodami błędów: OVER_DAILY_LIMIT lub OVER_QUERY_LIMIT?
Te kody błędów mogą być zwracane z tych powodów:
  • W żądaniu brakuje klucza interfejsu API.
  • Podany klucz interfejsu API jest nieprawidłowy.
  • Projekt nie ma dołączonego konta rozliczeniowego.
  • Przekroczono samodzielnie nałożony limit wykorzystania.
  • Podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność).
  • Przekroczono limity 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, wykonaj te czynności:

Jak rozwiązać problemy z kodami błędów: kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Jeśli widzisz kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED, być może używasz wycofanej wersji pakietu SDK Miejsc na Androida lub pakietu SDK Miejsc na iOS. Więcej informacji i nowe pakiety SDK znajdziesz na stronie https://goo.gle/places-sdk-deprecation.
Jak rozwiązać problem związany z błędem „Ten adres IP, ta witryna lub ta aplikacja mobilna nie ma uprawnień do używania tego klucza interfejsu API”?

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

  • Włączono ograniczenia adresu IP (serwera) dla klucza interfejsu API, a nieautoryzowany adres IP próbuje wysłać żądanie.
  • W kluczu interfejsu API masz włączone ograniczenia dotyczące strony odsyłającej HTTP (witryny), a nieautoryzowana strona odsyłająca próbuje wysłać żądanie.
  • Ograniczono użycie do aplikacji na Androida przez ustawienie nazwy pakietu i odcisku cyfrowego, a nieautoryzowana aplikacja na Androida próbuje wysłać żądanie.
  • Żądania z aplikacji na iOS zostały ograniczone przez określenie identyfikatorów pakietów, a nierozpoznana aplikacja na iOS próbuje wysłać żądanie.
  • Ten błąd mógł wystąpić, jeśli używasz dowolnego z interfejsów API usług internetowych z kluczem interfejsu API z ograniczeniami strony odsyłającej HTTP. Żądania do tych interfejsów API powinny być identyfikowane za pomocą klucza interfejsu API z ograniczeniami adresu IP. Zmień typ ograniczenia klucza z ograniczenia odsyłającego adresu HTTP na ograniczenie adresu IP. Więcej informacji o ograniczaniu kluczy interfejsu API znajdziesz w artykule o sprawdzonych metodach dotyczących kluczy interfejsu API.

Wyświetlanie i edytowanie danych logowania klucza interfejsu API

Aby wyświetlić klucze interfejsu API i zarządzać ograniczeniami:

  1. W konsoli Cloud otwórz stronę Dane logowania.
  2. Wybierz projekt zawierający klucz interfejsu API, który chcesz sprawdzić.
  3. Aby wyświetlić szczegóły danych logowania, w tym ograniczenia ustawione dla klucza, na liście kluczy interfejsu API kliknij nazwę klucza.
  4. Wyświetlą się pełne dane logowania wybranego klucza interfejsu API, w tym wszystkie ograniczenia skonfigurowane dla tego klucza. W razie potrzeby możesz zmienić, usunąć lub zaktualizować ograniczenia.
Jak rozwiązać błąd „Klucze interfejsu API z ograniczeniami odsyłacza nie mogą być używane z tym interfejsem API”?

Używasz dowolnego interfejsu API usługi internetowej z kluczem interfejsu API ograniczonym do strony odsyłającej HTTP. Ze względów bezpieczeństwa interfejsy API usług internetowych muszą używać kluczy interfejsu 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 klucz jest już używany z Maps JavaScript API.

Usługi Google Maps Platform

Muszę przekonwertować adresy na pary współrzędnych szerokości i długości geograficznej. 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 to: google.maps.Geocoder.

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

W jakich krajach jest dostępne geokodowanie?

Aby zobaczyć kraje obsługiwane przez geokodery Google Maps Platform, zapoznaj się z danymi o zasięgu Map Google.

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

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

Geokoder interfejsu API i geokoder Map Google czasami używają 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 czasem wyniki mogą się zmieniać lub poprawiać.

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

Geokoder jest przeznaczony do mapowania adresów ulic na współrzędne geograficzne. Dlatego zalecamy formatowanie żądań geokodera zgodnie z tymi wytycznymi, aby zmaksymalizować prawdopodobieństwo uzyskania prawidłowego wyniku:

  • Adresy należy podawać zgodnie z formatem używanym przez krajową pocztę w danym kraju.
  • nie podawaj dodatkowych elementów adresu, takich jak nazwy firm, numery lokali, numery pięter czy numery apartamentów, które nie są uwzględnione w adresie zdefiniowanym przez urząd pocztowy danego kraju. Może to spowodować, że odpowiedzi będą zawierać ZERO_RESULTS.
  • Sformatuj plus kody w sposób pokazany tutaj (znaki plusa są zastępowane w adresie URL przez %2B, a spacje przez %20):
    • kod globalny to 4-znakowy numer kierunkowy 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źnie określoną lokalizacją (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Jeśli to możliwe, użyj numeru domu, a nie nazwy budynku.
  • Jeśli to możliwe, używaj numerów ulic zamiast podawania skrzyżowań.
  • nie podawaj „wskazówek”, takich jak pobliskie punkty orientacyjne.
Jak sformatować adres w USA przy numerowanej autostradzie na potrzeby geokodowania?

Geokoder Google Maps Platform wymaga, aby numerowane autostrady w USA były podawane w adresach w następujący sposób:

  • Drogi powiatowe: "Co Road NNN", gdzie NNN to numer drogi, np. "Co Road 82"
  • Drogi stanowe: "State NNN", gdzie State to pełna nazwa stanu, a NNN to numer drogi, np. "California 82"
  • Autostrady w USA: "US NNN", gdzie NNN to numer autostrady. np. "US 101"
  • Autostrady międzystanowe w USA: "Interstate NNN", gdzie NNN to numer autostrady, np. "Interstate 280"
Kiedy należy używać klasy geokodera interfejsu API, a kiedy usługi geokodowania HTTP?

Zapoznaj się z dokumentem Strategie geokodowania, który szczegółowo opisuje zalety i ograniczenia różnych strategii geokodowania.

Jak podawać wskazówki dojazdu za pomocą Google Maps Platform?

Usługa obliczania tras w interfejsie Routes API umożliwia podawanie wskazówek dojazdu w przypadku podróży jedno- i wieloetapowych. Opcje wyznaczania trasy pomagają kształtować wskazówki dojazdu za pomocą trybu podróży (jazda samochodem), pojedynczej trasy lub zestawu tras oraz ograniczeń (brak dróg płatnych). Te usługi są dostępne w tych formach:

Interfejs żądań/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 są dostępne wskazówki dojazdu?

Aby sprawdzić, w których krajach są dostępne wskazówki dojazdu w usługach Google Maps Platform, zapoznaj się z danymi o 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 są dostępne wskazówki dojazdu transportem publicznym?

Routes API obsługuje wszystkich partnerów Transportu publicznego Google z wyjątkiem Indian Railway Catering and Tourism Corporation i partnerów w Japonii.

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

Nie ma limitu liczby znaczników ani wierzchołków ścieżki obsługiwanych przez Maps Static API. W przypadku ikon niestandardowych w jednym żądaniu można określić maksymalnie 5 unikalnych ikon, ale każdą z nich można wykorzystać na mapie wielokrotnie.

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

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

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

Jak zgłosić problem z mapą podstawową Google?
Prześlij opinię w Mapach Google, jeśli informacje na mapie są nieprawidłowe lub niekompletne, np.:
  • 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 muszą zostać usunięte ze względów prawnych, prześlij wniosek prawny.

W przypadku pilnych lub wymagających szybkiej reakcji próśb utwórz zgłoszenie do zespołu pomocy ze szczegółowymi informacjami o tym, co należy naprawić.

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

Niektóre funkcje po stronie klienta są instrumentowane, aby zgłaszać powodzenie lub niepowodzenie w celu obliczenia docelowego poziomu usług (SLO). Te informacje są wysyłane do Google pod adresem maps.googleapis.com/maps_api_js_slo/log w wywołaniach, które rejestrują informacje o SLO. Te informacje obejmują stan powodzenia, czas oczekiwania oraz wersję/kanał używanego interfejsu Maps JavaScript API. Wywołania mogą być grupowane w celu zwiększenia wydajności. Być może musisz zezwolić na maps.googleapis.com w standardzie Content Security Policy, aby te wywołania nie były blokowane na poziomie przeglądarki. 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 interfejs Maps JavaScript API będzie działać po wczytaniu?

Stronę, która wczytuje interfejs Maps JavaScript API, musisz odświeżać co najmniej raz na 5 dni.

Google Maps SDK na iOS

Jak rozwiązać błąd: kGMSPlacesRateLimitExceeded?
Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK for iOS. Wersja 2.7.0 pakietu Places SDK for iOS została wyłączona i nie jest już dostępna. Zaktualizuj aplikację, aby jak najszybciej zacząć korzystać z najnowszej wersji. 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 podczas debugowania na urządzeniach z systemem iOS 8.x wystąpią problemy, wykonaj te czynności, aby wyłączyć przechwytywanie klatek GPU w schemacie XCode, którego używasz:

  1. W XCode wybierz Product (Produkt), Scheme (Schemat), Manage Schemes (Zarządzaj schematami).
  2. Wybierz schemat i kliknij Edytuj….
  3. Ustaw opcję Przechwytywanie klatek GPU na Wyłączone. Pamiętaj, że ta opcja może nie być dostępna na wszystkich urządzeniach.
Opcja przechwytywania klatek GPU w Xcode na stronie ogólnego urządzenia z iOS
Jaki wpływ na pakiet SDK Map Google na iOS mają zaokrąglone i szersze ekrany?

Począwszy od modelu iPhone X, iPhone'y mają ekran z zaokrąglonymi rogami, wycięciem u góry na obudowę czujnika urządzenia i wskaźnikiem u dołu ekranu umożliwiającym dostęp do ekranu głównego. W pakiecie SDK na iOS w wersji 11.0 firma Apple dodała interfejs API Safe Area, który umożliwia deweloperom umieszczanie elementów w obszarze, w którym nie zostaną one przycięte 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ętrz i link do zgłaszania problemów. W wersji 2.4 te elementy wizualne i elementy sterujące mogą zostać przycięte przez nowy kształt ekranu. W trybie poziomym selektor piętra może zostać przycięty przez wycięcie lub wskaźnik przycisku ekranu głównego.

Wraz z wydaniem pakietu Google Maps iOS SDK 2.5 te problemy z układem są rozwiązywane automatycznie. Gdy aplikacja jest używana na iPhonie X lub nowszym, dopełnienie w GMSMapView i GMSPanoramaView jest zwiększane, aby elementy wizualne nie były przycinane.

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

Jeśli zaprojektowany przez Ciebie interfejs nie działa z naszym domyślnym dostosowaniem, wprowadziliśmy nową właściwość GMSMapView o nazwie paddingAdjustmentBehavior. Użyj GMSMapView, aby wybrać jedno z 3 zachowań dostosowywania dopełnienia: „Zawsze” (domyślnie), „Automatycznie” i „Nigdy”.

Jeśli GMSMapView jest skonfigurowany tak, aby zawsze używać dopełnienia, zawsze będzie dodawać do dopełnienia wstawki bezpiecznego obszaru. To ustawienie pozwala zaprojektować interfejs przy założeniu, że wszystkie elementy są umieszczane od krawędzi bezpiecznego obszaru. Jest to wartość domyślna.

Jeśli GMSMapView jest ustawiony na używanie „automatycznego” wypełnienia, zawsze będzie wybierać większe wypełnienie lub bezpieczny obszar. To ustawienie pozwala dodać odstęp od krawędzi ekranu, jednocześnie zapewniając, że wszystkie elementy pozostaną w bezpiecznym obszarze.

Jeśli GMSMapView ma ustawione zachowanie dopełnienia „Nigdy”, nigdy nie doda do dopełnienia wstawek bezpiecznego obszaru. Takie zachowanie występowało przed wersją 2.5 i może być przydatne, jeśli dopełnienie uwzględnia już bezpieczny obszar lub jeśli inne zachowania nie działają prawidłowo z Twoim interfejsem. Odpowiedzialność za to, aby logo Google i informacje o prawach autorskich były zawsze widoczne, spoczywa na Tobie, zgodnie z Warunkami korzystania z Google Maps Platform.

Z kolei GMSPanoramaView nie ma opcjonalnej właściwości dopełnienia. Oznacza to, że nie ma dopełnienia do dostosowania, a GMSPanoramaView zawsze zastosuje niezbędne dopełnienie, aby wszystkie elementy wizualne znajdowały się w bezpiecznym obszarze.

Google Maps SDK na Androida

Jak rozwiązać błąd: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK for Android. Wersja pakietu Places SDK na Androida w usługach Google Play została wyłączona i nie jest już dostępna. Zaktualizuj aplikację, aby jak najszybciej zacząć korzystać z najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.
W aplikacji zamiast mapy wyświetlają się tylko puste szare kafelki. Jak rozwiązać ten problem?

Częstą przyczyną wyświetlania pustych szarych kafelków zamiast mapy są problemy z uwierzytelnianiem. Aby rozwiązać te problemy, możesz wykonać poniższe czynności, korzystając z narzędzia adb logcat.

  1. Upewnij się, że masz zainstalowane narzędzie adb. Jeśli nie, postępuj zgodnie z przewodnikiem po Android adb.
  2. Zainstaluj aplikację, w której występuje problem, na urządzeniu lub w emulatorze Androida. Jeśli używasz Android Emulatora, upewnij się, że w jego ustawieniach jest uwzględniony Sklep Play.
  3. W terminalu Android Studio uruchom polecenie adb logcat -e "Google Maps Android API". Spowoduje to wyświetlenie tylko tych wierszy, w których komunikat logu pasuje do „Google Maps Android API” (opcjonalnie możesz zapisać log w pliku tekstowym, dodając: > logcat.txt).
  4. Odtwórz problem na urządzeniu i sprawdź, czy nie występują typowe błędy, takie jak:
    • W manifeście podano nieprawidłowy lub niezamierzony klucz 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 dodano nieprawidłowy odcisk cyfrowy SHA-1.
    • Zależności usług Google Play nie są uwzględnione w pliku build.gradle.
Czy pakiet Google Maps SDK na Androida wymaga akceleracji sprzętowej?
Tak, aby uniknąć problemów z ładowaniem mapy, w pliku AndroidManifest.xml aplikacji musisz ustawić hardwareAccelerated na true.
Więcej informacji znajdziesz na stronie poświęconej akceleracji sprzętowej w dokumentacji dla deweloperów aplikacji na Androida.

Podpisywanie URL

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

Zdecydowanie odradzamy podpisywanie adresów URL za pomocą JavaScriptu, ponieważ spowoduje to ujawnienie klucza tajnego do podpisywania URL-a użytkownikom. Dlatego podpisy powinny być generowane tylko przez komponenty po stronie serwera.

Dlaczego w odpowiedzi na żądania wysyłane do usługi internetowej interfejsu API Map Google otrzymuję błąd HTTP 403 Forbidden?

Odpowiedź HTTP 403 wskazuje na problem z uprawnieniami, prawdopodobnie dlatego, że nie udało się zweryfikować podpisu dla tego żądania. Oto możliwe przyczyny:

  1. Podpis został podany, ale jest nieprawidłowy w przypadku tego żądania.
  2. Żądanie określa klucz interfejsu API abonamentu Premium Google Maps Platform, ale nie określa podpisu, a wywoływana usługa wymaga, aby żądania wysyłane przy użyciu klucza interfejsu API zawierały prawidłowy podpis.
  3. Podano podpis, ale nie podano powiązanego klucza interfejsu API abonamentu Google Maps Platform Premium.