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

Google Maps Platform – najczęstsze pytania

Pierwsze kroki

Co to jest Google Maps Platform?

Google Maps Platform to zestaw interfejsów API i pakietów SDK, który umożliwia programistom umieszczanie Map Google w aplikacjach mobilnych i witrynach internetowych oraz pobieranie danych z Map Google. Dostępnych jest kilka opcji. W zależności od potrzeb możesz korzystać z 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, jak zacząć korzystać z Google Maps Platform.

Jakiego interfejsu API potrzebuję?

Aby dowiedzieć się, jak znaleźć odpowiedni interfejs API na podstawie Twoich wymagań funkcjonalnych, zapoznaj się z selektorem interfejsów API.

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

Przejrzyj przewodniki Omówienie, Programista i Pierwsze kroki dotyczące poszczególnych interfejsów API lub pakietów SDK, które Cię interesują. Na przykład zapoznaj się z przewodnikami po pakiecie SDK Map Google na Androida lub interfejsie Maps JavaScript API.

Które kraje są dostępne w ramach Google Maps Platform?

Zespół Map Google nieustannie pracuje nad nowymi danymi map i zwiększa zasięg na całym świecie. Najbardziej aktualne informacje znajdziesz w danych o zasięgu w Mapach Google. Dane możesz filtrować za pomocą pola filtrów u góry strony. Pamiętaj, że dane o zasięgu mogą ulec zmianie w przypadku zmiany umów licencyjnych z dostawcami danych.

Zobacz też:

Co zrobić, aby usługi Google Maps Platform wyświetlały się 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. W Mapach Google możesz teraz umieścić wyświetlaną mapę na swojej stronie lub na blogu bez konieczności programowania ani korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.

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

Aby umieścić mapy w aplikacji na Androida, użyj pakietu SDK Map Google na Androida.

Aby umieścić mapy w natywnej aplikacji na iOS, użyj pakietu SDK Map Google na iOS.

Interfejs Map JavaScript API został opracowany z myślą o urządzeniach mobilnych. Można go używać w przeglądarkach kierowanych zarówno na komputery, jak i na urządzenia z przeglądarką z pełną implementacją kodu JavaScript, np. na urządzenia Apple iPhone.

W przypadku aplikacji kierowanych na urządzenia, które nie obsługują interfejsu Maps JavaScript API, interfejs maps Static API dostarcza obrazy map w formatach GIF, JPG i PNG, w tym znaczniki i linie łamane. Pamiętaj, że korzystanie z interfejsu Maps Static API poza aplikacjami opartymi na przeglądarce wymaga połączenia obrazu mapy z Mapami Google.

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

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

Komputer

bieżąca wersja Microsoft Edge (Windows), z wyłączeniem trybu programu Internet Explorer.
Dwie najnowsze główne wersje stabilne przeglądarki Firefox (Windows, macOS, Linux).
Dwie najnowsze główne wersje stabilne Chrome (Windows, macOS i Linux).
Dwie najnowsze główne wersje stabilne przeglądarki Safari (macOS).

Android

Aktualna wersja Chrome na Androida 4.1 lub nowszego.
WebView Chrome na Androidzie 4.4 lub nowszym.

iOS

Safari na komórki w bieżącej 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 za pomocą interfejsu Maps JavaScript API?

Drukowanie z interfejsu Maps JavaScript API nie jest obsługiwane. Dzieje się tak, ponieważ obsługa drukowania jest niespójna w przypadku różnych powszechnie używanych przeglądarek.

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

Zasubskrybuj bloga Google Maps Platform, aby być na bieżąco z aktualnościami na temat różnych ofert dla deweloperów Google Geo.

Jak mogę się skontaktować z pomocą techniczną?

Więcej informacji o dostępnych opcjach pomocy znajdziesz w sekcji pomocy i materiałach na temat Google Maps Platform.

Kiedy pomoc techniczna jest dostępna?

Zespół pomocy jest dostępny przez całą dobę (od poniedziałku do piątku od 9:00 do 17:00 czasu pacyficznego) z wyjątkiem dni świątecznych w przypadku problemów związanych z brakiem możliwości korzystania z usługi.

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

Jeśli nie masz dostępu do swojego konta Google (np. jan@mojafirma.com lub jan@gmail.com), możesz spróbować odzyskać dostęp, odzyskując lub resetując hasło. Przeczytaj artykuł Jak odzyskać konto Google lub Gmail w Centrum pomocy 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 określonego projektu?

Jeśli nie masz dostępu 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ś go, by dodał 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ś o dodanie Cię jako właściciela projektu.
Jeśli nie znasz żadnego z obecnych właścicieli projektu: jeśli nie wiesz, kto jest właścicielem projektu lub kto jest niedostępny, skontaktuj się z zespołem pomocy, aby poznać dodatkowe opcje odzyskiwania projektu.

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

Jeśli nie masz dostępu do konta Google: spróbuj odzyskać nazwę użytkownika i hasło do konta.
Jeśli nie możesz odzyskać dostępu do swojego konta Google: utwórz nowe konto Google, a następnie skontaktuj się z właścicielem istniejącego projektu i poproś go o dodanie do niego Twojego nowego konta Google.

Czy mogę używać pakietu SDK Maps and Places na iOS na Macu z systemem Arm?

Opracowywanie nowych komputerów Mac z procesorami Arm jest możliwe, ale wymaga utworzenia i uruchomienia fizycznego urządzenia z iOS. Jest to ograniczenie tymczasowe, ponieważ pracujemy nad dodaniem większej liczby narzędzi do programowania na symulatorach.

Omówienie warunków korzystania z usługi

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

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

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

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

Z Google Maps Platform możesz korzystać w swoich aplikacjach, o ile Twoja witryna jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Jednak niektórych przypadków korzystania z Google Maps Platform, których po prostu nie chcemy oglądać, są to mapy informujące o miejscach, gdzie można kupić narkotyki w danym mieście, lub na potrzeby jakiejkolwiek innej nielegalnej działalności. Szanujemy także prywatność użytkowników, dlatego Google Maps Platform nie należy używać do identyfikowania informacji prywatnych o osobach.

Przed opracowaniem i wprowadzeniem aplikacji na rynek warto samodzielnie ustalić, czy jest ona zgodna z Warunkami korzystania z usługi Google Maps Platform. Inżynierowie Google mogą udzielać jedynie pomocy technicznej i nie mają kwalifikacji do udzielania porad prawnych. Google zastrzega sobie prawo do zawieszenia lub zakończenia korzystania z usługi w dowolnym momencie, dlatego uważnie przeczytaj Warunki korzystania z interfejsów API Map Google.

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

