Najczęstsze pytania dotyczące Google Maps Platform

Pierwsze kroki

Wyjaśnienia dotyczące warunków korzystania z usługi

Limity wykorzystania i płatności

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 osadzanie Map Google w aplikacjach mobilnych i na stronach internetowych lub pobieranie z nich danych. 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 rozpocząć korzystanie 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 selektora interfejsu API.

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

Zapoznaj się z przewodnikami Omówienie, Dla programistów i Wprowadzenie dotyczącymi konkretnego interfejsu API lub pakietu SDK, który Cię interesuje. Zapoznaj się na przykład z przewodnikami po pakiecie SDK Map na Androida lub interfejsie Maps JavaScript API.

Które kraje obejmuje Google Maps Platform?

Zespół Map Google stale udostępnia nowe dane map i zwiększa zasięg międzynarodowy. Najnowsze informacje o zasięgu znajdziesz w danych o zasięgu Map Google. Dane możesz filtrować za pomocą pola filtra u góry strony. Dane o zasięgu mogą się zmieniać, 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 programowania i korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.

Jak udostępniać aplikacje Map na urządzeniach mobilnych?

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

Aby zintegrować mapy z aplikacją 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 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 nadają się do korzystania z interfejsu Maps JavaScript API, interfejs Maps Static API dostarcza obrazy map w formatach GIF, JPG i PNG, w tym markery i linie łamane. Pamiętaj, że korzystanie z interfejsu Maps Static API poza aplikacjami opartymi na przeglądarce wymaga połączenia obrazu mapy z Mapami Google.

Jakie przeglądarki internetowe obsługują interfejsy Maps JavaScript API i Maps Embed API?

Interfejsy Maps JavaScript API i Maps Embed API obsługują następujące przeglądarki:

Komputer
  • Aktualna wersja przeglądarki Microsoft Edge (Windows), z wyłączeniem trybu IE.
  • Dwie najnowsze stabilne wersje przeglądarki Firefox (Windows, macOS, Linux).
  • Dwie najnowsze stabilne wersje Chrome (Windows, macOS, Linux).
  • dwie najnowsze główne stabilne wersje Safari (macOS);
Android
  • Aktualna wersja Chrome na Androidzie 4.1 lub nowszym.
  • Chrome WebView na Androidzie 4.4 lub nowszym.
iOS
  • 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 niespójna w przypadku popularnych przeglądarek.

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

Aby otrzymywać najnowsze informacje o różnych usługach Google dla programistów, zasubskrybuj bloga Google Maps Platform.

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

Informacje o dostępnych opcjach pomocy znajdziesz na stronie Pomoc i zasoby dotyczące Google Maps Platform.

Kiedy dostępna jest pomoc techniczna?
Zespół pomocy jest dostępny przez 5 dni w tygodniu, 24 godziny na dobę (od poniedziałku od 9:00 czasu tokijskiego do piątku do 17:00 czasu pacyficznego), z wyjątkiem świąt regionalnych w przypadku problemów z „niedostępnością usługi”.
Jak mogę odzyskać dostęp do konta Google?

Jeśli nie masz dostępu do swojego konta Google (np. joe@mycompany.com lub joe@gmail.com), możesz spróbować przywrócić dostęp do konta, 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 wdrożeniem 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 procesorem Arm?

Tworzenie aplikacji na nowych komputerach Mac z procesorem Arm jest możliwe, ale wymaga kompilowania i uruchamiania na fizycznym urządzeniu z iOS. Jest to tymczasowe ograniczenie, ponieważ pracujemy nad dodaniem większej obsługi tworzenia aplikacji na symulatorach.

Wyjaśnienia dotyczące warunków 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 Google Maps Platform?

Możesz używać Google Maps Platform w swoich aplikacjach, o ile Twoja witryna spełnia Warunki 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, w których można kupić narkotyki w danym mieście, lub inne nielegalne działania. Dbamy też o prywatność użytkowników, dlatego nie należy używać Platformy Map Google do identyfikowania prywatnych informacji o osobach.

