Najczęstsze pytania dotyczące Google Maps Platform

Pierwsze kroki

Zapoznaj się z Warunkami 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

Czym jest Google Maps Platform?

Google Maps Platform to zestaw interfejsów API i pakietów SDK, które umożliwiają programistom osadzanie Map Google w aplikacjach mobilnych i 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 zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki w Google Maps Platform.

Którego interfejsu API potrzebuję?

Aby znaleźć odpowiedni interfejs API na podstawie wymagań funkcjonalnych, skorzystaj z narzędzia Capabilities Explorer.

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

Zapoznaj się z przewodnikami Omówienie, Dla deweloperów i Dla początkujących 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.

Jakie kraje obejmuje Google Maps Platform?

Zespół Map Google stale udostępnia nowe dane mapy 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ę zmienić, jeśli zmienią się umowy licencyjne z dostawcami danych.

Zobacz też:

Czy mogę umieścić Mapy Google w 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 zintegrować mapy z aplikacją na Androida, użyj 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 dla 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, aby obraz mapy był połączony z Mapami Google.

Które przeglądarki internetowe 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 przeglądarki Microsoft Edge (Windows), z wyjątkiem trybu IE.
  • Dwie najnowsze stabilne wersje przeglądarki Firefox (Windows, macOS, Linux).
  • 2 najnowsze stabilne wersje Chrome (Windows, macOS, Linux).
  • 2 najnowsze stabilne wersje główne Safari (macOS);
Android
  • Aktualna wersja Chrome na Androidzie 4.1 lub nowszym.
  • Chrome WebView na Androidzie 4.4 lub nowszym.
iOS
  • Mobile Safari w bieżącej i poprzedniej głównej wersji iOS.
  • UIWebView i WKWebView w obecnej 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ż drukowanie jest obsługiwane w różny sposób w standardowych 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 usługach Google dla programistów związanych z geografią.

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

Informacje o dostępnych opcjach pomocy znajdziesz w artykule 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 dni wolnych od pracy w danym regionie, w przypadku problemów z niedziałającą usługą.
Jak mogę odzyskać dostęp do konta Google?

Jeśli nie masz dostępu do 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. Pracujemy nad dodaniem większej obsługi tworzenia aplikacji na symulatorach.

Zapoznaj 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 spełnia Warunki 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 wykorzystania 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ć Google Maps Platform do identyfikowania prywatnych informacji o osobach.

Przed opracowaniem i uruchomieniem aplikacji skonsultuj się z doradcą prawnym, aby sprawdzić, czy jest ona zgodna z Warunkami korzystania z usługi Google Maps Platform. Inżynierowie Google mogą udzielać tylko pomocy technicznej i nie mają uprawnień do udzielania porad prawnych. Google zastrzega sobie prawo do zawieszenia lub zakończenia korzystania z usługi w dowolnym momencie, dlatego dokładnie zapoznaj się z Warunkami korzystania z interfejsów API Map.

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

Nie możesz uzyskiwać dostępu do kafelków map 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). Dostęp Twojej 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 ograniczeń dotyczących wyświetlania danych w czasie rzeczywistym (śledzenia) za pomocą usług 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, 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 usług Google Maps Platform.

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

Nie zbieramy już tych danych. Użycie parametru indexing zostało wycofane i nie ma wpływu na działanie. Nie musisz już wyraźnie rezygnować z tej usługi, 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 swojej witrynie?

Nie możesz przechowywać i wyświetlać na swojej stronie kopii obrazów wygenerowanych za pomocą interfejsu Maps Static API. 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 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 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 umożliwia nowym użytkownikom wypróbowanie najpopularniejszych usług Google Cloud, w tym interfejsów API Google Maps Platform (GMP), bez żadnych zobowiązań finansowych. Rejestracja w bezpłatnym okresie próbnym powoduje utworzenie konta rozliczeniowego przeznaczonego do stosowania w bezpłatnym okresie próbnym, na którym jest już 300 USD w postaci bezpłatnych środków powitalnych, które możesz wykorzystać w GMP.

Jeśli nie przejdziesz na płatne konto rozliczeniowe przed upływem 91 dni lub jeśli wykorzystasz 300 USD środków otrzymanych w ramach bezpłatnej wersji próbnej, Twoje konto rozliczeniowe w ramach 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łatnym okresie próbnym.