Nie możesz uzyskiwać dostępu do fragmentów map ani zdjęć satelitarnych za pomocą jakichkolwiek narzędzi innych niż platforma Google Maps Platform (np. przez tworzenie własnego interfejsu API mapowania lub użycie skryptu zbiorczego pobierania fragmentów). Dostęp aplikacji do kafelków będzie zablokowany, jeśli aplikacja będzie mogła korzystać z nich poza Google Maps Platform. Więcej informacji znajdziesz w Warunkach korzystania z usługi Google Maps Platform.

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

Nie ma ograniczeń w zakresie wyświetlania danych w czasie rzeczywistym (śledzenia) w usługach Google Maps Platform, pod warunkiem że aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Czy mogę korzystać z Map Google w aplikacji, która nie jest aplikacją internetową?

Tak. Z usług Google Maps Platform można teraz korzystać w aplikacjach innych niż internetowe, o ile są one zgodne z innymi ograniczeniami określonymi w Warunkach korzystania z Google Maps Platform.

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

Czy mogę korzystać z usług Google Maps Platform w witrynie chronionej hasłem?

Tak, z usług Mapy Google, tras, miejsc i środowiska można korzystać z aplikacjami z dostępem prywatnym. Więcej informacji znajdziesz w Warunkach korzystania z usługi Google Maps Platform.

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

Jeśli Twoja aplikacja generuje dokument w formie elektronicznej lub drukowanej, nie może on zawierać danych z Google Maps Platform, w tym zdjęć. Więcej informacji znajdziesz w Warunkach korzystania z usługi Google Maps Platform w sekcji „Zakaz kopiowania danych”.

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

Nie zbieramy już tych danych. Stosowanie parametru indexing zostało wycofane i nie ma żadnego efektu. Nie musisz już rezygnować z tej opcji, ale zachęcamy do jak najszybszego usunięcia tego parametru.

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

Czy mogę wygenerować obraz mapy za pomocą interfejsu Maps Static API, który przechowywam i udostępniam z mojej witryny?

Nie możesz przechowywać ani wyświetlać kopii obrazów wygenerowanych w Twojej witrynie 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 i bezpośrednio wyświetlane użytkownikom przez Google.

Limity wykorzystania i płatności

Jak skonfigurować płatności za projekt?

Zobacz Pierwsze kroki z Google Maps Platform.

Jak klienci korzystający z bezpłatnej wersji Google Cloud Platform mogą przejść na płatne konto?

Program poziomu bezpłatnego Google Cloud Platform zapewnia klientom bezpłatny okres próbny w wysokości 300 USD do wykorzystania w dowolnej usłudze Google Cloud Platform (GCP), w tym interfejsach API Google Maps Platform (GMP). Aby nadal korzystać z tych usług, po zakończeniu bezpłatnego okresu próbnego musisz przejść na płatne konto. Aby przejść na płatne konto, otwórz Cloud Console.

Czy w Google Maps Platform obowiązują limity wykorzystania?

Nie ma maksymalnego dziennego limitu liczby żądań, które możesz przesłać do usług Google Maps Platform, a jedyne limity wykorzystania dotyczą maksymalnej liczby zapytań na sekundę (QPS) lub zapytań na minutę (QPM).

W przypadku macierzy odległości limit jest ustawiony w liczbie zdarzeń na sekundę i jest obliczany jako suma zapytań po stronie klienta i serwera.

W przypadku tras:macierz tras obliczeniowych limit jest określony w elementach na minutę (EPM), gdzie liczba elementów w żądaniu jest równa: (liczba punktów początkowych × liczba miejsc docelowych).

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

API	Limit użycia
Weryfikacja adresu	6000 QPM
Widok z lotu ptaka: wyszukiwanie filmu	180 QPM i 100 000 QPD
Widok z lotu ptaka: 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 API Map Tiles: kafelki 2D i kafelki Street View	6000 QPM i 15 000 QPD
Map Tiles API: fotorealistyczne kafelki 3D	300 QPD
Interfejs Map Tiles API: fotorealistyczne kafelki 3D: mechanizm renderowania	12 000 QPM
Miejsca	6000 QPM
Pyłek	6000 QPM
Drogi	30 000 QPM
Trasy: trasy obliczeniowe	3000 QPM
Trasy: macierz tras Compute	3000 EPM
Panele słoneczne	600 QPM
Mapy statyczne	30 000 QPM
Street View Image API	30 000 QPM
Strefa czasowa	30 000 QPM

Aby zarządzać wydatkami, możesz monitorować wykorzystanie interfejsu API i ustawić limity dzienne na wszystkie żądania wysyłane do każdego rozliczanego interfejsu API.

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

Jak jest obliczany koszt wykorzystania?

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

Więcej informacji o rozliczaniu interfejsów API Google Maps Platform znajdziesz w artykule Omówienie rozliczeń za Mapy, trasy, miejsca i środowisko.

W jaki sposób są liczone 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 do interfejsu Maps Static API żądanie pojedynczego obrazu mapy.

Koszty panoramy Street View są naliczane oddzielnie od wczytania mapy:

Za każde przesłane do Street View Static API żądanie statycznej (nieinteraktywnej) panoramy Street View jest naliczana opłata za statyczną (nieinteraktywną) panoramę Street View.
Za każde wystąpienie obiektu panoramicznego w interfejsie Maps JavaScript API, Maps SDK na Androida lub Maps SDK na iOS naliczamy opłatę za dynamiczną panoramę Street View.

Po wczytaniu przez stronę internetową lub aplikacji mapy, statycznego obrazu mapy lub panoramy Street View żadne interakcje użytkownika z nią, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie generują dodatkowych operacji wczytywania mapy ani nie wpływają na limity wykorzystania.

Dodanie znacznika nie spowoduje wygenerowania dodatkowych operacji wczytywania mapy, ale może spowodować naliczenie opłat związanych z określeniem lokalizacji pinezki (np. wczytanie lub ponowne wczytanie klasy „google.maps.Map()”).

Jak monitorować wykorzystanie miejsca na dane?

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

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

Skonfiguruj rozliczenia, jeśli jeszcze nie zostało to zrobione.
Otwórz stronę płatności Cloud Console.
Wybierz projekt.
Na pasku bocznym po lewej stronie kliknij Raporty. Aby wyświetlić raporty na koncie rozliczeniowym, użyj filtrów na pasku bocznym po prawej stronie.