Przed opracowaniem i uruchomieniem aplikacji skonsultuj się z własnym doradcą prawnym, aby sprawdzić, czy jest ona zgodna z Warunkami korzystania z Google Maps Platform. Inżynierowie Google mogą jedynie udzielać pomocy technicznej i nie mają uprawnień do udzielania porad prawnych. Google zastrzega sobie prawo do zawieszenia lub zakończenia świadczenia usługi w dowolnym momencie, dlatego dokładnie zapoznaj się z Warunkami 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 kafelków mapy ani zdjęć satelitarnych za pomocą żadnego mechanizmu innego niż Google Maps Platform (np. tworząc własny interfejs API map lub używając skryptu do pobierania zbiorczego kafelków). Jeśli aplikacja będzie uzyskiwać dostęp do kafelków poza Google Maps Platform, dostęp ten zostanie zablokowany. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform.

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

Wyświetlanie danych w czasie rzeczywistym (śledzenie) w usługach Google Maps Platform nie podlega ograniczeniom, 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, z usług Google Maps Platform można teraz korzystać w aplikacjach innych niż internetowe, pod warunkiem że są one zgodne z pozostałymi ograniczeniami określonymi w Warunkach korzystania z usługi Google Maps Platform.

Interfejs Maps JavaScript API jest obsługiwany tylko w  obsługiwanych przeglądarkach.

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

Tak, usługi Mapy, Trasy, Miejsca i Środowisko Google 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 Twoja aplikacja generuje dokument w formie elektronicznej lub drukowanej, nie może on zawierać żadnych danych z Google Maps Platform, w tym obrazów. Więcej informacji znajdziesz w sekcji „Zakaz pobierania danych” w Warunkach korzystania z Google Maps Platform.

Jak mogę zrezygnować z wyświetlania moich treści w wynikach wyszukiwania Google?

Nie zbieramy już tych danych. Parametr indexing został wycofany i nie ma już żadnego wpływu. Nie musisz już wyraźnie rezygnować z tej funkcji, ale zachęcamy do usunięcia tego parametru jak najszybciej.

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, a następnie przechowywać go i wyświetlać w mojej witrynie?

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

Limity wykorzystania i płatności

Jak skonfigurować płatności w projekcie?
Zobacz Pierwsze kroki w Google Maps Platform.
Jak klienci korzystający z bezpłatnego okresu próbnego Google Cloud mogą przejść na konto płatne?
Poziom bezpłatny Google Cloud umożliwia klientom korzystanie z bezpłatnej wersji próbnej z kredytem w wysokości 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 przejść na konto płatne, 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 maksymalnych dziennych limitów liczby żądań, które możesz wysyłać do usług Google Maps Platform. Jedynym ograniczeniem jest maksymalna liczba zapytań na minutę (QPM).

W tabeli poniżej podano limit wykorzystania każdego interfejsu API. Limity możesz wyświetlać i modyfikować w konsoli Google Cloud.

Interfejs API Limit wykorzystania
Weryfikacja adresów 6000 QPM
Widok z lotu ptaka: wyszukiwanie filmu 180 QPM i 100 tys. QPD
Widok z lotu ptaka: renderowanie filmu 100 QPM i 100 QPD
Jakość powietrza 6000 QPM
Maps JavaScript API: mapy 3D 30 000 QPM
Maps JavaScript API: mapy dynamiczne 30 000 QPM
Wysokość 6000 QPM
Geokodowanie 3000 QPM
Geolokalizacja 6000 QPM
Map Tiles API: fragmenty mapy 2D 6000 QPM i 15 000 QPD
Map Tiles API: kafelki Street View 6000 QPM i 15 000 QPD
Map Tiles API: fotorealistyczne kafelki 3D 12 000 zapytań na minutę i 10 000 żądań głównych dziennie.
Nawigacja: zapytania o trasę 30 000 QPM
Miejsca 6000 QPM
Places Aggregate 1200 QPM
Pyłek 6000 QPM
Drogi 30 000 QPM
Trasy: wyznaczanie tras 3000 QPM
Trasy: obliczanie macierzy tras 3000 EPM
Panele słoneczne 600 QPM
Mapy statyczne 30 000 QPM
Street View Image API 30 000 QPM
Strefa czasowa 30 000 QPM
Pogoda 6000 QPM