Czy Google Maps Platform ma limity wykorzystania (limity)?

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 znajdziesz limit wykorzystania każdego interfejsu API. Limity możesz wyświetlać i modyfikować w konsoli Google Cloud.

Interfejs API Limit wykorzystania
Address Validation 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
Geocoding 3000 QPM
Geolokalizacja 6000 QPM
Maps Grounding Lite: wyszukiwanie miejsc, sprawdzanie pogody, wyznaczanie tras 300 zapytań na minutę na narzędzie
Maps Grounding Lite: Resolve names, Resolve Maps URLs 600 QPM na metodę
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 tys. QPM i 10 tys. żądań głównych dziennie.
Nawigacja: zapytania o ustawienie miejsca docelowego 30 000 QPM
Miejsca 6000 QPM
Places Aggregate 1200 QPM
Pollen 6000 QPM
Drogi 30 000 QPM
Trasy: obliczanie tras 3000 QPM
Trasy: macierz obliczania tras 3000 EPM
Solar 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.

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

Jak obliczany jest koszt wykorzystania?

Omówienie cen usług Google Maps Platform znajdziesz w cenniku.

Więcej informacji o tym, jak rozliczane są interfejsy API Google Maps Platform, znajdziesz w tym artykule.

Jak są zliczane wczytania map w Google Maps Platform?

Pojedyncze wczytanie mapy jest naliczane, gdy wystąpi któreś z tych zdarzeń:

  • 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 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 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 zawierający interfejs API, który chcesz sprawdzić.
  2. Na liście interfejsów API na panelu kliknij nazwę interfejsu API.
  3. U góry strony kliknij Dane lub Limity.

Aby wyświetlić raport o ruchu i informacje rozliczeniowe dotyczące całego projektu:

  1. Jeśli jeszcze tego nie zrobiono, skonfiguruj płatności.
  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 sekcjach Raportowanie w Google Maps Platform, Monitorowanie Google Maps Platform i Ustawianie limitu wykorzystania.

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

Jeśli przekroczysz limity zapytań na minutę 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 platformy Google Maps 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ł otrzymany, 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 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 dowolnej usługi Google Maps Platform, na której opiera się Twoja aplikacja.

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

Jak będzie obliczane i fakturowane wykorzystanie?

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 koncie formy płatności powiązanym z Twoim kontem rozliczeniowym. Więcej informacji znajdziesz w artykule Płatności w Google Maps Platform.

Ile kosztuje korzystanie z Google Maps Platform?

Listę cen znajdziesz w przeglądzie kosztów poszczególnych interfejsów API. Jeśli aplikacja generuje żądania lub wolumeny wczytywania mapy do limitu bezpłatnego wykorzystania w danym miesiącu, nie naliczamy opłat za wykorzystanie. Wykorzystanie przekraczające 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?

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 mogę 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 sekcji 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łatności. Możesz ograniczyć maksymalny limit dzienny wykorzystania, aby chronić się przed nieoczekiwanymi wzrostami. Możesz też ustawić alerty budżetowe, aby otrzymywać e-maile z powiadomieniami, gdy obciążenia 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 konsoli Cloud.

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

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

Dotarła do mnie 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ą według wykorzystania. To przejście umożliwiło Google przyznanie tym klientom jednorazowego kredytu, aby mogli 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 limit wynosi 1 żądanie dziennie? Jak mogę zwiększyć ten limit?

Jeśli nie utworzysz konta rozliczeniowego i nie dołączysz go do projektu, 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 to zrobić, zapoznaj się z artykułem 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 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ą podaną 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 należy 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 aplikacji internetowych 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 klucza tajnego do podpisywania URL-a, który otrzymasz od Google. Podpisy cyfrowe są używane w interfejsach Maps Static API i Street View Static API.

Ograniczenia:

  • Ograniczenia dotyczące klucza interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API, aby zwiększyć bezpieczeństwo. Więcej informacji znajdziesz w artykule Sprawdzone metody dotyczące bezpieczeństwa interfejsów 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 typy ograniczeń aplikacji. Interfejsy API, które wymuszają ten sam typ ograniczenia, mogą używać tego samego ograniczonego klucza.
  • 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 lub dane logowania oraz ograniczenia aplikacji dla każdego interfejsu API lub pakietu 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 dotyczącym 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łania HTTP1 + podpis cyfrowy2