Więcej informacji znajdziesz w artykułach o raportowaniu Google Maps Platform oraz w sekcjach Monitorowanie wykorzystania interfejsu API i Ograniczenie wykorzystania interfejsu API.

Co się stanie, jeśli przekroczę limity liczby żądań (QPS)?

Jeśli przekroczysz limity zapytań na sekundę w danej usłudze Google Maps Platform, 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 zapytań na żądanie lub w inny sposób nadużyjesz usługi, w żądaniach pojawi się określony komunikat o błędzie. Jeśli nadal będziesz przekraczać limity, Twój dostęp do Google Maps Platform może zostać zablokowany.

Uwaga: 4 interfejsy API usług internetowych mają odpowiednik w usłudze po stronie klienta w interfejsie Maps JavaScript API: Directions, Matrix, Elevation i Geocoding.

Przekroczono limity wykorzystania

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

Oznacza to, że usługa internetowa przestanie wysyłać normalne odpowiedzi i przełączy się na zwracanie tylko kodu stanu OVER_QUERY_LIMIT do czasu, gdy wykorzystanie będzie znów dozwolone. Może się to zdarzyć w ciągu kilku sekund, jeśli komunikat o błędzie pojawił się w wyniku wysyłania przez aplikację zbyt wielu żądań na sekundę.

Jeśli regularnie przekraczasz limity wykorzystania zapytań na sekundę, rozważ zmniejszenie wykorzystania przez optymalizację aplikacji pod kątem wydajniejszego korzystania z usług Google Maps Platform. 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 usług Google Maps Platform, z których korzysta Twoja aplikacja.

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

Jeśli masz już konto rozliczeniowe i przekroczysz miesięczny limit wykorzystania wynoszący 200 USD i nie będziesz mieć na koncie rozliczeniowym ważnej formy płatności (karta kredytowa, przelew bankowy itp.), interfejs API przestanie działać, dopóki nie dodasz prawidłowej formy płatności.

Jak będzie obliczane i rozliczane wykorzystanie?

Wykorzystanie jest obliczane na koniec każdego dnia i wyceniane zgodnie z cennikiem Cennik. Pod koniec każdego miesiąca łączne opłaty są naliczane za pomocą formy płatności powiązanej z kontem rozliczeniowym. Więcej informacji znajdziesz w artykule o płatnościach za Google Maps Platform.

Ile kosztuje korzystanie z Google Maps Platform?

Omówienie kosztu interfejsu API znajdziesz w cenniku. Jeśli Twoja aplikacja generuje żądania lub ma obciążenia do 200 USD miesięcznie, za wykorzystanie nie naliczamy opłat. Opłaty za wykorzystanie przekraczające 200 USD miesięcznie będą obciążać Twoje konto rozliczeniowe. Więcej informacji znajdziesz w przewodniku po płatnościach za Google Maps Platform.

Czy ceny są dostępne w innych walutach?

Dodatkowe waluty mogą być dostępne w konsoli. Gdy wybierzesz inną walutę, ceny zostaną przeliczone z odpowiednika w dolarach amerykańskich podanego w arkuszu cen.

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

Na początku każdego miesiąca Google nalicza opłaty za aktywność z poprzedniego miesiąca przy użyciu określonej formy płatności. Więcej informacji o rachunku znajdziesz w naszym przewodniku po rozliczeniach za Google Maps Platform.

Dodatkowe zasoby:

Dowiedz się, jak wyświetlić historię kosztów i płatności.
Dowiedz się, jak uzyskać fakturę lub pokwitowanie płatności.
Dowiedz się, jak skonfigurować alerty rozliczeniowe i jak nimi zarządzać.

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 rozliczeniowych. Możesz ograniczyć dzienny limit użycia, aby zapobiec nieoczekiwanym wzrostom wykorzystania. Możesz też skonfigurować alerty dotyczące budżetu tak, aby otrzymywać e-maile z powiadomieniami, gdy obciążenia na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg.

Ograniczenie maksymalnego dziennego limitu rozliczanego:

Aby uniknąć dużego rachunku, możesz ustawić dzienny limit wykorzystania w celu ochrony przed nieoczekiwanym wzrostem wykorzystania. Możesz zmienić ten limit w Cloud Console, wykonując te czynności:

Otwórz panel interfejsów API i usług.
Wybierz projekt, jeśli pojawi się taka prośba.
Wybierz z listy interfejs API i kliknij kartę Limity.
Kliknij ikonę edycji obok limitu żądań dziennie.

Możesz też edytować wiele limitów dla wielu interfejsów API w panelu uprawnień i limitów administratora.

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

Skonfiguruj alerty dotyczące budżetu, aby wysyłać do administratorów rozliczeń e-maile z powiadomieniami, gdy opłaty na koncie rozliczeniowym osiągną wyznaczony próg. Administratorzy rozliczeń otrzymają e-maile z powiadomieniem, gdy szacunkowe obciążenia na koncie rozliczeniowym przekroczą 50%, 90% i 100% wartości progowej.

Widzę komunikat, że mój projekt jest połączony z „kontem przejścia w Google Maps Platform”, ale nie mam dostępu do tego konta. Co mam zrobić?

Konto przejścia na Google Maps Platform zostało utworzone, aby pomóc niektórym klientom przejść na nasz nowy abonament rozliczany według wykorzystania. To przeniesienie umożliwiło Google przyznanie tym klientom jednorazowego kredytu, który umożliwił im dalsze korzystanie z Google Maps Platform do kwoty bezpłatnego poziomu 200 USD. Po przekroczeniu tego limitu konto rozliczeniowe zostanie zamknięte i utracisz dostęp do usługi. Aby uniknąć przerw w działaniu usługi, zalecamy skonfigurowanie konta rozliczeniowego i dalsze korzystanie z bezpłatnego poziomu, który wynosi 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 jest ustawiony na 1 żądanie dziennie? Jak zwiększyć ten limit?

Jeśli nie masz jeszcze konta rozliczeniowego ani powiązanego z projektem, korzystanie z interfejsów Maps Platform API będzie ograniczone do 1 żądania dziennie. Aby uzyskać wyższy limit, utwórz i dołącz konto rozliczeniowe. Aby to zrobić, zobacz Pierwsze kroki z Google Maps Platform.