Aby kontrolować wydatki, możesz monitorować wykorzystanie interfejsu API i ustawiać limity dzienne dla wszystkich żądań kierowanych 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?

Aby zapoznać się z cenami usług Google Maps Platform, zobacz listę cen.

Więcej informacji o tym, jak naliczane są opłaty za interfejsy API Google Maps Platform, znajdziesz w tym artykule.

Jak są zliczane wczytania map na platformie Google Maps Platform?

Pojedyncze wczytanie mapy jest naliczane, gdy:

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

Panoramy Street View są rozliczane oddzielnie od wczytań mapy:

  • Za statyczną panoramę Street View pobierana jest opłata za każde żądanie do interfejsu Street View Static API dotyczące 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.

Gdy strona internetowa lub aplikacja wczyta mapę, statyczny obraz mapy lub panoramę Street View, interakcje użytkownika z nią, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie generują dodatkowych wczytań mapy ani nie wpływają na limity wykorzystania.

Dodanie znacznika nie spowoduje dodatkowego wczytywania mapy, ale może generować opłaty związane ze sposobem określania lokalizacji pinezki (np. wczytywanie lub ponowne wczytywanie klasy google.maps.Map()).

Jak mogę monitorować wykorzystanie?

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

  1. Wybierz projekt, który zawiera 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 o płatnościach za cały projekt, wykonaj te czynności:

  1. Jeśli jeszcze nie masz skonfigurowanych płatności, zrób to teraz.
  2. Otwórz stronę płatności 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 Google Maps Platform i Ustawianie limitu wykorzystania.

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

Jeśli przekroczysz limity zapytań na minutę w przypadku danego produktu Google Maps Platform, interfejs API zwróci komunikat o błędzie. Jeśli wielokrotnie przekroczysz limity, Twój dostęp do interfejsu API może zostać tymczasowo zablokowany.

Jeśli przekroczysz limity zapytań na minutę lub w inny sposób będziesz nadużywać usługi, żądania będą zwracać konkretny 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ą odpowiedniki w postaci usług po stronie klienta dostępnych w Maps JavaScript API: Elevation i Geocoding.

Przekroczono limity wykorzystania

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

Ten komunikat oznacza, że usługa internetowa przestała zwracać normalne odpowiedzi i zaczęła zwracać tylko kod stanu OVER_QUERY_LIMIT, dopóki nie będzie można ponownie korzystać z niej w większym zakresie. Może to nastąpić w ciągu kilku sekund, jeśli błąd został zwrócony, ponieważ aplikacja wysłała zbyt wiele żądań na minutę.

Jeśli regularnie przekraczasz limity wykorzystania zapytań na minutę, rozważ zmniejszenie wykorzystania przez optymalizację aplikacji pod kątem bardziej efektywnego korzystania z usług Platformy Map Google 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, na których opiera się Twoja aplikacja.

Jeśli masz konto rozliczeniowe, a 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 naliczane wykorzystanie?

Wykorzystanie jest obliczane na koniec każdego dnia, a ceny są podane w cenniku. Na koniec każdego miesiąca łączna ilość wykorzystanych zasobów jest obciążana na formę płatności powiązaną z Twoim kontem rozliczeniowym. Więcej informacji znajdziesz w artykule Płatności za Google Maps Platform.

Ile kosztuje korzystanie z Google Maps Platform?

Przegląd kosztów poszczególnych interfejsów API znajdziesz na liście cen. Jeśli Twoja aplikacja generuje w danym miesiącu liczbę żądań lub wczytań mapy nieprzekraczającą limitu bezpłatnego wykorzystania, nie naliczymy opłaty za wykorzystanie. Wykorzystanie przekraczające limit bezpłatnego wykorzystania jest obciążane na Twoim koncie rozliczeniowym. Więcej informacji znajdziesz w artykule Płatności za Google Maps Platform.

Czy ceny są dostępne w innych walutach?

Dodatkowe waluty mogą być dostępne w konsoli. Gdy wybierzesz inną walutę, stawki zostaną przeliczone z odpowiednika w USD podanego w naszym arkuszu cen.

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