Street View Static API Klucz interfejsu API z ograniczeniem odsyłającego HTTP1 + Podpis cyfrowy2
Maps Embed API Klucz interfejsu API z ograniczeniem dotyczącym 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 klucza 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 w przypadku interfejsu Maps Static API i interfejsu Street View Static API może być wymagany podpis cyfrowy. Niezależnie od sposobu użycia zdecydowanie 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”. Zamiast tego używaj klucza interfejsu API z ograniczeniami dotyczącymi adresu 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ą tego klucza, obsługują typ ograniczenia 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 API.

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

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

  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 z Google Maps Platform.
Jak mogę sprawdzić 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 stronę po jej załadowaniu?

Podczas wczytywania interfejsu API wystarczy podać parametr wywołania zwrotnego. Więcej informacji i przykładowy kod znajdziesz w sekcji Rozpoczęcie pracy 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 ustawianiu języka znajdziesz w dokumentacji poszczególnych interfejsów API:

Obsługiwane języki:

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

Kod języka Język Kod języka Język
af afrikaans ja japoński
sq albański kn kannada
am amharski kk kazachski
ar arabski km khmerski
hy ormiański ko koreański
az azerski ky kirgiski
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) nie 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 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 używanie 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 często zadawanych pytaniach dotyczących migracji głównego urzędu certyfikacji Google Maps Platform i często zadawanych 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 Twoje wymagania nie mogą zostać spełnione przez obecne funkcje usług Google Maps Platform, 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 dodanie funkcji 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 do 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 pytaniami i odpowiedziami dla programistów, która jest edytowana przez wielu użytkowników. 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, 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 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, zapoznaj się z wyjaśnieniami kodów błędów, które znajdziesz pod tymi linkami:

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 deweloperskich). Zwykle oznacza to 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ć 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 ustalony limit wykorzystania.
  • Podana forma płatności nie jest już ważna (np. karta kredytowa utracił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ć błąd: „Ten adres IP, witryna lub aplikacja mobilna nie są uprawnione do korzystania z tego klucza interfejsu API”?

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

  • Na kluczu interfejsu API włączono ograniczenia dotyczące adresu IP (serwera), a nieautoryzowany adres IP próbuje wysłać żądanie.
  • W przypadku klucza interfejsu API włączono ograniczenia dotyczące strony odsyłającej HTTP (witryny), a nieautoryzowana strona odsyłająca próbuje wysłać żądanie.
  • Używasz nazwy pakietu i odcisku cyfrowego, aby ograniczyć korzystanie z zasobów do własnych aplikacji na Androida, a nieautoryzowana aplikacja na Androida próbuje wysłać żądanie.
  • Ograniczono żądania z aplikacji na iOS przez określenie 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 do tych interfejsów API powinny być identyfikowane za pomocą klucza interfejsu API z ograniczeniami adresu IP. Zmień typ ograniczenia klucza z ograniczenia dotyczącego odsyłającego adresu HTTP na ograniczenie dotyczące 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. 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 wszelkie ograniczenia ustawione dla klucza, na liście kluczy API kliknij nazwę klucza.
  4. Wyświetlą się pełne dane logowania wybranego klucza interfejsu API, w tym wszelkie ograniczenia ustawione dla tego klucza. W tym miejscu możesz w razie potrzeby zmieniać, usuwać i aktualizować ograniczenia.
Jak rozwiązać błąd „Kluczy interfejsu API z ograniczeniami dotyczącymi odsyłającego nie można używać z tym interfejsem API”?

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

Usługi Google Maps Platform

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

W których krajach dostępna jest usługa geokodowania?

Aby sprawdzić, w których krajach działają 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 usługi Geocoding w 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 API jest od czasu do czasu aktualizowany o nowe dane, więc z czasem możesz zauważyć zmiany lub ulepszenia w wynikach.

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ć 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 lub 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 formatuj w sposób pokazany poniżej (znaki plus 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 6-znakowy lub dłuższy kod lokalny z określoną lokalizacją (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Jeśli to możliwe, używaj numeru domu zamiast nazwy budynku.
  • W miarę możliwości używaj numeru domu zamiast określania ulic poprzecznych.
  • nie podawaj „wskazówek”, takich jak pobliskie punkty orientacyjne.
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ć amerykańskie autostrady numerowane w ten sposób:

  • Drogi hrabstwa: "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 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 szczegółowo opisano zalety i ograniczenia różnych strategii geokodowania.

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

Usługa Compute Routes interfejsu Routes API umożliwia podawanie wskazówek dojazdu w przypadku podróży jedno- i wieloodcinkowych. 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 jakich 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 jakich krajach dostępne są wskazówki dojazdu transportem publicznym?

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

Jakie są ograniczenia 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 KML za pomocą klasy KmlLayer są opisane w omówieniu 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 do pobierania i analizowania plików KML na potrzeby renderowania. W związku z tym nie można wyświetlać plików KML, które nie są hostowane pod 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 unikalnych 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 miejsc po przecinku wpływa na dokładność 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?

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 firmie, zaproponuj zmianę.

Jeśli treści w Mapach Google muszą zostać usunięte ze względów prawnych, prześlij wniosek prawny.

W przypadku pilnych zgłoszeń, które wymagają natychmiastowej interwencji, otwórz zgłoszenie do zespołu pomocy i podaj 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 obliczenia docelowego poziomu usług. Te informacje są wysyłane do Google w maps.googleapis.com/maps_api_js_slo/log w przypadku połączeń, w których rejestrowane są informacje o SLO. 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 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 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 używasz wycofanej wersji pakietu SDK Miejsc 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 aplikacja ulega awarii. 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 używanym schemacie Xcode:

  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 Ogólne urządzenie z iOS
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 umożliwiającym dostęp do ekranu głównego. W pakiecie SDK iOS 11.0 firma Apple dodała interfejs API bezpiecznego obszaru, 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 ekranu 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 obszarze bezpiecznym. 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ślne), „Automatic” (automatyczne) i „Never” (nigdy).

Jeśli GMSMapView jest skonfigurowany tak, aby zawsze używać dopełnienia „Always”, zawsze będzie dodawać do dopełnienia wstawki bezpiecznego obszaru. To ustawienie pozwala zaprojektować interfejs z założeniem, że wszystkie elementy są umieszczone na krawędziach obszaru bezpiecznego. 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 wcięcia 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 w przypadku GMSMapView ustawiono zachowanie dopełnienia „Nigdy”, nigdy nie doda ono do dopełnienia wcięć obszaru bezpiecznego. Jest to zachowanie sprzed wersji 2.5 i może być przydatne, jeśli dopełnienie uwzględnia już bezpieczny obszar lub jeśli inne zachowania nie działają dobrze z Twoim interfejsem. 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, które można dostosować, 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 używasz wycofanej wersji pakietu SDK Miejsc 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.
Zamiast mapy aplikacja wyświetla tylko puste szare kafelki. 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. W przeciwnym razie zapoznaj się z przewodnikiem Android adb.
  2. Zainstaluj aplikację, w której występuje problem, na urządzeniu lub emulatorze Androida. Jeśli używasz emulatora Androida, sprawdź, czy w jego ustawieniach jest Sklep Play.
  3. W terminalu Android Studio uruchom adb logcat -e "Google Maps Android API". Spowoduje to wyświetlenie tylko wierszy, w których komunikat logu pasuje do „Google Maps Android API”. (Opcjonalnie możesz wyeksportować log 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 dodawany do ograniczeń klucza interfejsu API.
    • Zależności od usług Google Play nie są uwzględnione w pliku build.gradle.
Czy pakiet Google Maps SDK na Androida wymaga akceleracji sprzętowej?
Tak, w pliku AndroidManifest.xml aplikacji musisz ustawić wartość hardwareAccelerated na true, aby uniknąć problemów z wczytywaniem mapy.
Więcej informacji znajdziesz na stronie Akceleracja sprzętowa 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 udostępnienie użytkownikom klucza tajnego do podpisywania URL-a. Dlatego podpisy powinny być generowane tylko przez komponenty po stronie serwera.

Dlaczego w odpowiedzi na żądania usługi sieciowej interfejsu API Map Google 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 tego żądania. 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. Określono podpis, ale nie określono powiązanego klucza interfejsu API Google Maps Platform w ramach abonamentu Premium.