Ta strona została przetłumaczona przez Cloud Translation API.

Google Maps Platform – najczęstsze pytania

Pierwsze kroki

Czym jest Google Maps Platform?

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

Mapy:

Trasy:

Miejsca:

Środowisko:

Jak zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki z Google Maps Platform.

Jakiego interfejsu API potrzebuję?

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

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

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

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

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

Zobacz też:

Jak wyświetlać usługi Google Maps Platform w języku innym niż angielski?
W jakich krajach dostępne są wskazówki dojazdu transportem publicznym?

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

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

Jak dostarczać aplikacje Map na urządzenia mobilne?

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

Aby uwzględnić mapy w natywnej aplikacji na iOS, użyj pakietu Maps SDK na iOS.

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

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

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

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

Komputer

aktualna wersja przeglądarki Microsoft Edge (Windows), z wyłączeniem trybu IE;
2 najnowsze główne stabilne wersje Firefoxa (Windows, macOS, Linux).
2 najnowsze główne stabilne wersje Chrome (Windows, macOS, Linux).
2 najnowsze główne stabilne wersje Safari (macOS).

Android

Aktualna wersja Chrome na Androidzie w wersji 4.1 lub nowszej.
WebView w Chrome na Androida w wersji 4.4 lub nowszej.

iOS

przeglądarka Safari na urządzeniach mobilnych w obecnej i poprzedniej głównej wersji iOS.
UIWebView i WKWebView w bieżącej i poprzedniej głównej wersji iOS.
Aktualna wersja Chrome na iOS.

Czy mogę drukować mapy z interfejsu Maps JavaScript API?

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

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

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

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

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

Kiedy dostępny jest zespół pomocy technicznej?

Zespół pomocy jest dostępny przez całą dobę, 5 dni w tygodniu (od poniedziałku do piątku od 9:00 rano do 17:00 czasu tokijskiego), z wyjątkiem dni świątecznych regionalnych.

Jak mogę odzyskać dostęp do mojego konta Google?

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

Uwaga: aby przywrócić dostęp do konta G Suite, poproś administratora organizacji o przywrócenie konta.

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

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

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

Jeśli znasz właściciela projektu i masz dostęp do swojego konta Google: poproś właściciela projektu o dodanie Cię jako właściciela projektu lub edytującego projekt.
- Jeśli Twój projekt należy do organizacji: skontaktuj się z administratorami organizacji i poproś ich o dodanie Cię jako właściciela projektu.
Jeśli nie znasz obecnego właściciela projektu: jeśli nie wiesz, kto jest właścicielem projektu lub właściciel projektu jest niedostępny, skontaktuj się z zespołem pomocy, aby poznać dodatkowe opcje odzyskania projektu.

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

Jeśli utraciłeś(-aś) dostęp do konta Google: spróbuj odzyskać nazwę użytkownika lub hasło do swojego konta.
Jeśli nie możesz odzyskać dostępu do swojego konta Google: utwórz nowe konto Google, a następnie skontaktuj się z obecnym właścicielem projektu i poproś o dodanie nowego konta Google do projektu.

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

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

Warunki korzystania z usługi

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

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

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

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

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

Są jednak sposoby korzystania z Platformy Map Google, których nie akceptujemy: mapy wskazujące miejsca, w których można kupić narkotyki, czy też inne nielegalne działania. Szanujemy też prywatność użytkowników, dlatego platformy Map Google nie można używać do identyfikowania informacji prywatnych dotyczących osób.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Limity wykorzystania i rozliczenia

Jak skonfigurować rozliczenia w projekcie?

Zobacz Pierwsze kroki z Google Maps Platform.

Jak klienci korzystający z bezpłatnego poziomu Google Cloud Platform przechodzą na płatne konto?

Program Google Cloud Platform w wersji bezpłatnej oferuje klientom bezpłatną wersję próbną z 300 USD do wykorzystania w dowolnej usłudze Google Cloud, w tym w interfejsach API Google Maps Platform (GMP). Po zakończeniu bezpłatnego okresu próbnego musisz przejść na płatne konto, aby nadal korzystać z tych usług. Aby przejść na płatne konto, otwórz konsolę Google Cloud.

Czy Google Maps Platform ma limity wykorzystania?

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