Na początku każdego miesiąca Google obciąża Cię 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 za 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łatności. Możesz ograniczyć maksymalny dzienny limit wykorzystania, aby chronić się przed nieoczekiwanymi wzrostami. Możesz też ustawić alerty budżetu, aby otrzymywać e-maile z powiadomieniami, gdy opłaty na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg.

Ograniczanie maksymalnego dziennego limitu rozliczeń:

Aby uniknąć wysokiego rachunku, możesz ustawić dzienny limit wykorzystania, który ochroni Cię przed nieoczekiwanym wzrostem zużycia. Możesz zmienić ten limit w Cloud Console.

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

Skonfiguruj alerty budżetu, aby wysyłać e-maile z powiadomieniami do administratorów odpowiedzialnych za rozliczenia, gdy opłaty na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg. Administratorzy rozliczeń będą otrzymywać e-maile z powiadomieniami, gdy szacowane opłaty na koncie rozliczeniowym przekroczą 50%, 90% i 100% progu.

Otrzymałem(-am) wiadomość, że mój projekt jest połączony z „kontem przejściowym Google Maps Platform”, ale nie mam do niego dostępu. Co mam zrobić?

„Konto przejściowe Google Maps Platform” zostało utworzone, aby pomóc niektórym klientom przejść na nasz plan cenowy z płatnością za wykorzystanie. To konto przejściowe umożliwiło Google przyznanie tym klientom jednorazowego uznania, dzięki czemu 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, zachęcamy do skonfigurowania własnego konta rozliczeniowego i dalszego korzystania z miesięcznego limitu bezpłatnego 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 to 1 żądanie dziennie? Jak mogę zwiększyć ten limit?

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

Gdy utworzysz i dołączysz konto rozliczeniowe, dzienny limit zapytań zostanie usunięty. Możesz ustawić limit, aby zapobiec nieoczekiwanym wydatkom w konsoli Cloud.

Otrzymałem(-am) powiadomienie o naruszeniu zasad rozliczeń. Jak rozwiązać ten problem?

Otrzymujesz to powiadomienie, ponieważ Google stwierdziło, że Twoje konto korzysta z wielu kont rozliczeniowych. Stanowi to naruszenie warunków Google, zgodnie z definicją w Warunkach korzystania z usługi Google Maps Platform. Zgodnie z tymi warunkami nie można tworzyć wielu kont rozliczeniowych. Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących naruszeń zasad związanych z kontem rozliczeniowym.

Korzystanie z Google Maps Platform

Jakich kluczy lub danych logowania mam używać w przypadku różnych usług Map Google?

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 przypadku aplikacji na Androida, iOS i w internecie oraz usług internetowych HTTP.

Klucz interfejsu 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 przy użyciu tajnego klucza podpisywania adresu URL, który otrzymujesz od Google. Podpisy cyfrowe są używane w interfejsach Maps Static API i Street View Static API.

Ograniczenia:

  • Ograniczenia kluczy interfejsu API są opcjonalne, ale ze względów bezpieczeństwa zalecamy ograniczenie wszystkich kluczy interfejsu API. Więcej informacji znajdziesz w artykule Sprawdzone metody dotyczące bezpieczeństwa interfejsu API.
  • Możesz dodać do klucza interfejsu API ograniczenie aplikacji. Po ograniczeniu klucz będzie działać tylko na platformach, które obsługują ten typ ograniczenia. Dostępne są 4 rodzaje ograniczeń aplikacji. Interfejsy API, które wymuszają ten sam typ ograniczenia, mogą używać tego samego klucza z ograniczeniem.
  • 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 informacje o kluczu lub danych logowania oraz ograniczeniach aplikacji w przypadku poszczególnych interfejsów API i pakietów SDK Google Maps Platform.

Interfejs API/pakiet SDK Ograniczenia 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
Pakiet SDK do nawigacji 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 stron odsyłających 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 strony odsyłającej HTTP1 + podpis cyfrowy2
Street View Static API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1 + Podpis cyfrowy2
Maps Embed API Klucz interfejsu API z ograniczeniem stron odsyłających 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 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 może być wymagany podpis cyfrowy w przypadku interfejsu Map Static API i interfejsu Street View Static API. Niezależnie od sposobu użycia stanowczo zalecamy używanie zarówno 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 interfejsów API usług internetowych z kluczem interfejsu API, który ma ograniczenia dotyczące odsyłającego, Twoje żądania będą kończyć się niepowodzeniem i będziesz otrzymywać komunikat o błędzie: „Klucze interfejsu API nie mogą mieć ograniczeń dotyczących odsyłającego, gdy są używane z tym interfejsem API”. Zacznij używać klucza interfejsu API z ograniczeniami dotyczącymi adresu IP.