Gdy utworzysz i podłączysz konto rozliczeniowe, Twój dzienny limit zostanie usunięty. Możesz ustawić limit, aby zapobiec nieoczekiwanym wydatkom w Cloud Console.

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

Wysłaliśmy to powiadomienie, ponieważ ustaliliśmy, że Twoje konto korzysta z wielu kont rozliczeniowych. Stanowi to naruszenie warunków Google określonych w sekcji 3.2.4 Warunków korzystania z Google Maps Platform. Zgodnie z tymi warunkami tworzenie wielu kont rozliczeniowych jest zabronione. Więcej informacji znajdziesz w artykule Najczęstsze pytania na temat naruszeń zasad konta rozliczeniowego.

Korzystanie z Google Maps Platform

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

Za każdym razem, gdy używasz usług Google Maps Platform, musisz uwzględniać klucz interfejsu API, aby zweryfikować żądanie. Platforma Google Maps Platform jest dostępna dla aplikacji na Androida i iOS, aplikacji internetowych i usług internetowych HTTP.

Klucz interfejsu API:

Klucz interfejsu API to unikalny identyfikator generowany przez Ciebie za pomocą konsoli Cloud.
Przykład wczytywania interfejsu API za pomocą klucza: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Podpis cyfrowy:

Podpis cyfrowy jest generowany przy użyciu tajnego klucza podpisywania adresu URL udostępnionego przez Google. Podpisy cyfrowe są używane z interfejsem Maps Static API i Street View Static API.

Ograniczenia:

Ograniczenia kluczy interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API w celu zwiększenia bezpieczeństwa. Więcej informacji znajdziesz na stronie ze sprawdzonymi metodami zapewniania bezpieczeństwa interfejsu API.
Do klucza interfejsu API możesz dodać ograniczenie aplikacji. W przypadku ograniczenia klucza klucz będzie działać tylko na platformach, które obsługują ten typ ograniczeń. Dostępne są 4 rodzaje ograniczeń aplikacji. Interfejsy API wymuszające ten sam typ ograniczeń mogą używać tego samego klucza ograniczonego.
- Adresy IP (pojedyncze serwery) do użytku z interfejsami API usług internetowych.
- Strony odsyłające HTTP (witryny internetowe) – do użytku z internetowymi interfejsami API.
- Ograniczenie aplikacji na Androida (według nazwy pakietu i odcisku palca) – do użycia z pakietem SDK Map Google na Androida.
- Ograniczenie aplikacji na iOS (według identyfikatora pakietu na iOS) – do użytku z pakietem SDK Map Google na iOS.
Do klucza interfejsu API możesz też dodać ograniczenie. Więcej informacji znajdziesz w artykule o pobieraniu, dodawaniu i ograniczaniu klucza interfejsu API.

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

API/SDK	Dane logowania i ograniczenie dotyczące aplikacji
Pakiet SDK Maps na Androida	Klucz interfejsu API z ograniczeniem Androida¹
Pakiet SDK Miejsc na Androida	Klucz interfejsu API z ograniczeniem Androida¹
Pakiet SDK Maps na iOS	Klucz interfejsu API z ograniczeniem iOS¹
Pakiet SDK Miejsc na iOS	Klucz interfejsu API z ograniczeniem iOS¹
Maps JavaScript API	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹
Interfejs API Map Tiles	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Aerial View API	Klucz interfejsu API z ograniczeniem adresu IP¹
Maps Static API	Klucz interfejsu API z ograniczeniem witryny odsyłającej HTTP¹ + Podpis cyfrowy²
Street View Static API	Klucz interfejsu API z ograniczeniem witryny odsyłającej HTTP¹ + Podpis cyfrowy²
Maps Embed API	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹
Interfejs Address Validation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Directions API	Klucz interfejsu API z ograniczeniem adresu IP¹
Distance Matrix API	Klucz interfejsu API z ograniczeniem adresu IP¹
Elevation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Geocoding API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Geolocation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Places API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs 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 dotyczące ¹ klucza interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API w celu zwiększenia bezpieczeństwa.

² W zależności od sposobu używania Map Static API i Street View Static API może być wymagany podpis cyfrowy. Niezależnie od użycia zdecydowanie zalecamy używanie zarówno klucza interfejsu API, jak i podpisu cyfrowego do uwierzytelniania żądań.

Jak zmienić typ ograniczenia klucza ze strony odsyłającej HTTP na ograniczenie adresu IP?

Ważne: jeśli używasz interfejsu API usługi internetowej z kluczem interfejsu API z ograniczeniami dotyczącymi odesłań, Twoje żądania będą kończyć się niepowodzeniem i wyświetleniem komunikatu o błędzie: „Klucze interfejsu API nie mogą mieć ograniczeń dotyczących strony odsyłającej, gdy są używane z tym interfejsem API”. Najlepiej użyć klucza interfejsu API z ograniczeniami adresów IP.

Zanim zmienisz typ ograniczenia klucza interfejsu API ze strony odsyłającej HTTP na adres IP, upewnij się, że wszystkie interfejsy API korzystające z klucza interfejsu API obsługują typ ograniczenia adresu IP. Interfejsy API o tym samym typie ograniczeń mogą używać tego samego klucza ograniczonego. Jeśli chcesz wymusić stosowanie więcej niż 1 ograniczenia, dodaj oddzielny klucz z wymaganym ograniczeniem. Dowiedz się, jak dodać nowy klucz interfejsu API.

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

Aby zmienić klucz interfejsu API z ograniczeniem odsyłającym HTTP na ograniczenie adresu IP, wykonaj te czynności:

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

Jak uzyskać nowy klucz interfejsu API?

Zobacz Pierwsze kroki z Google Maps Platform.

Jak znaleźć zmiany wprowadzone w poszczególnych wersjach interfejsów API Map Google?

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

W narzędziu do śledzenia problemów z Google Maps Platform możesz też sprawdzić, w której wersji Google Maps Platform pojawił się konkretny błąd i w której wersji został on naprawiony:

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

Jak mogę asynchronicznie wczytać interfejs API na stronie po jej wczytaniu?

Określ tylko parametr wywołania zwrotnego podczas wczytywania interfejsu API. Więcej informacji i przykładowy kod znajdziesz w sekcji Pierwsze kroki dokumentacji interfejsu Maps JavaScript API.

Co zrobić, aby usługi Google Maps Platform wyświetlały się w języku innym niż angielski?

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

Obsługiwane języki:

Google często aktualizuje obsługiwane języki. Ta lista może nie być pełna i może się zmieniać.

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
h	chorwacki	pt	portugalski
cs	czeski	pt-BR	portugalski (Brazylia)
da	duński	pt-PT	portugalski (Portugalia)
nl	niderlandzki	pa	pendżabski
angielski	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
włoski	włoski

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

Czy dostęp do Google Maps Platform jest możliwy przez protokół SSL (HTTPS)?

Dostęp do interfejsów Maps JavaScript API, Maps Static API i Web Service API jest możliwy przez bezpieczne połączenia (HTTPS). Informacje o uzyskiwaniu dostępu do interfejsu API przez SSL znajdziesz w dokumentacji interfejsu API, którego dotyczy problem.

Pamiętaj, że Maps Static API nie obsługuje adresów URL niestandardowych ikon korzystających z HTTPS. Wyświetlana będzie ikona domyślna.

Jak zgłosić błąd lub poprosić o dodanie nowej funkcji w Google Maps Platform?

Jeśli zauważysz błąd, zacznij od zgłoszenia tego problemu na odpowiednim forum. Pozwoli to innym programistom sprawdzić błąd i wykluczyć potencjalne problemy z kodem.

Jeśli chcesz poprosić o dodanie funkcji, również najpierw zgłoś ją na odpowiednim forum, aby upewnić się, że rozwiązanie, które spełnia Twoje wymagania, nie jest jeszcze dostępne.

Gdy potwierdzisz, że znalazłeś nowy błąd lub że obecne funkcje usług Google Maps Platform nie spełniają Twoich wymagań, zgłoś błąd lub prośbę o funkcję za pomocą narzędzia do śledzenia problemów z Google Maps Platform.

Zanim dodasz do narzędzia Issue Tracker zgłoszenie błędu lub prośby o funkcję, sprawdź, czy nie zostały one już dodane. Jeśli tak, możesz go oznaczyć gwiazdką, aby zarejestrować się i otrzymywać powiadomienia o aktualizacjach.

Jak interfejsy API Google Maps Platform używają plików cookie witryny?

Pakiety SDK Maps na Androida i Maps SDK na iOS używają plików cookie zgodnie z Polityką prywatności Google, np. w zakresie obliczania dziennej i 7-dniowej liczby aktywnych użytkowników oraz zapobiegania nadużyciom usług. Te pliki cookie nie są powiązane z żadnym kontem Google, na które się zalogowano, ani rejestrowane z pozostałymi informacjami zbieranymi z wywołań interfejsu API.

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

Zespół Google ds. relacji z deweloperami jest aktywny w Stack Overflow – edytowanej wspólnie witrynie z pytaniami i odpowiedziami dla programistów. Możesz tam zadawać pytania techniczne dotyczące tworzenia i obsługi aplikacji Map Google. Więcej informacji na temat zadawania pytań na stronie Stack Overflow znajdziesz na stronie pomocy.

Pamiętaj o tych kwestiach:

Przeszukaj bieżące dyskusje. Być może ktoś inny miał podobny problem i znalazł rozwiązanie.
Jeśli to możliwe, prześlij link do swojej witryny. Kody pocztowe należy wysyłać tylko wtedy, gdy nie można ich łatwo znaleźć w internecie.
Podaj wszystkie istotne informacje, w tym wersje przeglądarki, błędy i inne fakty, które mogą pomóc w rozwiązaniu 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, wyjaśnienia dotyczące kodów błędów znajdziesz na tych stronach:

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

W pewnych okolicznościach przyciemniona mapa lub „negatywne” zdjęcie Street View może się wyświetlać ze znakiem wodnym z tekstem „tylko do celów programistycznych”. Takie zachowanie zwykle oznacza problemy z kluczem interfejsu API lub płatnościami. Aby korzystać z usług Google Maps Platform, musisz mieć konto rozliczeniowe, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Aby rozwiązać ten problem, wykonaj te czynności:

Czy używasz klucza interfejsu API?

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

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

Użyj rozszerzenia do Chrome Google Maps Platform API Checker. Dzięki temu możesz określić, czy Twoja witryna prawidłowo wdraża licencjonowane przez Google interfejsy API Map Google.
Jeśli do wczytywania 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 pojawiają się te komunikaty, oznacza to, że nieprawidłowo używasz klucza interfejsu API:

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

Dla programistów stron internetowych:

Jeśli masz dostęp do kodu źródłowego swojej aplikacji, znajdź tag <script>, który służy do wczytywania interfejsu Maps JavaScript API. Podczas wczytywania interfejsu Maps JavaScript API zastąp YOUR_API_KEY w poniższym kodzie swoim kluczem API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Sprawdź w przeglądarce ruch w sieci generowany przez Twoją witrynę. W Chrome możesz go wyświetlić na karcie Sieć w DevTools. Zobaczysz na niej żądania sieciowe wysyłane przez Twoją witrynę. Żądania wykonane za pomocą interfejsu Maps JavaScript API będą mieć ścieżkę maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Podczas wyświetlania karty Sieć pomocne może być filtrowanie ruchu sieciowego według wartości maps/api/js.

Nie, nie używam klucza interfejsu API.

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

Tak, używam klucza interfejsu API.

Świetnie. Sprawdźmy teraz, czy z Twoim projektem jest powiązane konto rozliczeniowe.

Czy do Twojego projektu jest połączone konto rozliczeniowe?

Tego nie wiem. Jak sprawdzić, czy z moim projektem jest powiązane konto rozliczeniowe?

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

Przejdź do sekcji Dane logowania, którą znajdziesz na pasku bocznym po lewej stronie w sekcji Google Maps Platform > Dane logowania.
Sprawdź, czy klucz interfejsu API, którego obecnie używasz w witrynie, znajduje się na liście. Jeśli tak nie jest, przełącz się na inny projekt i sprawdź dane logowania.
Jeśli nie możesz znaleźć projektu odpowiadającego kluczowi interfejsu API, być może nie masz do niego dostępu. Poproś o pomoc innych użytkowników w organizacji. Jeśli nie możesz znaleźć oryginalnego projektu:
1. Utwórz nowy projekt. Aby to zrobić, wybierz Nowy projekt na liście projektów lub kliknij Utwórz projekt na stronie Menedżera zasobów.
2. Tworzenie nowego klucza interfejsu API Możesz to zrobić na stronie Dane logowania. Następnie kliknij Utwórz dane logowania i wybierz Klucz interfejsu API.