W przypadku funkcji Distance Matrix limit jest ustawiany w wyrażeniach zdarzeń na minutę (EPM) obliczanych jako suma zapytań po stronie klienta i po stronie serwera.

W przypadku usługi Routes:ComputeRouteMatrix limit jest wyrażony w elementach na minutę (EPM), gdzie liczba elementów w żądaniu jest równa: (liczba punktów początkowych razy liczba punktów docelowych).

W przypadku pakietów SDK nawigacji każde miejsce docelowe w żądaniu jest zliczane jako osobne zapytanie.

W tabeli poniżej znajdziesz limity użycia poszczególnych interfejsów API.

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

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

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

Jak oblicza się koszt użytkowania?

Informacje o cenach usług Google Maps Platform znajdziesz w arkuszu z cenami.

Więcej informacji o rozliczaniu interfejsów API Google Maps Platform znajdziesz w artykule Informacje o rozliczaniu Map, Tras, Miejsc i Środowiska.

Jak są zliczane wczytania map w Google Maps Platform?

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

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

Panorama Street View jest naliczana osobno od wczytywania mapy:

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

Gdy strona internetowa lub aplikacja wczyta mapę, obraz statycznej mapy lub panoramę Street View, wszelkie interakcje użytkownika z tymi elementami, np. przesuwanie, powiększanie lub przełączanie warstw mapy, nie powodują wczytywania dodatkowych map ani nie wpływają na limity wykorzystania.

Dodanie znacznika nie spowoduje dodatkowego wczytania mapy, ale może spowodować opłaty związane z określeniem lokalizacji pinezki (np. wczytanie lub ponowne wczytywanie klasy „google.maps.Map()”).

Jak mogę monitorować użycie?

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

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

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

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

Więcej informacji znajdziesz w artykułach Raporty Google Maps Platform, Monitorowanie wykorzystania interfejsu API i Ograniczanie wykorzystania interfejsu API.

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

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

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

Uwaga: 4 z interfejsów API usług internetowych mają odpowiednik na stronie klienta w Maps JavaScript API: Directions (Wyznaczanie trasy), Distance Matrix (Macierz odległości), Elevation (Wysokość) i Geocoding (Geokodowanie).

Przekroczono limity wykorzystania

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

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

Jeśli regularnie przekraczasz limity wykorzystania w ujęciu miesięcznym, rozważ zmniejszenie wykorzystania przez optymalizację aplikacji pod kątem efektywniejszego korzystania z usług Google Maps Platform lub poproś o zwiększenie limitu. Więcej informacji znajdziesz w przewodniku Optymalizacja.

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

Tak. Zalecamy jednak zapoznanie się z ograniczeniami użycia dotyczącymi wszystkich usług Google Maps Platform, z których korzysta Twoja aplikacja.

Czy jeśli moja witryna lub aplikacja nagle stanie się popularna, moje mapy przestaną działać?

Jeśli masz konto rozliczeniowe i przekroczysz bezpłatny miesięczny limit 200 USD, a na koncie rozliczeniowym nie masz ważnej formy płatności (karty kredytowej, przelewu bankowego itp.), interfejs API przestanie działać, dopóki nie dodasz ważnej formy płatności.

Jak będzie obliczane i fakturowane wykorzystanie?

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

Ile kosztuje korzystanie z Google Maps Platform?

Aby zapoznać się z kosztami poszczególnych interfejsów API, zapoznaj się z cennikiem. Jeśli Twoja aplikacja generuje żądania lub wczytuje mapy w ilości do 200 USD miesięcznie, nie naliczymy opłaty. Opłaty za wykorzystanie powyżej limitu 200 USD miesięcznie będą obciążać Twoje konto rozliczeniowe. Więcej informacji znajdziesz w przewodniku po płatnościach w Google Maps Platform.

Czy ceny są dostępne w innych walutach?

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

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

Google obciąża Cię na początku każdego miesiąca opłatą za aktywność z poprzedniego miesiąca, korzystając z określonej formy płatności. Szczegółowe informacje o rachunku znajdziesz w przewodniku po płatnościach za korzystanie z platformy Map Google.

Dodatkowe zasoby:

Dowiedz się, jak wyświetlić historię kosztów i płatności.
Dowiedz się, jak pobrać fakturę lub pokwitowanie płatności.
Dowiedz się, jak konfigurować alerty dotyczące płatności i nimi zarządzać.

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

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