Zanim zmienisz typ ograniczenia klucza interfejsu API ze strony odsyłającej HTTP na adres IP, upewnij się, że wszystkie interfejsy API, które używają tego klucza, obsługują typ ograniczenia IP. Interfejsy API tego samego typu ograniczeń 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 API.

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

Aby przełączyć klucz interfejsu API z ograniczeniem stron odsyłających HTTP na ograniczenie adresów IP, wykonaj te czynności:

  1. Otwórz stronę Dane logowania w konsoli Cloud.
  2. Wybierz projekt zawierający klucz interfejsu API, który chcesz edytować.
  3. Na stronie Dane logowania z listy kluczy interfejsu API wybierz nazwę klucza, którego szczegóły chcesz edytować.
  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 w 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 znajdziesz pod tymi linkami:

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

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 sekcji Rozpoczęcie 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ą wyraźne ustawienie języka podczas wysyłania żądania. Więcej informacji o tym, jak ustawić język, 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 (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 mapa będzie wyglądać w każdym z wymienionych powyżej języków.

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

Wszystkie usługi Google Maps Platform mogą i powinny być dostępne przez HTTPS. Aby zabezpieczyć aplikacje na przyszłość, zdecydowanie zalecamy korzystanie z protokołu TLS 1.3 w przypadku HTTPS. Starsze wersje TLS są nadal obsługiwane, ale odradzamy korzystanie z wersji 1.0 i 1.1, które zostały wycofane.

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 przesłać prośbę o dodanie nowej funkcji 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 programiści będą mogli sprawdzić błąd i wykluczyć potencjalne problemy z Twoim kodem.

Aby poprosić o funkcję, najpierw zgłoś ją na odpowiednim forum, aby potwierdzić, że rozwiązanie spełniające Twoje wymagania nie jest jeszcze dostępne.

Gdy potwierdzisz, że udało Ci się znaleźć nowy błąd lub że istniejące funkcje usług Google Maps Platform nie spełniają Twoich wymagań, zgłoś błąd lub prośbę o dodanie funkcji za pomocą narzędzia do śledzenia problemów Google Maps Platform.

Zanim dodasz błąd lub prośbę o funkcję do narzędzia Issue Tracker, sprawdź, czy nie zostały one już dodane. Jeśli tak jest, możesz oznaczyć problem gwiazdką, aby wyrazić 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 zapobiegania nadużyciom usług. Te pliki cookie nie są powiązane z żadnym zalogowanym kontem Google i nie są rejestrowane wraz z pozostałymi informacjami zbieranymi podczas wywołań interfejsu API.

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

Zespół Google ds. relacji z deweloperami jest obecny na Stack Overflow – stronie z odpowiedziami na pytania dla programistów, która jest wspólnie redagowana. To świetne miejsce na zadawanie pytań technicznych dotyczących tworzenia i utrzymywania aplikacji Map Google. Więcej informacji o zadawaniu pytań na Stack Overflow znajdziesz na stronie Pomoc.

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

  • przeszukiwać bieżące dyskusje. Prawdopodobnie ktoś inny miał podobny problem i udało mu się go rozwiązać.
  • Jeśli to możliwe, prześlij link do swojej witryny. Fragmenty kodu należy publikować tylko wtedy, gdy kod nie jest widoczny online.
  • Podaj wszystkie istotne informacje, w tym wersje przeglądarek, 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 API Map Google wystąpi błąd, kliknij poniższe linki, aby znaleźć wyjaśnienia kodów błędów:

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

W określonych okolicznościach może się wyświetlać przyciemniona mapa lub „negatywowy” obraz Street View ze znakiem wodnym „for development purposes only” (tylko do celów programistycznych). Zwykle wskazuje to na problemy z kluczem interfejsu 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. Aby rozwiązać ten problem, wykonaj te czynności:


Jak rozwiązać problem 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 API jest nieprawidłowy.
  • Projekt nie ma dołączonego konta rozliczeniowego.
  • Przekroczono 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ć problem 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 korzystasz z wycofanej wersji pakietu Places SDK na Androida lub pakietu Places SDK na iOS. Więcej informacji o nowych pakietach SDK znajdziesz na stronie https://goo.gle/places-sdk-deprecation.
Jak rozwiązać problem z błędem „Ten adres IP, witryna lub aplikacja mobilna nie ma uprawnień do korzystania z tego klucza interfejsu API”?

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

  • Na kluczu interfejsu API masz włączone ograniczenia adresu IP (serwera), a nieautoryzowany adres IP próbuje wysłać żądanie.
  • Na kluczu interfejsu API włączono ograniczenia dotyczące odsyłającego adresu HTTP (witryny), a nieautoryzowana strona odsyłająca próbuje wysłać żądanie.
  • Ustawiono nazwę pakietu i odcisk cyfrowy, aby ograniczyć korzystanie z zasobów do aplikacji na Androida, a nieautoryzowana aplikacja na Androida próbuje wysłać żądanie.
  • Ograniczono żądania z aplikacji na iOS przez podanie identyfikatorów pakietów, a nierozpoznana aplikacja na iOS próbuje wysłać żądanie.
  • Ten błąd mógł się pojawić, jeśli używasz dowolnego z interfejsów API usług internetowych z kluczem API, który ma ograniczenia dotyczące strony odsyłającej HTTP. Żądania przesyłane do tych interfejsów API powinny być identyfikowane za pomocą klucza interfejsu API z ograniczeniami dotyczącymi 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 Sprawdzone metody dotyczące kluczy interfejsu API.

Wyświetlanie i edytowanie danych logowania klucza interfejsu API

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

  1. Otwórz stronę Dane logowania w konsoli Cloud.
  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, na liście kluczy interfejsu API kliknij nazwę klucza.
  4. Wyświetlą się pełne dane logowania wybranego klucza interfejsu API, w tym wszelkie ograniczenia skonfigurowane dla tego klucza. W razie potrzeby możesz tu zmieniać, usuwać i aktualizować ograniczenia.
Jak rozwiązać problem: „Kluczy interfejsu API z ograniczeniami dotyczącymi odsyłającego nie można używać z tym interfejsem API”?

Korzystasz z interfejsów API usług internetowych 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 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 Twój klucz jest już używany z interfejsem Maps JavaScript API.

Usługi Google Maps Platform

Muszę przekonwertować adresy na pary 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ż Geocoding API, który oferuje interfejs RESTowy, który może odpowiadać w formatach JSON i XML.

W których krajach dostępna jest funkcja geokodowania?

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

Dokładność lokalizacji zakodowanych geograficznie 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 dokładne dopasowanie na potrzeby Twojej 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 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 czasem możesz zauważyć zmiany lub ulepszenia wyników.

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

Geokoder służy do przypisywania adresów do współrzędnych geograficznych. Dlatego zalecamy formatowanie żądań geokodera zgodnie z tymi wytycznymi, aby zmaksymalizować prawdopodobieństwo pomyślnego przetworzenia zapytania:

  • Adresy należy podawać w formacie 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 pocztę danego kraju. Może to spowodować, że odpowiedzi będą zawierać ZERO_RESULTS.
  • Kody plus należy formatować w sposób pokazany poniżej (znaki plusa są kodowane w adresie URL jako %2B, a spacje jako %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 lokalny kod składający się z co najmniej 6 znaków, który zawiera dokładną lokalizację (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Jeśli to możliwe, używaj numeru budynku zamiast jego nazwy.
  • W miarę możliwości używaj adresów z numerem budynku zamiast określania ulic poprzecznych.
  • nie podawaj „wskazówek”, np. pobliskich punktów orientacyjnych.
Jak sformatować adres w Stanach Zjednoczonych przy autostradzie z numerem, aby można było go użyć do geokodowania?

Geokoder Platformy Map Google wymaga, aby w adresach podawać numerowane autostrady w Stanach Zjednoczonych w ten 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"
  • Drogi krajowe w Stanach Zjednoczonych: "US NNN", gdzie NNN to numer drogi. np. "US 101"
  • Autostrady międzystanowe w USA: "Interstate NNN", gdzie NNN to numer autostrady międzystanowej, np. "Interstate 280"
Kiedy należy używać klasy geokodera interfejsu API, a kiedy usługi geokodowania HTTP?

Zapoznaj się z dokumentem Strategie geokodowania, w którym znajdziesz szczegółowe informacje o zaletach i ograniczeniach różnych strategii geokodowania.

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

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

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

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

Aby sprawdzić, w których krajach dostępne są 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 których krajach dostępne są wskazówki dojazdu transportem publicznym?

Routes API obsługuje wszystkich partnerów Google Transit, z wyjątkiem Indian Railway Catering and Tourism Corporation oraz partnerów 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 programistom nakładanie na mapę plików KML/KMZ i GeoRSS. Dokumentację i przykłady znajdziesz w klasie KmlLayer.

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

Limity rozmiaru i złożoności wyświetlania plików KML za pomocą klasy KmlLayer są opisane w omówieniu klasy KmlLayer.

Jak renderować na mapie pliki KML hostowane w witrynach intranetowych?

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

Jeśli musisz tworzyć aplikacje, które korzystają z plików KML hostowanych w witrynach intranetowych, zalecamy renderowanie plików KML po stronie klienta za pomocą bibliotek JavaScript innych firm. Podczas analizowania pliku KML przez przeglądarkę wydajność może być niższa niż w przypadku używania klasy KmlLayer.

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

Interfejs Maps Static API nie ma ograniczeń co do liczby znaczników ani wierzchołków ścieżki. W przypadku ikon niestandardowych w jednym żądaniu można określić maksymalnie 5 niepowtarzalnych ikon, ale każda z nich może być używana 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żywanych podczas określania każdej pary współrzędnych geograficznych. Informacje o tym, jak liczba używanych miejsc po przecinku wpływa na dokładność w Google Earth, znajdziesz w artykule w Wikipedii na temat stopni dziesiętnych.

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

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

Jak zgłosić problem dotyczący mapy bazowej Google?
Prześlij opinię w Mapach Google, aby zgłosić nieprawidłowe 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 wizytówce firmy, zaproponuj zmianę.

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

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

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

Niektóre funkcje po stronie klienta są skonfigurowane tak, aby raportować powodzenie lub niepowodzenie w celu obliczania docelowego poziomu usług. Informacje te są wysyłane do Google pod adresem maps.googleapis.com/maps_api_js_slo/log w przypadku połączeń, w których rejestrowane są informacje o poziomie usług. Obejmują one stan powodzenia, opóźnienie oraz wersję lub kanał używanego interfejsu Maps JavaScript API. Połączenia mogą być grupowane w celu zwiększenia wydajności. Może być konieczne zezwolenie na maps.googleapis.com w zasadach bezpieczeństwa treści, 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 będzie działać interfejs Maps JavaScript API 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 korzystasz z wycofanej wersji pakietu Places SDK na iOS. Wersja 2.7.0 pakietu SDK Miejsc na 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 iOS 8.x wystąpią problemy, wykonaj te czynności, aby wyłączyć przechwytywanie klatek przez procesor graficzny w schemacie Xcode, który jest uruchomiony:

  1. W XCode kliknij Product (Produkt), Scheme (Schemat), Manage Schemes (Zarządzaj schematami).
  2. Wybierz schemat i kliknij Edytuj....
  3. Ustaw opcję Przechwytywanie klatek 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
Jaki wpływ na pakiet Google Maps SDK na iOS mają zaokrąglone i szersze ekrany?

Od iPhone'a X telefony iPhone mają ekran z zaokrąglonymi rogami, wycięciem u góry na obudowę czujnika urządzenia i wskaźnikiem 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 programistom umieszczanie elementów w obszarze, który nie zostanie przycięty przez nowy kształt ekranu.

Pakiet Google Maps SDK na iOS zawiera wiele elementów wizualnych i elementów sterujących, takich jak selektor pomieszczeń i link do zgłaszania problemów. W wersji 2.4 te elementy wizualne i elementy sterujące mogły być przycinane przez nowy kształt ekranu. W trybie poziomym selektor pięter w pomieszczeniu może być przycięty przez wycięcie lub wskaźnik przycisku głównego.

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

Domyślnie zawsze uwzględniamy dopełnienie. Pakiet Google Maps SDK na iOS zakłada, że dopełnienie ma być stosowane w bezpiecznym obszarze. Jeśli zaprojektujesz interfejs z założeniem, że wszystko jest umieszczone w bezpiecznym obszarze, będzie on działać bez dodatkowego wysiłku.

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

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

Jeśli GMSMapView jest skonfigurowany do używania zachowania dopełnienia „Automatyczne”, zawsze wybierze większą wartość dopełnienia lub wstawki obszaru bezpiecznego. To ustawienie umożliwia dodanie dopełnienia od krawędzi ekranu przy jednoczesnym zapewnieniu, że wszystkie elementy pozostaną w bezpiecznym obszarze.

Jeśli GMSMapView ma ustawione zachowanie dopełnienia „Nigdy”, nigdy nie doda do dopełnienia wstawek obszaru bezpiecznego. Jest to zachowanie sprzed wersji 2.5 i może być przydatne, jeśli marginesy uwzględniają już obszar bezpieczny lub jeśli inne zachowania nie działają dobrze w Twoim interfejsie. Twoim obowiązkiem jest dbanie o to, aby logo Google i informacje o prawach autorskich były zawsze widoczne zgodnie z Warunkami korzystania z usługi Google Maps Platform.

Z kolei klasa GMSPanoramaView nie ma opcjonalnej właściwości dopełnienia. Oznacza to, że nie ma dopełnienia do dostosowania, a GMSPanoramaView zawsze stosuje 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 korzystasz z wycofanej wersji pakietu Places SDK na Androida. Wersja pakietu SDK Miejsc 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.
Aplikacja wyświetla tylko puste szare kafelki zamiast mapy. Jak mogę rozwiązać ten problem?

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

  1. Sprawdź, czy masz zainstalowane narzędzie adb. Jeśli nie, możesz skorzystać z przewodnika adb dla Androida.
  2. Zainstaluj aplikację, w której występuje problem, na urządzeniu lub w emulatorze Androida. Jeśli używasz emulatora Androida, sprawdź, czy w jego ustawieniach jest uwzględniony Sklep Play.
  3. W terminalu Android Studio uruchom adb logcat -e "Google Maps Android API". Spowoduje to wydrukowanie tylko wierszy, w których komunikat dziennika pasuje do „Google Maps Android API”. (Opcjonalnie możesz wyeksportować 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 manifeście odwołuje się do nieprawidłowego lub nieodpowiedniego klucza interfejsu API.
    • W projekcie nie włączono płatności.
    • Pakiet SDK nie jest włączony w interfejsach API projektu.
    • Nieprawidłowy odcisk cyfrowy SHA-1 jest dodany do ograniczeń klucza interfejsu API.
    • Zależności usług Google Play nie są uwzględnione w pliku build.gradle.

Podpisywanie URL

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

Zdecydowanie odradzamy podpisywanie adresów URL za pomocą JavaScriptu, ponieważ spowoduje to udostępnienie sekretu podpisywania adresów URL użytkownikom. Dlatego podpisy powinny być generowane tylko przez komponenty po stronie serwera.

Dlaczego w odpowiedzi na żądania usługi internetowej interfejsu Maps API otrzymuję odpowiedź HTTP 403 Forbidden?

Odpowiedź HTTP 403 wskazuje na problem z uprawnieniami, prawdopodobnie dlatego, że nie można było zweryfikować podpisu w przypadku tej prośby. Oto możliwe przyczyny:

  1. Podpis został określony, ale jest nieprawidłowy w przypadku tego żądania.
  2. Żądanie określa klucz interfejsu API w ramach Google Maps Platform Premium Plan, 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. Podpis został określony, ale powiązany z nim klucz interfejsu API abonamentu Premium w Google Maps Platform nie został określony.