Po znalezieniu projektu w Cloud Console otwórz sekcję Płatności w menu po lewej stronie i sprawdź, czy jest połączone konto rozliczeniowe.

Nie, do mojego projektu nie jest połączone konto rozliczeniowe.

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

Tak, z moim projektem jest powiązane konto rozliczeniowe.

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

Czy podana forma płatności jest już nieważna (np. karta kredytowa straciła ważność)?

Formę płatności możesz dodać, usunąć lub zaktualizować w Cloud Console.

Czy istnieje limit dzienny nałożony przez siebie na interfejs API?

Jeśli masz ustawiony dzienny limit któregoś z interfejsów API, co zwykle pozwala uniknąć nieoczekiwanych wzrostów, możesz rozwiązać ten problem, zwiększając dzienny limit.

Limity dzienne możesz sprawdzić w panelu interfejsów API i usług w Cloud Console. Gdy to zrobisz:

Wybierz projekt, jeśli pojawi się taka prośba.
Wybierz z listy interfejs API i kliknij kartę Limity.

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

Klucze interfejsu API z ograniczeniem adresów IP można używać tylko w usługach internetowych przeznaczonych do działania po stronie serwera (takich jak Geocoding API i inne interfejsy API usług internetowych). Większość z tych usług internetowych ma odpowiadające im usługi w interfejsie Maps JavaScript API (zobacz na przykład usługę geokodowania). Aby korzystać z usług po stronie klienta interfejsu Maps JavaScript API, musisz utworzyć oddzielny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia Strony odsyłające HTTP (patrz Pobieranie, dodawanie i ograniczanie klucza interfejsu API).

Jak usunąć kody błędów: OVER_DAILY_LIMIT lub OVER_QUERY_LIMIT?

Te kody błędów mogą być zwracane z dowolnego 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 nałożony limit użytkowania.
Podana forma płatności nie jest już aktualna (np. karta kredytowa straciła ważność).
Przekroczono limity zapytań na sekundę dla 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.
Uzyskiwanie nowego klucza interfejsu API
Dostosuj limit wykorzystania, aby zwiększyć dzienny limit (w stosownych przypadkach).

Jak usunąć kody błędów: kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED?

Jeśli widzisz element kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED, być może korzystasz z wycofanej wersji pakietu Places SDK na Androida lub Places SDK na iOS. Więcej informacji i listę nowych pakietów SDK znajdziesz na stronie https://goo.gle/places-sdk-deprecation.

Jak naprawić błąd „Ten adres IP, witryna lub aplikacja mobilna nie ma uprawnień do korzystania z tego klucza interfejsu API”?

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

W kluczu interfejsu API są włączone ograniczenia adresu IP (serwera), a nieautoryzowany adres IP próbuje wysłać żądanie.
W kluczu interfejsu API masz włączone ograniczenia dotyczące stron odsyłających (witryny) HTTP, a nieautoryzowana strona odsyłająca próbuje wysłać żądanie.
Ustawienie nazwy pakietu i odcisku cyfrowego powoduje ograniczenie możliwości korzystania z aplikacji na Androida, a nieautoryzowana aplikacja na Androida próbuje wysłać żądanie.
Ograniczasz żądania wysyłane do 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ł wystąpić, jeśli używany był dowolny z interfejsów API usługi internetowej z kluczem interfejsu API z ograniczeniami dotyczącymi odsyłania HTTP. Żądania wysyłane do tych interfejsów API powinny być zidentyfikowane za pomocą klucza interfejsu API z ograniczeniami dotyczącymi adresu IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP. Więcej informacji na temat ograniczania kluczy interfejsu API znajdziesz w artykule Sprawdzone metody dotyczące kluczy interfejsu API.

Wyświetlanie i edytowanie danych uwierzytelniających klucza interfejsu API

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

Otwórz stronę Dane logowania w konsoli Cloud.
Wybierz projekt zawierający klucz interfejsu API, który chcesz sprawdzić.
Aby wyświetlić szczegóły danych logowania, w tym wszelkie ograniczenia ustawione dla klucza, na liście kluczy interfejsu API kliknij jego nazwę.
Zostaną wyświetlone pełne dane logowania wybranego klucza interfejsu API wraz z wszelkimi ograniczeniami skonfigurowanymi dla tego klucza. W tym miejscu można zmienić, usunąć lub zaktualizować ograniczenia.

Jak naprawić błąd „Klucze interfejsu API z ograniczeniami dotyczącymi strony odsyłającej nie mogą być używane z tym interfejsem API”?

Używasz dowolnego z interfejsów API usługi internetowej z kluczem API ograniczonym do odsyłającego 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 jest on już używany z interfejsem Maps JavaScript API.

Usługi Google Maps Platform

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

Tak. Ten proces nosi nazwę „geokodowania”. 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 udostępnia interfejs REST umożliwiający odpowiadanie w formatach JSON i XML.

W jakich krajach dostępne jest geokodowanie?

Kraje obsługiwane obecnie przez geokodery Google Maps Platform znajdziesz w informacjach o zasięgu Map Google.

Dokładność lokalizacji geograficznych może być różna w zależności od kraju, dlatego należy zwrócić uwagę na zwrócone pole location_type, aby sprawdzić, czy znaleziono wystarczająco dużo dopasowania na potrzeby swojego zgłoszenia. Pamiętaj, że dostępność danych geokodowanych zależy od naszych umów z dostawcami danych, więc może ulec zmianie.

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

Geokoder interfejsów API i geokoder Map Google czasami korzystają z innych zbiorów danych (w zależności od kraju). Geokoder interfejsu API jest od czasu do czasu aktualizowany o nowe dane, dzięki czemu z czasem wyniki mogą się zmieniać.

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

Geokoder służy do mapowania adresów ulic na współrzędne geograficzne. Dlatego zalecamy sformatowanie żądań geokodera zgodnie z poniższymi wytycznymi, aby zwiększyć prawdopodobieństwo pomyślnego wyniku:

Podaj adresy zgodnie z formatem używanym przez krajowy urząd pocztowy w danym kraju.
Nie podawaj dodatkowych elementów adresu, takich jak nazwy firm, numery lokalu, numery pięter czy numery apartamentów, które nie są uwzględnione w adresie w sposób określony przez urząd pocztowy w danym kraju. Może to spowodować uzyskanie odpowiedzi z atrybutem ZERO_RESULTS.
Sformatuj kody plus, tak jak tutaj (znaki plusa są znakami zmiany znaczenia w adresie URL %2B, a spacje są przekształcane w adres URL do %20):
- Kod globalny to 4-znakowy numer kierunkowy i co najmniej 6 znaków (kod lokalny 849VCWC8+R9 to 849VCWC8%2BR9).
- Kod złożony to co najmniej 6-znakowy kod lokalny z określoną lokalizacją (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
W miarę możliwości używaj numeru domu zamiast nazwy budynku.
Tam, gdzie to możliwe, najlepiej jest określać przecznice z numerem domu.
Nie podawaj „podpowiedzi”, takich jak punkty orientacyjne w pobliżu.

Jak sformatować adres w USA na autostradzie numerowanej na potrzeby geokodowania?

Geokoder Google Maps Platform wymaga, by autostrady numerowane w USA były wpisane w adresach:

Drogi regionalne: "Co Road NNN", gdzie NNN to numer drogi, np. "Co Road 82"
Drogi stanowe: "State NNN", gdzie Stan to pełna nazwa stanu, a NNN to numer drogi, np. "California 82"
Drogi w Stanach Zjednoczonych: "U.S. NNN", gdzie NNN to numer drogi. np. "U.S. 101"
Amerykańskie sieci międzystanowe: "Interstate NNN", gdzie NNN to numer międzystanowy , np. "Interstate 280"

Kiedy należy używać klasy geokodera interfejsów API, a kiedy usługi geokodowania HTTP?

Przeczytaj dokument Geocoding Strategies (Strategie geokodowania), w którym znajdziesz szczegółowe informacje o wadach i zaletach różnych strategii geokodowania.

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

Usługa Compute Routes dla interfejsów Routes API oraz Directions API umożliwiają podawanie wskazówek dojazdu w przypadku podróży jedno- i wieloetapowych. Opcje wyznaczania trasy pomagają wyznaczać trasy z wykorzystaniem trybu podróży (samochodu), pojedynczej trasy lub zestawu tras oraz ograniczeń (bez dróg płatnych). Usługi te są dostępne w następujących postaciach:

Interfejs żądań/odpowiedzi HTTP (używany w aplikacjach mobilnych i innych) jest zgodny z pakietem Maps SDK na Androida i innymi usługami internetowymi Map Google.
Interfejs JavaScript API w przypadku aplikacji po stronie klienta umożliwia podawanie wskazówek dojazdu za pomocą klasy google.maps.DirectionsService. Klasa DirectionsRenderer może automatycznie tworzyć nakładki i panel wskazówek dojazdu. Dodatkowe przykłady znajdziesz w dokumentacji.
Interfejsy klienta w języku Java, Python, go i Node.js w przypadku aplikacji po stronie serwera zapewniają te same funkcje. Więcej informacji o bibliotekach klienta znajdziesz w artykule Biblioteki klienta interfejsu Directions API.

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

Kraje, w których obecnie dostępne są wskazówki dojazdu w usługach Google Maps Platform, możesz sprawdzić w danych o zasięgu Map Google. Pamiętaj, że dostępność danych o trasach 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?

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

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

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

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

Ograniczenia dotyczące rozmiaru i złożoności wyświetlania pliku KML przy użyciu klasy KmlLayer zostały opisane tutaj.

Jak renderować na mapie pliki KML przechowywane 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 adresem URL, który jest dostępny publicznie, lub do uzyskania dostępu wymaga uwierzytelnienia.

Jeśli tworzysz aplikacje, które korzystają z plików KML hostowanych w witrynach intranetowych, zalecamy wyrenderowanie pliku KML po stronie klienta przy użyciu bibliotek JavaScript innych firm. Plik KML jest analizowany przez przeglądarkę, dlatego wydajność może być niższa niż przy użyciu klasy KmlLayer.

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

Nie ma ograniczeń co do liczby znaczników ani wierzchołków ścieżek obsługiwanych przez Maps Static API. Gdy używasz ikon niestandardowych, w 1 żądaniu możesz określić do 5 unikalnych ikon. Każda z nich może być używana wielokrotnie w obrębie mapy.

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

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

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

Jak zgłosić problem związany z Mapą bazową Google?

Prześlij opinię w Mapach Google, jeśli brakuje w Mapach Google informacji o nieprawidłowych lub brakujących informacjach, takich jak:

nieprawidłowe adresy lub błędne lokalizacje znaczników.
nieprawidłowe nazwy dróg,
nieprawidłowe informacje o drogach jedno- i dwukierunkowych,
drogę przebiegającą nieprawidłowo,
zamknięte drogi,
nieistniejące drogi,

Jeśli chcesz poprawić informacje o miejscu lub firmie, zaproponuj zmianę.

Jeśli treści z Map Google muszą zostać usunięte ze względów prawnych, prześlij żądanie prawne.

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

W jaki sposób monitorowane są wydajność usług używanych z interfejsem Maps JavaScript API?

Niektóre funkcje po stronie klienta służą do zgłaszania powodzenia lub niepowodzenia podczas obliczania docelowego poziomu usług. Te informacje są wysyłane do Google na adres maps.googleapis.com/maps_api_js_slo/log w wywołaniach, które rejestrują informacje o docelowym poziomie usług. Informacje te obejmują stan powodzenia, czas oczekiwania oraz wersję/kanał interfejsu Maps JavaScript API. Aby zwiększyć wydajność, wywołania mogą być grupowane. Aby mieć pewność, że te wywołania nie są blokowane na poziomie przeglądarki, może być konieczne zezwolenie na maps.googleapis.com w Polityce 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 będzie działać interfejs Maps JavaScript API po jego załadowaniu?: Musisz odświeżać stronę, która wczytuje interfejs Maps JavaScript API co najmniej raz na 5 dni.

Google Maps SDK na iOS

Jak usunąć błąd: kGMSPlacesRateLimitExceeded?

Jeśli widzisz ten błąd, być może korzystasz z wycofanej wersji pakietu Places SDK dla iOS. Wyłączyliśmy pakiet Places SDK w wersji 2.7.0 na iOS i nie jest on już dostępny. Jak najszybciej zaktualizuj aplikację do najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.

Podczas debugowania urządzenia z iOS 8.x występują awarie. Co mam zrobić?

Jeśli podczas debugowania występują na urządzeniach z systemem iOS 8.x, wykonaj te czynności, aby wyłączyć przechwytywanie klatek przez GPU w używanym schemacie XCode:

W XCode wybierz Product, Scheme i Manage Schemes (Zarządzaj schematami).
Wybierz schemat i kliknij Edytuj....
Ustaw opcję GPU Frame Capture na Wyłączono. Pamiętaj, że w przypadku niektórych urządzeń ta opcja może nie być dostępna.

Opcja przechwytywania ramek GPU w Xcode na stronie ogólnych urządzeń z iOS

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

Od iPhone'a X urządzenia iPhone mają kształt ekranu z zaokrąglonymi narożnikami, wycięcie u góry na obudowie czujnika i wskaźnik u dołu ekranu umożliwiający wyświetlenie ekranu głównego. Od wersji 11.0 pakietu SDK na iOS firma Apple dodała interfejs Safe Area API, który umożliwia deweloperom umieszczanie elementów w obszarze, w którym nowy kształt ekranu nie zostanie przycięty.

Pakiet SDK Map Google na iOS ma wiele elementów wizualnych i elementów sterujących, takich jak selektor wewnętrzny i link do zgłaszania problemów. W wersji 2.4 nowy kształt ekranu utrudziłby te elementy wizualne i elementy sterujące. W trybie poziomym selektor pięter może być przycinany przez wycięcie lub wskaźnik przycisku strony głównej.

W pakiecie SDK Map Google na iOS w wersji 2.5 te problemy z układem są naprawiane automatycznie. Jeśli używasz aplikacji na iPhonie X lub nowszym, dopełnienie w GMSMapView i GMSPanoramaView jest zwiększane, aby elementy wizualne nie były przycinane.

Domyślnie zawsze bierzemy pod uwagę dopełnienie. W pakiecie SDK Map Google na iOS założono, że dopełnienie ma na celu wypełnienie go w bezpiecznym obszarze. Jeśli projektujesz interfejs z założeniem, że wszystko znajduje się w bezpiecznym obszarze, nie musisz nic robić.

Jeśli masz interfejs, który nie działa z naszym domyślnym dostosowaniem, wprowadziliśmy w GMSMapView nową właściwość o nazwie paddingAdjustBehavior. W GMSMapView można teraz wybrać jeden z trzech rodzajów dostosowania dopełnienia: „Zawsze” (domyślnie), „Automatyczny” lub „Nigdy”.

Jeśli widok GMSMapView jest skonfigurowany do używania „Zawsze” dopełnienia, zawsze dodaje do niego znaczniki bezpiecznego obszaru. Umożliwia to zaprojektowanie interfejsu przy założeniu, że wszystkie miejsca docelowe znajdują się od krawędzi bezpiecznego obszaru. jest to wartość domyślna

Jeśli widok GMSMapView jest skonfigurowany pod kątem automatycznego dopełniania, zawsze wybiera większe dopełnienie lub wprowadzenie bezpiecznego obszaru. Umożliwi to dodanie dopełnienia od krawędzi ekranu, a jednocześnie zapewni, że wszystkie elementy pozostaną w bezpiecznym obszarze.

Jeśli GMSMapView jest ustawione na używanie dopełniania „Never” (Nigdy), nigdy nie dodaje odstępów bezpiecznego obszaru. Tak wygląda sytuacja sprzed wersji 2.5 i może być przydatna, jeśli dopełnienie uwzględnia już bezpieczny obszar lub jeśli inne nasze działania nie działają dobrze z interfejsem. Zgodnie z Warunkami korzystania z usługi Google Maps Platform Twoim obowiązkiem jest dopilnowanie, by logo Google i informacje o prawach autorskich były zawsze widoczne.

Natomiast GMSPanoramaView nie ma opcjonalnej właściwości dopełnienia. Oznacza to, że nie można dostosować dopełnienia, a GMSPanoramaView zawsze stosuje niezbędne dopełnienie, aby mieć pewność, że wszystkie elementy wizualne znajdują się w bezpiecznym obszarze.

Google Maps SDK na Androida

Jak usunąć błąd: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?: Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK dla Androida. Wersja pakietu SDK Miejsc na Androida w Usługach Google Play została wyłączona i nie jest już dostępna. Jak najszybciej zaktualizuj aplikację do najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.

Moja aplikacja zamiast mapy wyświetla tylko puste szare kafelki. Jak rozwiązać ten problem?

Częstym powodem, dla którego zamiast mapy wyświetlane są puste szare kafelki, są problemy z uwierzytelnianiem. Aby rozwiązać te problemy, wykonaj czynności opisane poniżej przy użyciu narzędzia adb logcat.

Upewnij się, że masz zainstalowany adb. Jeśli nie, postępuj zgodnie z tym przewodnikiem.
Zainstaluj aplikację, która pokazuje problem, na urządzeniu lub w emulatorze Androida. Jeśli używasz emulatora Androida, upewnij się, że w jego ustawieniach znajduje się aplikacja Sklep Play.
W terminalu Android Studio uruchom adb logcat -e "Google Maps Android API". Spowoduje to wydrukowanie tylko wierszy, w których komunikat dziennika pasuje do „Google Maps Android API”. (Opcjonalnie możesz wysłać dziennik do pliku tekstowego, dodając: > logcat.txt).
Odtwórz problem na urządzeniu i sprawdź, czy nie występują typowe błędy, takie jak:

W pliku manifestu jest odwołanie do nieprawidłowego lub niezamierzonego klucza interfejsu API.
W projekcie nie są włączone płatności.
Pakiet SDK nie jest włączony w interfejsach API projektu.
Do ograniczeń klucza interfejsu API jest dodawany nieprawidłowy odcisk cyfrowy SHA1.
Plik build.gradle nie zawiera zależności usługi Google Play.

Podpisywanie URL

Czy mogę podpisywać adresy URL za pomocą języka JavaScript?

Zdecydowanie odradzamy podpisywanie adresów URL za pomocą JavaScriptu, ponieważ spowodowałoby to ujawnienie użytkownikom tajnych adresów URL. Dlatego podpisy powinny być generowane tylko przez komponenty po stronie serwera.

Dlaczego na moje żądania usługi internetowej interfejsu API Map Google wyświetla się błąd HTTP 403 Forbidden?

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

Podpis został określony, ale jest nieprawidłowy dla tego żądania.
Żądanie określa klucz interfejsu API dla abonamentu Premium Google Maps Platform, ale nie określa podpisu, a wywoływana usługa wymaga, aby żądania wysyłane z użyciem klucza interfejsu API zawierały prawidłowy podpis.
Podpis został określony, ale nie określono powiązanego klucza interfejsu API Google Maps Platform Premium.