Ustawienie maksymalnego dziennego limitu rozliczeniowego:

Aby uniknąć wysokich rachunków, możesz ustawić dzienny limit korzystania, aby zabezpieczyć się przed nieoczekiwanym wzrostem wykorzystania. Aby zmienić ten limit w konsoli Cloud, wykonaj te czynności:

Otwórz panel Interfejsy API i usługi.
Jeśli pojawi się monit, wybierz projekt.
Wybierz interfejs API z listy, a potem kliknij kartę Limity.
Kliknij ikonę edycji obok limitu „żądań dziennie”.

Możesz też edytować limity dla wielu interfejsów API za pomocą panelu Limity w sekcji Administracja i IAM.

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

Skonfiguruj alerty dotyczące budżetu, aby wysyłać e-maile do administratorów rozliczeń, gdy obciążenia na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg. Administratorzy rozliczeń będą otrzymywać e-maile z powiadomieniami, gdy szacunkowe 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 dostępu do tego konta. Co mam zrobić?

„Konto Google Maps Platform na czas przejścia” zostało utworzone, aby pomóc niektórym klientom przejść na nowy plan cennika „Płać z dostawą”. Dzięki temu konto przejściowe umożliwiło Google jednorazową zniżkę, dzięki której klienci mogli nadal korzystać z Google Maps Platform do limitu 200 USD bez opłat. Po przekroczeniu tego limitu konto rozliczeniowe zostanie zamknięte, a Ty utracisz dostęp do usługi. Aby uniknąć przerw w działaniu usługi, skonfiguruj własne konto rozliczeniowe i nadal korzystaj z poziomu bezpłatnego abonamentu o wartości 200 USD miesięcznie. Aby zmienić konto rozliczeniowe projektu:

Utwórz nowe konto rozliczeniowe (jeśli masz już konto rozliczeniowe, możesz pominąć ten krok).
Powiąż konto rozliczeniowe z projektem.

Dlaczego mój limit to 1 żądanie dziennie? Jak mogę zwiększyć ten limit?

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

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

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

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

Korzystanie z Google Maps Platform

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

Za każdym razem, gdy używasz usług Google Maps Platform, musisz dołączyć klucz interfejsu API, aby potwierdzić żądanie. Google Maps Platform jest dostępna dla aplikacji na Androida, iOS i internet oraz za pomocą usług internetowych HTTP.

Klucz API:

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

Podpis cyfrowy:

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

Ograniczenia:

Ograniczenia kluczy interfejsu API są opcjonalne, ale w celu zwiększenia bezpieczeństwa zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API. Więcej informacji znajdziesz w sprawdzonych metodach zapewniania bezpieczeństwa interfejsu API.
Możesz dodać do klucza interfejsu API ograniczenie aplikacji. Po wprowadzeniu ograniczenia klucz będzie działać tylko na platformach, które obsługują tego typu ograniczenia. Dostępne są 4 typy ograniczeń aplikacji. Interfejsy API stosujące ten sam typ ograniczenia mogą używać tego samego klucza z ograniczeniem.
- adresy IP (poszczególne serwery) – do korzystania z interfejsów API usług internetowych;
- Strony odsyłające HTTP (witryny internetowe) – do stosowania z interfejsami API sieci web.
- Ograniczenie aplikacji na Androida (według nazwy pakietu i odcisku palca) – do użycia z pakietem SDK Map na Androida.
- Ograniczenie aplikacji na iOS (według identyfikatora pakietu na iOS) – do użycia z pakietem SDK Maps na iOS.
Możesz też dodać do klucza API ograniczenie dotyczące interfejsu API. Więcej informacji znajdziesz w artykule Pobieranie, dodawanie i ograniczanie klucza interfejsu API.

Tabela poniżej wskazuje klucz/dane logowania i ograniczenia aplikacji dla każdego interfejsu API/pakietu SDK Google Maps Platform.

Interfejs API/pakiet SDK	Dane logowania i ograniczenia aplikacji
Maps SDK na Androida	Klucz interfejsu API z ograniczeniem dotyczącym Androida¹
Places SDK na Androida	Klucz interfejsu API z ograniczeniem dotyczącym Androida¹
Pakiet SDK do nawigacji na Androida	Klucz interfejsu API z ograniczeniem dotyczącym Androida¹
Maps SDK na iOS	Klucz interfejsu API z ograniczeniem na iOS¹
Places SDK na iOS	Klucz interfejsu API z ograniczeniem na iOS¹
Pakiet SDK do nawigacji na iOS	Klucz interfejsu API z ograniczeniem na iOS¹
Maps JavaScript API	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹
Map Tiles API	Klucz interfejsu API z ograniczeniem adresu IP¹
Maps Datasets API	Token OAuth
Aerial View API	Klucz interfejsu API z ograniczeniem adresu IP¹
Maps Static API	Klucz API z ograniczeniem strony odsyłającej HTTP¹ + Podpis cyfrowy²
Street View Static API	Klucz API z ograniczeniem strony odsyłającej HTTP¹ + podpis cyfrowy²
Maps Embed API	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹
Adres Validation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Directions API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Distance Matrix API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Elevation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Geocoding API	Klucz interfejsu API z ograniczeniem adresu IP¹
Geolocation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Places API	Klucz interfejsu API z ograniczeniem adresu IP¹
Roads API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Routes API	Klucz interfejsu API z ograniczeniem adresu IP¹
Time Zone API	Klucz interfejsu API z ograniczeniem adresu IP¹
Air Quality API	Klucz interfejsu API z ograniczeniem adresu IP¹
Pollen API	Klucz interfejsu API z ograniczeniem adresu IP¹
Solar API	Klucz interfejsu API z ograniczeniem adresu IP¹

¹ Ograniczenia klucza interfejsu API są opcjonalne, ale ze względów bezpieczeństwa zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API.

² W zależności od sposobu użycia interfejsu Maps Static API i interfejsu Street View Static API może być wymagana podpis cyfrowy. Niezależnie od 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 odwołującego adresu HTTP na ograniczenie adresu IP?

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

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

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

Aby przełączyć klucz interfejsu API z ograniczeniami strony odsyłającej HTTP na ograniczenia adresów IP, wykonaj te czynności:

W konsoli Cloud otwórz stronę Dane logowania.
Wybierz projekt, który zawiera klucz API, który chcesz edytować.
Na stronie Dane logowania na liście kluczy API wybierz nazwę klucza API, aby edytować jego szczegóły.
W sekcji Ograniczenie klucza kliknij „Adresy IP (serwery WWW, zadania cron itp.)” i wstaw odpowiednie adresy IP serwera, a następnie kliknij Zapisz.

Jak uzyskać nowy klucz API?

Zobacz Pierwsze kroki z Google Maps Platform.

Jak mogę znaleźć zmiany wprowadzone w każdej wersji interfejsów API Map Google?

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

Możesz też sprawdzić, w której wersji Google Maps Platform pojawił się dany błąd i w której został naprawiony, korzystając z trecera błędów Google Maps Platform:

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

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

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

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

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

Obsługiwane języki:

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

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

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

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

Do interfejsów Maps JavaScript API, Maps Static API i Web Service API można uzyskać dostęp przez połączenia zabezpieczone (HTTPS). Informacje o dostępie do interfejsu API przez SSL znajdziesz w dokumentacji dotyczącej danego interfejsu API.

Pamiętaj, że interfejs Maps Static API nie obsługuje adresów URL niestandardowych ikon, które używają protokołu HTTPS. Wyświetlana będzie domyślna ikona.

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

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

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

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

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

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

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

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

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

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

wyszukiwać bieżące dyskusje; Prawdopodobnie ktoś inny miał podobny problem i znalazł jego rozwiązanie.
Jeśli to możliwe, prześlij link do swojej witryny. Kody umieszczaj w postach tylko wtedy, gdy nie można ich łatwo wyświetlić online.
Podaj wszystkie istotne informacje, w tym wersje przeglądarki, błędy i inne fakty, które mogą być przydatne w rozwiązywaniu tego problemu.

Błędy i rozwiązywanie problemów

Co oznacza ten błąd?

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

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

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

Czy używasz klucza interfejsu API?

Tego nie wiem. Jak sprawdzić, czy używam klucza interfejsu API?

Klucz interfejsu API jest przekazywany jako parametr key w adresie URL służącym do wczytania interfejsu Maps JavaScript API. Oto kilka sposobów sprawdzenia, czy używasz klucza API:

Użyj rozszerzenia Google Maps Platform API Checker do przeglądarki Chrome. Dzięki temu możesz sprawdzić, czy Twoja witryna prawidłowo implementuje licencjonowane interfejsy API Map Google.
Jeśli do wczytania interfejsu Maps JavaScript API używasz biblioteki lub wtyczki, sprawdź ustawienia tej biblioteki i poszukaj opcji klucza interfejsu API.
Sprawdź błędy w przeglądarce. Jeśli widzisz te komunikaty, oznacza to, że nie używasz prawidłowo klucza interfejsu API:

Ostrzeżenie dotyczące interfejsu Maps JavaScript API: NoApiKeys
Błąd interfejsu Maps JavaScript API: MissingKeyMapError

Informacje dla programistów stron internetowych:

Jeśli masz dostęp do kodu źródłowego aplikacji, poszukaj tagu <script>, który służy do wczytywania interfejsu Maps JavaScript API. Podczas wczytywania interfejsu Maps JavaScript API zastąp w poniżej zamieszczonym kodzie wartość YOUR_API_KEY swoim kluczem interfejsu API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Sprawdź w przeglądarce ruch sieciowy generowany przez Twoją witrynę. W Chrome można to sprawdzić na karcie DevTools Sieć. Tutaj zobaczysz żądania sieci wysyłane przez Twoją witrynę. Żądania wysyłane za pomocą interfejsu Maps JavaScript API będą znajdować się na ścieżce maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Podczas wyświetlania karty Sieć może być przydatne odfiltrowanie ruchu sieciowego według maps/api/js.

Nie, nie używam klucza interfejsu API.

Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Jeśli nie widzisz samouczkowej konfiguracji, postępuj zgodnie z pełnymi instrukcjami w artykule Pierwsze kroki z Google Maps Platform.
Pierwsze kroki

Tak, używam klucza interfejsu API.

Świetnie. Sprawdźmy, czy do Twojego projektu jest przypisane konto rozliczeniowe.

Czy z Twoim projektem jest połączone konto rozliczeniowe?

Tego nie wiem. Jak sprawdzić, czy konto rozliczeniowe jest połączone z moim projektem?

W konsoli Google Cloud otwórz stronę Płatności i wybierz projekt, w którym utworzono klucz interfejsu API. Aby sprawdzić, czy klucz jest powiązany z projektem:

Otwórz sekcję Dane logowania, do której możesz przejść z poziomego paska po lewej stronie w sekcji Google Maps Platform > Dane logowania.
Sprawdź, czy klucz API, którego obecnie używasz w witrynie, jest widoczny na liście. Jeśli tak nie jest, przejdź do innego projektu i sprawdź tam te dane.
Jeśli nie możesz znaleźć projektu, w którym znajduje się klucz interfejsu API, być może utraciłeś do niego dostęp. Poproś o pomoc innych użytkowników w organizacji. Jeśli nie możesz znaleźć pierwotnego projektu:
1. Utwórz nowy projekt. Aby to zrobić, na liście projektów wybierz Nowy projekt lub na stronie Menedżera zasobów kliknij Utwórz projekt.
2. Tworzenie nowego klucza interfejsu API Możesz to zrobić na stronie Dane logowania. Następnie kliknij Utwórz dane logowania, a potem wybierz Klucz interfejsu API.

Po znalezieniu projektu w konsoli Cloud sprawdź, czy jest do niego dołączone konto rozliczeniowe. Aby to zrobić, otwórz sekcję Płatności w menu po lewej stronie.

Nie, mojego projektu nie powiązano z kontem rozliczeniowym.

Otwórz w konsoli Cloud stronę Włączanie płatności i dodaj do projektu konto rozliczeniowe. Więcej informacji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Tak, do mojego projektu jest przypisane konto rozliczeniowe.

Świetnie. Sprawdźmy, czy podana metoda płatności jest prawidłowa.

Czy podana forma płatności nie jest już ważna (np. karta kredytowa wygasła)?

możesz dodawać, usuwać i aktualizować formę płatności w konsoli Cloud.

Czy został przekroczony samookreślony dzienny limit interfejsu API?

Jeśli dla któregoś z interfejsów API ustawiony jest limit dzienny, co jest powszechną praktyką zapobiegającą nieoczekiwanym wzrostom, możesz rozwiązać ten problem, zwiększając limit dzienny.

Limity dzienne możesz sprawdzić w panelu Interfejsy API i usługi w konsoli Cloud. Gdy otworzysz Menedżera:

Jeśli pojawi się monit, wybierz projekt.
Wybierz interfejs API z listy, a potem kliknij kartę Limity.

Czy Twój klucz interfejsu API ma ograniczenie adresów IP?

Kluczy API z ograniczeniem adresów IP można używać tylko z usługami internetowymi przeznaczonymi do korzystania po stronie serwera (np. interfejsem Geocoding API i innymi interfejsami API usług internetowych). Większość tych usług internetowych ma odpowiedniki w Maps JavaScript API (np. usługa geokodowania). Aby korzystać z usług po stronie klienta interfejsu Maps JavaScript API, musisz utworzyć osobny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia stron odsyłających HTTP (patrz Uzyskiwanie, dodawanie i ograniczanie dostępu do klucza interfejsu API).

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 jednego z tych powodów:

W żądaniu brakuje klucza interfejsu API.
Podany klucz API jest nieprawidłowy.
Projekt nie ma przypisanego konta rozliczeniowego.
Przekroczono limit wykorzystania.
podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność);
Przekroczono limity wykorzystania danego interfejsu API.

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

Skonfiguruj konto rozliczeniowe.
Uzyskaj nowy klucz interfejsu API.
Dostosuj limit wykorzystania, aby zwiększyć dzienny limit (w stosownych przypadkach).

Jak rozwiązać problem z kodami błędów kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED?

Jeśli widzisz komunikaty kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED, być może używasz wycofanej wersji pakietu Places SDK na Androida lub iOS. Więcej informacji o nowych pakietach SDK znajdziesz na stronie https://goo.gle/places-sdk-deprecation.

Jak rozwiązać błąd „Ten adres IP, witryna lub aplikacja mobilna nie jest upoważniona do korzystania z tego klucza interfejsu API”?

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

W kluczu interfejsu API masz włączone ograniczenia adresów IP (serwerów), a nieautoryzowany adres IP próbuje wysłać żądanie.
W kluczu API masz włączone ograniczenia dotyczące strony odsyłającej HTTP (witryny) i nieautoryzowany odsyłający próbuje wysłać żądanie.
Ograniczyłeś/ograniczyłaś dostęp do swoich aplikacji na Androida, ustawiając nazwę pakietu i odcisk cyfrowy, a nieautoryzowana aplikacja na Androida próbuje wysłać żądanie.
Ograniczyłeś żądania z aplikacji na iOS, podając identyfikatory pakietów, a nierozpoznana aplikacja na iOS próbuje wysłać żądanie.
Wcześniej ten błąd mógł wystąpić, jeśli używasz interfejsów API usług internetowych z kluczem API, który ma ograniczenia dotyczące strony odsyłającej HTTP. Żądania wysyłane do tych interfejsów API powinny być identyfikowane za pomocą klucza API z ograniczeniami dotyczącymi adresu IP. Zmień typ ograniczenia klucza z ograniczenia dotyczącego strony odsyłającej 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, wykonaj te czynności:

W konsoli Cloud otwórz stronę Dane logowania.
Wybierz projekt, który zawiera klucz interfejsu API, który chcesz sprawdzić.
Aby wyświetlić szczegóły danych logowania, w tym wszelkie ograniczenia ustawione dla klucza, kliknij nazwę klucza na liście kluczy API.
Wyświetlają się pełne dane logowania do wybranego klucza interfejsu API, w tym wszelkie ograniczenia skonfigurowane dla tego klucza. Tutaj możesz w razie potrzeby zmienić, usunąć lub zaktualizować ograniczenia.

Jak rozwiązać błąd „Nie można używać kluczy API z ograniczeniami dotyczącymi referera z tym interfejsem API”?

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

Usługi Google Maps Platform

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

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

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

W jakich krajach jest dostępna geokodowanie?

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

Dokładność zkodowanych geograficznie lokalizacji może się różnić w zależności od kraju, dlatego warto użyć zwróconego pola location_type, aby określić, czy znaleziono wystarczająco dobre dopasowanie do potrzeb Twojej aplikacji. Pamiętaj, że 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 poprawę wyników.

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

Geokoder służy do mapowania adresów ulic na współrzędne geograficzne. Aby zmaksymalizować prawdopodobieństwo uzyskania pomyślnego wyniku, zalecamy formatowanie żądań geokodowania zgodnie z tymi wytycznymi:

Określ adresy w formacie używanym przez krajową pocztę danego kraju.
Nie podawaj dodatkowych elementów adresu, takich jak nazwy firm, numery lokali, numery pięter ani numery pokoi, które nie są uwzględnione w adresie zdefiniowanym przez pocztę danego kraju. Może to spowodować wyświetlanie odpowiedzi z ZERO_RESULTS.
Formatuj kody plusa w ten sposób (znaki plusa są zastępowane w adresie URL przez %2B, a spacje przez %20):
- Kod globalny to 4-znakowy kod obszaru i 6-znakowy lub dłuższy kod lokalny (849VCWC8+R9 to 849VCWC8%2BR9).
- Kod złożony to kod lokalny o długości co najmniej 6 znaków z wyraźną lokalizacją (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
Jeśli to możliwe, zamiast nazwy budynku użyj numeru domu.
W miarę możliwości używaj adresów numerycznych zamiast podawania nazw ulic, na których znajduje się skrzyżowanie.
Nie podawaj „wskazówek”, takich jak pobliskie punkty orientacyjne.

Jakie formatowanie adresu amerykańskiego na numerowanej autostradzie należy zastosować do geokodowania?

Geokoder platformy Mapy Google wymaga, aby numerowane autostrady w Stanach Zjednoczonych były określone w adresach w ten sposób:

County Roads: "Co Road NNN" gdzie NNN to numer drogi. Przykład: "Co Road 82"
Drogi stanowe: "State NNN" gdzie State to pełna nazwa stanu, a NNN to numer drogi. Przykład: "California 82"
Amerykańskie autostrady: "U.S. NNN" gdzie NNN to numer autostrady. np. "U.S. 101"
Autostrada w Stanach Zjednoczonych: "Interstate NNN" gdzie NNN to numer autostrady. Przykład: "Interstate 280"

Kiedy należy używać klasy geokodowania interfejsu API, a kiedy usługi geokodowania HTTP?

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

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

Usługa obliczania tras w interfejsie Routes API i interfejsie Directions API umożliwiają wyświetlanie wskazówek dotyczących przejazdu jedno- i wieloetapowego. Opcje routingu pomagają określić trasę za pomocą trybu podróżowania (jazda samochodem), pojedynczej lub wielu tras oraz ograniczeń (bez dróg płatnych). Te usługi są dostępne w tych formach:

Interfejs żądania/odpowiedzi HTTP (używany w aplikacjach mobilnych i innych aplikacjach) jest zgodny z Maps SDK na Androida i innymi usługami internetowymi Map Google.
Interfejs JavaScript API przeznaczony do aplikacji po stronie klienta umożliwia wyświetlanie wskazówek dojazdu za pomocą klasy google.maps.DirectionsService. Klasa DirectionsRenderer może automatycznie tworzyć dla Ciebie nakładki i panel kierunków. Dodatkowe przykłady znajdziesz w dokumentacji.
Interfejsy klienta w językach Java, Python, Go i Node.js w przypadku aplikacji serwerowych zapewniają te same funkcje. Więcej informacji o bibliotekach klienta znajdziesz w bibliotekach klienta interfejsu Directions API.

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

Aby sprawdzić, w których krajach obecnie dostępne są wskazówki dojazdu w usługach Google Maps Platform, zapoznaj się z danymi dotyczącymi zasięgu Map Google. Pamiętaj, że dostępność danych wskazujących trasę przejazdu 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?

Interfejsy Directions API i Distance Matrix API obsługują wszystkich partnerów Google Transit, z wyjątkiem tych w Japonii.

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

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

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

Limity rozmiaru i złożoności dotyczące wyświetlania KML za pomocą klasy KmlLayer zostały opisane tutaj.

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

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

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

Ile maksymalnie markerów lub wierzchołków ścieżki obsługuje interfejs Maps Static API?

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

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

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

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

Jak zgłosić problem z mapą Google?

Wyślij opinię w Mapach Google, jeśli zauważysz 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 należy usunąć z powodów prawnych, prześlij wniosek prawny.

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

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

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

Maps JavaScript API

Jak długo po załadowaniu będzie działać interfejs Maps JavaScript API?: Musisz odświeżyć stronę, która wczytuje interfejs Maps JavaScript API, co najmniej raz na 5 dni.

Google Maps SDK na iOS

Jak rozwiązać błąd: kGMSPlacesRateLimitExceeded?

Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK na iOS. Wersja 2.7.0 pakietu SDK Miejsca na iOS została wyłączona i nie jest już dostępna. Jak najszybciej zaktualizuj aplikację, aby korzystać z jej 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 napotkasz problemy podczas debugowania na urządzeniach z iOS 8.x, wykonaj te czynności, aby wyłączyć przechwytywanie klatek przez procesor graficzny w uruchomionym schemacie XCode:

W Xcode kliknij Produkt, Schemat, Zarządzaj schematami.
Wybierz schemat i kliknij Edytuj….
Ustaw opcję GPU Frame Capture na Wyłączone. Pamiętaj, że ta opcja może nie być dostępna na wszystkich urządzeniach.

Opcja Xcode GPU Frame Capture na stronie Generic iOS device (Typowe urządzenie z iOS)

Jaki wpływ na pakiet SDK Map Google na iOS mają zaokrąglone i szersze ekrany?

Począwszy od modelu iPhone X ekrany iPhone’ów mają zaokrąglone rogi, wycięcie na górze, w którym umieszczony jest moduł czujników, oraz przycisk na dole, który umożliwia dostęp do ekranu głównego. W pakiecie SDK iOS 11.0 firma Apple dodała interfejs Safe Area API, który umożliwia deweloperom umieszczanie elementów w obszarze, który nie zostanie przycięty przez nowy kształt ekranu.

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

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

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

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

Jeśli GMSMapView ma używać zachowania „Zawsze”, zawsze doda do wypełnienia obszary bezpieczne. Dzięki temu możesz projektować interfejs, zakładając, że wszystkie elementy są umieszczane na krawędziach bezpiecznej strefy. Jest to wartość domyślna.

Jeśli GMSMapView jest skonfigurowany tak, aby używać zachowania „Automatyczne”, zawsze wybierze większy obszar wypełnienia lub obszar bezpieczny. Dzięki temu możesz dodać margines od krawędzi ekranu, jednocześnie dbając o to, aby wszystkie elementy pozostawały w bezpiecznym obszarze.

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

W przypadku GMSPanoramaView nie ma opcjonalnej właściwości dopełniania. Oznacza to, że nie ma żadnych marginesów do dostosowania, a GMSPanoramaView zawsze zastosuje dowolne niezbędne marginesy, aby wszystkie elementy wizualne znalazły się w bezpiecznej strefie.

Google Maps SDK na Androida

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

Zamiast mapy aplikacja wyświetla tylko puste szare płytki. Jak mogę rozwiązać ten problem?

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

Sprawdź, czy masz zainstalowany adb. Jeśli nie, możesz postępować zgodnie z tymi instrukcjami.
Zainstaluj aplikację, która powoduje problem, na urządzeniu lub w emulatorze Androida. Jeśli używasz emulatora Androida, sprawdź, czy w ustawieniach emulatora jest uwzględniony Sklep Play.
W terminalu Android Studio uruchom adb logcat -e "Google Maps Android API". Wyświetli to tylko te wiersze, w których komunikat dziennika jest zgodny z „Google Maps Android API”. (Opcjonalnie możesz wyprowadzić dziennik do pliku tekstowego, dodając: > logcat.txt)
Odtwórz problem na urządzeniu i sprawdź, czy występują typowe błędy, takie jak:

W pliku manifestu występuje odwołanie do nieprawidłowego lub niezamierzonego klucza interfejsu API.
Płatności nie są włączone w projekcie.
Pakiet SDK nie jest włączony w interfejsach API projektu.
Nieprawidłowy odcisk cyfrowy SHA-1 został dodany do ograniczeń klucza interfejsu API.
Usługi Google Play są zależne od innych usług, które nie są uwzględnione w pliku build.gradle.

Podpisywanie URL

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

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

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

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

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