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ą programistom umieszczanie Map Google w aplikacjach mobilnych i na stronach internetowych oraz pobieranie danych z Map Google. Dostępnych jest kilka ofert. W zależności od potrzeb możesz używać jednego z tych interfejsów API i pakietów SDK lub ich kombinacji:

Mapy:

Trasy:

Miejsca:

Środowisko:

Jak zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki z Google Maps Platform.

Którego interfejsu API potrzebuję?

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

Jak zacząć używać interfejsów API w witrynie?

Zapoznaj się z przewodnikiem Przegląd, Deweloper i Pierwsze kroki w przypadku konkretnego interfejsu API lub pakietu SDK, który Cię interesuje. Na przykład zapoznaj się z przewodnikami po pakiecie Maps SDK na Androida lub Maps JavaScript API.

W jakich krajach dostępna jest usługa Google Maps Platform?

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

Zobacz też:

Co zrobić, aby usługi Google Maps Platform wyświetlały się w języku innym niż angielski?
W których 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 oglądanych map na swojej stronie lub blogu bez konieczności programowania ani korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.

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

Aby dodać mapy do aplikacji na Androida, użyj pakietu Maps SDK na Androida.

Aby włączyć 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 przeglądarek przeznaczonych zarówno na komputery, jak i na urządzenia wyposażone w przeglądarkę z pełną funkcjonalnością JavaScript, takie jak Apple iPhone.

W przypadku aplikacji kierowanych na urządzenia, które nie są odpowiednie do korzystania z interfejsu Maps JavaScript API, Maps Static API dostarcza obrazy map w formatach GIF, JPG i PNG, ze znacznikami i liniami łamanymi. Pamiętaj, że używanie statycznego interfejsu Maps Static API poza aplikacjami opartymi na przeglądarce wymaga, by obraz mapy był połączony z Mapami Google.

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

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

Komputer

Aktualna wersja Microsoft Edge (Windows), z wyłączeniem trybu IE.
Dwie najnowsze główne stabilne wersje przeglądarki Firefox (Windows, macOS, Linux).
Dwie najnowsze główne stabilne wersje Chrome (Windows, macOS, Linux).
Dwie najnowsze główne stabilne wersje Safari (macOS).

Android

Aktualna wersja Chrome na Androida 4.1 lub nowszego.
Komponent WebView Chrome na Androidzie 4.4 i nowszych.

iOS

Safari na urządzeniach mobilnych z bieżącą i poprzednią główną wersją systemu iOS.
UIWebView i WKWebView w aktualnej i poprzedniej głównej wersji iOS.
Aktualna wersja Chrome na iOS.

Czy mogę drukować mapy za pomocą interfejsu Maps JavaScript API?

Drukowanie z użyciem interfejsu Maps JavaScript API nie jest obsługiwane. Przyczyną jest to, że obsługa drukowania jest niespójna w najczęściej używanych przeglądarkach.

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

Aby być na bieżąco z informacjami o różnych ofertach dla deweloperów usług geograficznych Google, subskrybuj bloga o Google Maps Platform.

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

Informacje o dostępnych opcjach pomocy znajdziesz w artykule Pomoc i materiały dotyczące Google Maps Platform.

Kiedy dostępna jest pomoc techniczna?

Zespół pomocy jest dostępny przez całą dobę, 5 dni w tygodniu (od poniedziałku od poniedziałku od 9:00 czasu tokijskiego do 17:00 czasu pacyficznego w piątek) 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 konta Google (np. jan@mojafirma.com lub jan@gmail.com), możesz spróbować go odzyskać, odzyskując lub resetując hasło. Przeczytaj artykuł Jak odzyskać konto Google lub Gmail w Centrum pomocy konta Google.

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 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ś właściciela projektu, aby dodał Cię jako właściciela 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 żadnego z obecnych właścicieli projektu: jeśli nie wiesz, kto jest właścicielem projektu lub jest on niedostępny, skontaktuj się z zespołem pomocy, aby poznać dodatkowe opcje przywracania 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 lub 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 obecnym właścicielem projektu i poproś go o dodanie Twojego nowego konta Google do projektu.

Czy mogę używać pakietu SDK Maps and Places dla iOS na komputerach Mac z procesorami ARM?

Programowanie na nowych Macach opartych na architekturze Arm jest możliwe, ale wymaga utworzenia i uruchomienia na fizycznym urządzeniu z iOS. Jest to tymczasowe ograniczenie, które zamierzamy dodać w ramach dodatkowej obsługi programowania na symulatorach.

Warunki korzystania z usługi

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

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

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

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

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

Jednak nie chcemy używać Google Maps Platform w niektórych miejscach: mapy wskazujące miejsca, w których można kupić narkotyki w danym mieście, lub inne nielegalne działania. Szanujemy też prywatność użytkowników, więc Google Maps Platform nie powinno być wykorzystywane do identyfikowania prywatnych informacji o poszczególnych osobach.

Zanim opracujesz i uruchomisz aplikację, skonsultuj się z prawnikiem, aby ustalić, czy jest ona zgodna z Warunkami korzystania z usługi Google Maps Platform. Inżynierowie Google mogą zaoferować jedynie pomoc techniczną 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 dokładnie zapoznaj się z Warunkami korzystania z interfejsów API Map Google.

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

Nie można uzyskać dostępu do fragmentów map ani zdjęć satelitarnych za pomocą żadnych mechanizmów innych niż Google Maps Platform (takich jak tworzenie własnego interfejsu API map lub korzystanie ze skryptu pobierania elementów do zbiorczego pobierania). Dostęp Twojej aplikacji do kafelków będzie zablokowany, jeśli będzie korzystała 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 wyświetlaniu danych (śledzenia) w czasie rzeczywistym w usługach Google Maps Platform, pod warunkiem że aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Czy mogę używać Map Google w mojej aplikacji innej niż internetowa?

Tak, usług Google Maps Platform można teraz używać w aplikacjach innych niż internetowe pod warunkiem, że 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. Usługi Mapy Google, Trasy, Miejsca i Środowisko mogą być używane 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), może on nie zawierać żadnych danych z Google Maps Platform, w tym zdjęć. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform.

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

Nie zbieramy już tych danych. Użycie parametru indexing zostało wycofane i nie działa. Nie musisz już jednoznacznie rezygnować, ale zachęcamy do usunięcia tego parametru jak najszybciej.

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

Czy mogę wygenerować obraz mapy za pomocą statycznego interfejsu API Map Google, który zapisuję i wyświetlam w mojej witrynie?

Nie można przechowywać ani udostępniać kopii zdjęć wygenerowanych w witrynie za pomocą statycznego interfejsu API Map Google. Wszystkie strony internetowe, które wymagają obrazów statycznych, muszą łączyć atrybut src w tagu HTML img lub atrybut CSS background-image tagu HTML div bezpośrednio ze statycznym interfejsem Maps API. Dzięki temu wszystkie obrazy map są wyświetlane w treści HTML strony, a Google bezpośrednio przesyła je użytkownikom.

Limity wykorzystania i rozliczenia

Jak skonfigurować płatności w projekcie?

Zobacz Pierwsze kroki z Google Maps Platform.

Jak klienci poziomu bezpłatnego Google Cloud Platform mogą przejść na konto płatne?

Program poziomu bezpłatnego Google Cloud Platform zapewnia klientom bezpłatny okres próbny z 300 USD do wykorzystania w dowolnej usłudze Google Cloud Platform (GCP), w tym w 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 konsolę Cloud.

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

Nie ma dziennych limitów liczby żądań, które możesz wysłać do usług Google Maps Platform. Jedyne limity wykorzystania są związane z maksymalną liczbą zapytań na sekundę (QPS) lub zapytań na minutę (QPM).

W przypadku macierzy odległości limit jest ustawiany w zdarzeniach na sekundę (EPS) obliczanych jako suma zapytań po stronie klienta i po stronie serwera.

W przypadku tras:macierz tras Compute limit jest wyrażony 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 limit wykorzystania każdego interfejsu API.

API	Limit wykorzystania
Weryfikacja adresów	6000 QPM
Widok z lotu ptaka: wyszukiwanie wideo	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 tys. EPM
Mapy dynamiczne	30 000 QPM
Wysokość	6000 QPM
Geokodowanie	3000 QPM
Geolokalizacja	6000 QPM
Interfejs API Tiles Map: kafelki 2D i kafelki Street View	6000 QPM i 15 000 QPD
Interfejs API Tiles: fotorealistyczne kafelki 3D	10000 QPD
Interfejs API Tiles: fotorealistyczne kafelki 3D: mechanizm renderowania	12 000 QPM
Miejsca	6000 QPM
Pyłki	6000 QPM
Drogi	30 000 QPM
Trasy: trasy Compute	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 dotyczące wszystkich żądań wysyłanych do dowolnego interfejsu API podlegającego rozliczeniu.

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

Jak obliczany jest koszt użycia?

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

Więcej informacji o opłatach za interfejsy Google Maps Platform znajdziesz w artykule na temat płatności za Mapy, trasy, miejsca i środowisko.

Jak są liczone wczytywania mapy w Google Maps Platform?

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

Strona internetowa lub aplikacja wyświetla mapę przy użyciu interfejsu Maps JavaScript API.
Aplikacja wysyła do interfejsu Maps static API żądanie pojedynczego obrazu mapy.

Opłaty za panoramy Street View są naliczane niezależnie od wczytywania map:

Za każde żądanie statycznej (nieinteraktywnej) panoramy Street View wysyłanej do interfejsu Street View Static API jest naliczana opłata.
Opłata za dynamiczną panoramę Street View jest naliczana za każde wystąpienie obiektu panoramy w interfejsie Maps JavaScript API, pakiecie Maps SDK na Androida lub Maps SDK na iOS.

Po wczytaniu strony internetowej lub aplikacji, mapy, statycznego obrazu mapy czy panoramy Street View, wszelkie interakcje użytkownika z tą mapą, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie powodują dodatkowego wczytywania mapy ani nie wpływają na limity jej wykorzystania.

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

Jak mogę monitorować wykorzystanie?

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

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

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

Skonfiguruj rozliczenia, jeśli jeszcze nie masz tego za sobą.
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 prawym pasku bocznym.

Więcej informacji znajdziesz w artykułach Raportowanie na platformie Google Maps Platform oraz w artykułach Monitorowanie wykorzystania interfejsu API i Ograniczanie wykorzystania interfejsu API.

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

Jeśli przekroczysz limity zapytań na sekundę w danej usłudze Google Maps Platform, interfejs API zwróci komunikat o błędzie. W przypadku wielokrotnego przekroczenia limitów dostęp do interfejsu API może zostać tymczasowo zablokowany.

Jeśli przekroczysz limity zapytań na sekundę żądań lub w inny sposób nadużywasz usługi, żądania będą zwracać 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 sieciowych mają równoważną usługę po stronie klienta w Maps JavaScript API: Directions, Macierz odległości, Wysokość względna i Geokodowanie.

Przekroczono limity wykorzystania

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

Oznacza to, że usługa sieciowa przestanie wysyłać normalne odpowiedzi i wróci do zwracania tylko kodu stanu OVER_QUERY_LIMIT do momentu, aż zezwolono na dalsze wykorzystanie. Może się to stać w ciągu kilku sekund, jeśli błąd został wyświetlony, ponieważ aplikacja wysłała zbyt wiele żą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 ma duży ruch. Czy mogę korzystać z usług Google Maps Platform?

Tak. Zalecamy jednak zapoznanie się z limitami wykorzystania poszczególnych usług Google Maps Platform, na których bazuje Twoja aplikacja.

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

Jeśli po utworzeniu konta rozliczeniowego przekroczysz bezpłatny, miesięczny limit wykorzystania, wynoszący 200 USD, a na koncie rozliczeniowym nie będzie skonfigurowanej 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ędą obliczane i rozliczane wykorzystanie?

Wykorzystanie jest obliczane na koniec każdego dnia i wyceniane zgodnie z cennikiem. Na koniec każdego miesiąca całkowite wykorzystanie jest obciążane formą płatności powiązaną z Twoim 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 woluminy obciążenia mapy do 200 USD miesięcznie, wykorzystanie nie jest pobierane. Opłaty za wykorzystanie powyżej kwoty 200 USD miesięcznie będą obciążać Twoje konto rozliczeniowe. Więcej informacji znajdziesz w przewodniku dotyczącym płatności za Google Maps Platform.

Czy ceny są dostępne w innych walutach?

Dodatkowe waluty mogą być dostępne w konsoli. Jeśli wybierzesz inną walutę, stawki zostaną przeliczone z równowartości w USD podanej w naszym cenniku.

Skonfigurowałem rozliczenia. Jak wyświetlić rachunek?

Na początku każdego miesiąca Google obciąża Cię za działania z poprzedniego miesiąca za pomocą określonej formy płatności. Więcej informacji na temat rachunku znajdziesz w przewodniku dotyczącym płatności za Google Maps Platform.

Dodatkowe zasoby:

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

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

Google Maps Platform pozwala ustawić dzienne limity żądań i maksymalne dzienne limity rozliczeń. Możesz ustawić maksymalny dzienny limit wykorzystania, aby zabezpieczyć się przed nieoczekiwanymi wzrostami. Możesz też skonfigurować alerty dotyczące budżetu tak, aby otrzymywać e-maile z powiadomieniami, gdy opłaty na koncie rozliczeniowym osiągną wyznaczony przez Ciebie próg.

Ograniczenie maksymalnego dziennego limitu naliczania należności:

Aby uniknąć dużych opłat, możesz ustawić dzienny limit wykorzystania, aby zabezpieczyć się 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.
Jeśli pojawi się taka prośba, wybierz projekt.
Wybierz interfejs API z listy, a następnie kliknij kartę Limity.
Kliknij ikonę edycji obok limitu „Liczba żądań dziennie”.

Możesz też edytować wiele limitów dla wielu interfejsów API za pomocą panelu uprawnień i administracyjnych.

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

Skonfiguruj alerty dotyczące budżetu, aby wysyłać do administratorów odpowiedzialnych za płatności e-maile z powiadomieniami, gdy obciążenia na koncie rozliczeniowym przekroczą określony przez Ciebie próg. Administratorzy odpowiedzialni za płatności będą otrzymywać e-maile z powiadomieniami, gdy szacowane opłaty na koncie rozliczeniowym przekroczą 50, 90% lub 100% progu.

Widzę komunikat, że mój projekt jest połączony z „kontem przenoszonym przez Google Maps Platform”, ale nie mam do niego dostępu. Co mam zrobić?

„Konto przejściowe Google Maps Platform” zostało stworzone, aby pomóc niektórym klientom w przejściu na nowy abonament z płatnością według wykorzystania. To konto przejściowe pozwoliło Google przyznać tym klientom jednorazowe środki, które umożliwiły im dalsze korzystanie z Google Maps Platform do poziomu bezpłatnego, który wynosi 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, załóż własne konto rozliczeniowe i nadal korzystaj z poziomu bezpłatnego, 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 to 1 żądanie dziennie? Jak zwiększyć ten limit?

Jeśli do projektu nie utworzono ani nie dołączono konta rozliczeniowego, interfejsy API Maps Platform będą ograniczone do 1 żądania dziennie. Możesz zwiększyć limit, tworząc i dołączając konto rozliczeniowe. Aby dowiedzieć się, jak to zrobić, zobacz Pierwsze kroki z Google Maps Platform.

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

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

Otrzymujesz to powiadomienie, ponieważ ustaliliśmy, że Twoje konto korzysta z kilku kont rozliczeniowych. Stanowi 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 artykule Najczęstsze pytania dotyczące naruszeń kont rozliczeniowych.

Korzystanie z Google Maps Platform

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

Za każdym razem, gdy używasz usług Google Maps Platform, musisz dołączyć klucz interfejsu API, aby zweryfikować żądanie. Z Google Maps Platform można korzystać w aplikacjach na Androida, iOS i w aplikacjach internetowych, a także w usługach internetowych HTTP.

Klucz interfejsu API:

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

Podpis cyfrowy:

Podpis cyfrowy jest generowany przy użyciu tajnego klucza podpisywania URL otrzymanego od Google. Podpisy cyfrowe są używane w interfejsach Maps Static API i Street View Static API.

Ograniczenia:

Ograniczenia dotyczące kluczy interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API w celu zwiększenia bezpieczeństwa. Więcej informacji znajdziesz w artykule o sprawdzonych metodach zabezpieczania interfejsów API.
Do klucza interfejsu API możesz dodać ograniczenie aplikacji. Po ograniczeniu dostępu klucz będzie działać tylko na platformach, które obsługują tego typu ograniczenie. Dostępne są 4 typy ograniczeń aplikacji. Interfejsy API wymuszające ten sam typ ograniczenia mogą używać tego samego klucza ograniczonego.
- Adresy IP (pojedyncze serwery) na potrzeby interfejsów API usług sieciowych.
- Strony odsyłające HTTP (witryny internetowe) – przeznaczone do użycia z internetowymi interfejsami API.
- Ograniczenia aplikacji na Androida (według nazwy pakietu i odcisku palca) – używane z pakietem Maps SDK na Androida.
- Ograniczenia aplikacji na iOS (według identyfikatora pakietu na iOS) – używane z pakietem SDK Map Google na iOS.
Możesz też dodać ograniczenie interfejsu API do klucza interfejsu API. Więcej informacji znajdziesz w artykule o pobieraniu, dodawaniu i ograniczaniu klucza interfejsu API.

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

API/SDK	Dane logowania i ograniczenia aplikacji
Maps SDK na Androida	Klucz interfejsu API z ograniczeniem Androida¹
Pakiet SDK Miejsc na Androida	Klucz interfejsu API z ograniczeniem Androida¹
Maps SDK 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¹
Map Tiles API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Aerial View API	Klucz interfejsu API z ograniczeniem adresu IP¹
Statyczny interfejs API Map Google	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹ + podpis cyfrowy²
Street View Static API	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹ + podpis cyfrowy²
Interfejs API Maps Embed	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹
Interfejs Address 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¹
Elevation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs Geocoding API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs API geolokalizacji	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¹
Interfejs Time Zone API	Klucz interfejsu API z ograniczeniem adresu IP¹
Interfejs 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 dla zwiększenia bezpieczeństwa zdecydowanie zalecamy ograniczenie wszystkich kluczy API.

² W zależności od użycia podpis cyfrowy może być wymagany w przypadku interfejsów Maps Static API i Street View Static API. 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 z odsyłającej HTTP na ograniczenie adresu IP?

Ważne: jeśli używasz dowolnego z interfejsów API usług internetowych z kluczem API, który ma ograniczenia dotyczące stron odsyłających, żądania zakończy się niepowodzeniem i pojawi się komunikat o błędzie: „Klucze interfejsu API nie mogą mieć ograniczeń dotyczących stron odsyłających, gdy są używane z tym interfejsem API”. Przejdź na klucz interfejsu API z ograniczeniami adresów IP.

Zanim zmienisz typ ograniczenia klucza interfejsu API z strony odsyłającej HTTP na adres IP, sprawdź, czy wszystkie interfejsy API korzystające z klucza interfejsu API obsługują typ ograniczenia adresu IP. Interfejsy API tego samego typu ograniczeń mogą używać tego samego klucza z ograniczeniami. Jeśli chcesz wyegzekwować więcej niż 1 ograniczenie, dodaj oddzielny klucz z wymaganym ograniczeniem. Zobacz, jak dodać nowy klucz interfejsu API.

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

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

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

Jak uzyskać nowy klucz interfejsu API?

Zobacz Pierwsze kroki z Google Maps Platform.

Jak 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 na tych stronach:

Aby sprawdzić, w której wersji Google Maps Platform został wprowadzony i naprawiony dany błąd, skorzystaj z narzędzia Google Maps Platform Issue Tracker na stronie:

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

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

Wystarczy określić parametr wywołania zwrotnego podczas wczytywania interfejsu API. Więcej informacji i przykładowy kod znajdziesz w rozdziale Getting Started (Pierwsze kroki) w 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ł wczytywać najodpowiedniejszy język na podstawie lokalizacji użytkownika lub ustawień przeglądarki. Niektóre interfejsy API umożliwiają bezpośrednie ustawienie języka podczas wysyłania żądania. Więcej informacji o tym, jak ustawić język, znajdziesz w dokumentacji poszczególnych interfejsów API:

Obsługiwane języki:

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

Kod języka	Język	Kod języka	Język
af	afrikaans	ja	japoński
sq	albański	kn	kannada
AM	amharski	kk	kazachski
ar	arabski	km	khmerski
hy	ormiański	ko	koreański
az	azerski	ky	kirgiski
eu	baskijski	lo	laotański
be	Białoruski	lv	łotewski
bn	bengalski	lt	litewski
bs	bośniacki	mk	macedoński
bg	bułgarski;	ms	malajski
my	birmański	ml	malajalam
ca	kataloński	mr	marathi
zh	chiński	mn	mongolski
zh-CN	chiński (uproszczony)	ne	nepalski
zh-HK	chiński (Hongkong)	nie	norweski
zh-TW	chiński (tradycyjny)	pl	polski
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
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 do Google Maps Platform można uzyskać dostęp przez protokół SSL (HTTPS)?

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

Pamiętaj, że Maps Static API nie obsługuje adresów URL ikon niestandardowych, które korzystają z HTTPS. Wyświetlana jest 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 na odpowiednim forum. Umożliwi to innym programistom sprawdzenie błędu i wyeliminowanie potencjalnych problemów z Twoim kodem.

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

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

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

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

Maps SDK na Androida i Maps SDK na iOS używają plików cookie zgodnie z Polityką prywatności Google, co obejmuje m.in. obliczanie liczby aktywnych użytkowników w ciągu dnia i 7 dni oraz zapobieganie nadużyciom usług. Pliki te nie są powiązane z żadnym kontem Google, na które się zalogujesz, ani rejestrowane z pozostałymi informacjami zebranymi przez wywołania interfejsu API.

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

Zespół Google ds. relacji z deweloperami Google regularnie publikuje informacje w Stack Overflow – edytowanej wspólnie z nim stronie z pytaniami i odpowiedziami dla programistów. To świetne miejsce do zadawania pytań technicznych na temat tworzenia i utrzymywania aplikacji Map Google. Więcej informacji na temat zadawania pytań dotyczących Stack Overflow znajdziesz na stronie Pomoc.

Jeśli chcesz uzyskać pomoc, pamiętaj, że:

Przeszukaj bieżące dyskusje. Możliwe, że ktoś inny napotkał już podobny problem i rozwiązał go z korzyścią.
Jeśli to możliwe, prześlij link do swojej witryny. Publikuj fragmenty kodu tylko wtedy, gdy nie jest on łatwo widoczny online.
Podaj wszystkie istotne informacje, w tym wersje przeglądarki, błędy i inne informacje, 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, skorzystaj z poniższych linków, aby znaleźć wyjaśnienia kodów błędów:

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

W pewnych okolicznościach może być wyświetlane zaciemnione zdjęcie lub „negatywne” zdjęcie Street View z tekstem „Tylko do celów programistycznych”. Zwykle oznacza to problemy z kluczem interfejsu API lub płatnościami. Aby korzystać z usług Google Maps Platform, musisz mieć konto rozliczeniowe, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Aby rozwiązać ten problem:

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 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. Pozwoli Ci to sprawdzić, czy Twoja witryna prawidłowo implementuje licencjonowane 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 widzisz te komunikaty, nie używasz poprawnie klucza interfejsu API:

Ostrzeżenie interfejsu Google Maps JavaScript API: NoApiKeys
Błąd interfejsu JavaScript API Map Google: 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 wstaw YOUR_API_KEY w kodzie poniżej 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 w sieci generowany przez Twoją witrynę. W Chrome możesz to sprawdzić na karcie DevTools w Narzędziach deweloperskich. Zobaczysz tu żądania sieci wysłane przez Twoją witrynę. Żądania wysyłane za pomocą interfejsu Maps JavaScript API znajdują się pod ścieżką maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Podczas wyświetlania karty Sieć warto filtrować ruch w sieci według parametru maps/api/js.

Nie, nie używam klucza interfejsu API.

Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Jeśli nie widzisz przewodnika 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, czy z projektem jest połączone konto rozliczeniowe.

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

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

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

Przejdź do sekcji Dane logowania, która jest dostępna na pasku po lewej stronie w sekcji Google Maps Platform > Dane logowania.
Sprawdź, czy na liście znajduje się klucz interfejsu API, którego obecnie używasz w witrynie. Jeśli tak nie jest, przełącz się na inny projekt i sprawdź w nim dane logowania.
Jeśli nie możesz znaleźć projektu ze swoim kluczem interfejsu API, być może nie masz dostępu do tego projektu. Poproś o pomoc innych użytkowników ze swojej organizacji. Jeśli nie można znaleźć oryginalnego projektu, wykonaj te czynności:
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 kolejno Utwórz dane logowania i Klucz interfejsu API.

Po znalezieniu projektu w Cloud Console sprawdź, czy powiązane jest z nim konto rozliczeniowe w sekcji Płatności w menu po lewej stronie.

Nie, konto rozliczeniowe nie jest połączone z moim projektem.

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

Tak, z moim projektem jest połączone konto rozliczeniowe.

Świetnie! Upewnijmy się, że 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ść)?

Formy płatności możesz dodawać, usuwać i aktualizować w Cloud Console.

Czy w przypadku interfejsu API przekroczono samodzielnie nałożony dzienny limit?

Jeśli masz ustawiony limit dzienny dla któregoś z interfejsów API, co zwykle zapobiega nieoczekiwanemu wzrostowi liczby wyświetleń, możesz rozwiązać ten problem, zwiększając limit dzienny.

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

Jeśli pojawi się taka prośba, wybierz projekt.
Wybierz interfejs API z listy, a następnie kliknij kartę Limity.

Czy klucz interfejsu API ma ograniczenie adresów IP?

Kluczy interfejsu API z ograniczeniem adresów IP można używać tylko w przypadku usług internetowych przeznaczonych do użytku po stronie serwera (np. Geocoding API i innych interfejsów API usług sieciowych). Większość z tych usług internetowych ma swoje odpowiedniki w Maps JavaScript API (zobacz np. usługę geokodowania). Aby korzystać z usług po stronie klienta Maps JavaScript API, musisz utworzyć oddzielny klucz interfejsu API, który można zabezpieczyć ograniczeniem stron odsyłających HTTP (zobacz Pobieranie, dodawanie i ograniczanie klucza interfejsu API).

Jak rozwiązać problem z kodami błędów: OVER_DAILY_LIMIT lub OVER_QUERY_LIMIT?

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.
Z projektem nie jest powiązane konto rozliczeniowe.
Przekroczono nałożony limit wykorzystania.
Podana forma płatności straciła ważność (na przykład wygasła karta kredytowa).
Przekraczasz 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.
Wygeneruj nowy klucz interfejsu API.
Dostosuj limit wykorzystania, aby zwiększyć limit dzienny (w odpowiednich przypadkach).

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

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

Jak usunąć błąd „Ten adres IP, witryna lub aplikacja mobilna nie ma uprawnień do używania tego klucza interfejsu API”?

Istnieją różne sytuacje, które mogą powodować ten błąd:

W kluczu API masz włączone ograniczenia dotyczące adresów 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 HTTP (witryna) i nieautoryzowana strona odsyłająca próbuje wysłać żądanie.
Ograniczyłeś możliwość korzystania z aplikacji na Androida przez ustawienie nazwy pakietu i odcisku palca, a nieautoryzowana aplikacja na Androida próbuje wysłać żądanie.
Żądania z aplikacji na iOS zostały ograniczone przez określenie identyfikatorów pakietów, a nierozpoznana aplikacja na iOS próbuje wysłać żądanie.
Ten błąd mógł wystąpić, jeśli używany był dowolny z interfejsów API usługi internetowej z kluczem API z ograniczeniami dotyczącymi stron odsyłających HTTP. Żądania wysyłane do tych interfejsów API powinny być oznaczone kluczem interfejsu API z ograniczeniami dotyczącymi adresów IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP. Więcej informacji o ograniczaniu kluczy interfejsu API znajdziesz w artykule o sprawdzonych metodach dotyczących kluczy interfejsu API.

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

Aby wyświetlić klucze interfejsu API i zarządzać ograniczeniami, wykonaj te czynności:

W Cloud Console otwórz stronę Dane logowania.
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 nazwę klucza.
Zostaną wyświetlone pełne dane uwierzytelniające wybranego klucza interfejsu API wraz ze wszystkimi ograniczeniami skonfigurowanymi dla tego klucza. Tutaj możesz zmienić, usunąć lub zaktualizować ograniczenia.

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

Używasz dowolnego z interfejsów API usług sieciowych z kluczem API ograniczonym do strony odsyłającej HTTP. Ze względów bezpieczeństwa interfejsy API usług sieciowych 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 z interfejsem Maps JavaScript API.

Usługi Google Maps Platform

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

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

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

W jakich krajach jest dostępne geokodowanie?

Aby sprawdzić, jakie kraje są obecnie obsługiwane przez geokodery Google Maps Platform, sprawdź dane o zasięgu Map Google.

Dokładność geokodowanych lokalizacji może się różnić w zależności od kraju, dlatego warto użyć zwróconego pola location_type, aby sprawdzić, czy znaleziono dopasowanie dostatecznie dobrze na potrzeby Twojej aplikacji. Pamiętaj, że dostępność danych geokodowania zależy od naszych umów z dostawcami danych i może ulec zmianie.

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

Geokoder interfejsu API i geokoder Map Google czasami używają różnych zbiorów danych (w zależności od kraju). Geokoder interfejsu API jest co jakiś czas aktualizowany o nowe dane, więc możesz spodziewać się zmian lub poprawy wyników z czasem.

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

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

Podaj adresy w formacie używanym przez krajowy urząd pocztowy w danym kraju.
Nie podawaj dodatkowych elementów adresowych, takich jak nazwy firm, numery działów, numery pięter lub numery lokali, które nie są uwzględnione w adresie zgodnie z definicją usług pocztowych w danym kraju. Jeśli to zrobisz, możesz otrzymać odpowiedź z atrybutem ZERO_RESULTS.
Sformatuj kody plus zgodnie z poniższym opisem (znaki plusa są zmieniane w adres URL wraz ze znakami %2B, a spacje zawierają kod %20 ze znakami zmiany znaczenia dla adresu URL):
- kod globalny to 4-znakowy kod kierunkowy i co najmniej 6-znakowy kod lokalny (849VCWC8+R9 to 849VCWC8%2BR9).
- złożony kod to co najmniej 6-znakowy kod lokalny z konkretną lokalizacją (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
W miarę możliwości używaj ulicy, w której znajduje się obiekt, a nie nazwy budynku.
W miarę możliwości używaj adresów numerów ulic, a w miarę możliwości określać przecznice.
Nie podawaj „wskazówek”, takich jak punkty orientacyjne w pobliżu.

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

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

Drogi hrabstwa: "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 autostrady. np. "U.S. 101"
Połączenia międzystanowe w USA: "Interstate NNN", gdzie NNN to numer międzystanowy, np. "Interstate 280"

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

Zapoznaj się z dokumentem Geocoding Strategies, w którym znajdziesz informacje o zaletach i wadach różnych strategii geokodowania.

Jak udostępnić wskazówki dojazdu w Google Maps Platform?

Usługa Compute Routes w interfejsie Routes API oraz Directions API umożliwia podawanie wskazówek dojazdu dla przejazdów jedno- i wieloetapowych. Opcje wyznaczania trasy pomagają kształtować wskazówki na podstawie środka transportu (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.
JavaScript API dla aplikacji po stronie klienta umożliwia podawanie wskazówek dojazdu za pomocą klasy google.maps.DirectionsService. Klasa DirectionsRenderer może automatycznie tworzyć dla Ciebie nakładki i panel wskazówek. Dodatkowe przykłady znajdziesz w dokumentacji.
Interfejsy klienta Java, Python, go i Node.js w przypadku aplikacji po stronie serwera 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 są obecnie obsługiwane wskazówki dojazdu w usługach Google Maps Platform, zapoznaj się z danymi o zasięgu Map Google. Pamiętaj, że dostępność informacji 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 DYstans Matrix API obsługują wszystkich partnerów Transportu publicznego Google 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 programistom nakładanie na mapę plików KML/KMZ i GeoRSS. Dokumentację i przykłady znajdziesz tutaj.

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

Limity rozmiaru i złożoności wyświetlania pliku KML za pomocą klasy KmlLayer znajdziesz 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 wymaga uwierzytelnienia.

Jeśli musisz tworzyć aplikacje korzystające z plików KML hostowanych w witrynach intranetowych, zalecamy renderowanie pliku KML po stronie klienta przy użyciu zewnętrznych bibliotek JavaScript. Ponieważ przeglądarka analizuje plik KML, wydajność może być niższa niż w przypadku klasy KmlLayer.

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

Nie ma ograniczeń co do liczby znaczników lub wierzchołków ścieżek obsługiwanych przez statyczny interfejs API Map Google. Jeśli używasz ikon niestandardowych, dla każdego żądania możesz określić do 5 unikalnych ikon, ale każdej z nich można używać wiele razy na mapie.

Adresy URL ze statycznego interfejsu API Map Google mogą zawierać maksymalnie około 8192 znaków. Ograniczenie liczby znaczników i wierzchołków ścieżki,które można określić na podstawie liczby miejsc po przecinku podczas określania poszczególnych par szerokości i długości geograficznej. Informacje o tym, jak używana liczba miejsc po przecinku przekłada się na dokładność na Ziemi, znajdziesz w artykule w Wikipedii poświęconym stopniom dziesiętnym.

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

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ą bazową Google?

Prześlij opinię w Mapach Google w przypadku błędnych lub brakujących informacji na mapie, takich jak:

nieprawidłowe adresy lub błędne lokalizacje znaczników.
nieprawidłowe nazwy dróg,
Nieprawidłowe informacje o drodze jednokierunkowej lub dwukierunkowej.
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 muszą zostać usunięte ze względów prawnych, prześlij wniosek prawny.

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

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

Niektóre funkcje po stronie klienta są dostosowane do raportowania sukcesu lub niepowodzenia przy obliczaniu docelowego poziomu usług. Te informacje są wysyłane do Google na adres maps.googleapis.com/maps_api_js_slo/log w wywołaniach rejestrujących informacje o docelowym poziomie usług. Informacje te obejmują stan powodzenia, czas oczekiwania oraz wersję i kanał używanego interfejsu Maps JavaScript API. Wywołania mogą być grupowane w celu zapewnienia wydajności. Aby wywołania te nie były blokowane na poziomie przeglądarki, być może trzeba będzie zezwolić na maps.googleapis.com w Content Security Policy. 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ć Maps JavaScript API po jego wczytaniu?: Musisz co najmniej raz na 5 dni odświeżać stronę, która wczytuje interfejs Maps JavaScript API.

Google Maps SDK na iOS

Jak naprawić błąd: kGMSPlacesRateLimitExceeded?

Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK na iOS. Pakiet Places SDK na iOS w wersji 2.7.0 został wyłączony i nie jest już dostępny. Jak najszybciej zaktualizuj aplikację do najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.

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

Jeśli podczas debugowania urządzeń z iOS 8.x wystąpią problemy, wykonaj te czynności, aby wyłączyć przechwytywanie ramek GPU w obecnym schemacie XCode:

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

Opcja Xcode GPU Frame Capture na stronie Ogólnego urządzenia z iOS

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

Począwszy od iPhone'a X, telefony iPhone mają zaokrąglone rogi, wycięcie u góry w obudowie czujnika oraz wskaźnik u dołu ekranu, który pozwala wyświetlić ekran główny. W pakiecie SDK na iOS w wersji 11.0 firma Apple dodała interfejs Safe Area API, który umożliwia programistom umieszczanie elementów w obszarze, w którym można bezpiecznie dopasować je do nowego kształtu ekranu.

Pakiet SDK Map Google na iOS zawiera wiele elementów wizualnych i elementów sterujących, takich jak selektor obiektów i link do zgłaszania problemów. W wersji 2.4 te elementy wizualne i elementy sterujące można było dostosować do nowego kształtu ekranu. W trybie poziomym selektor pięter wewnątrz budynków można przyciąć za pomocą wycięcia lub wskaźnika przycisku ekranu głównego.

W pakiecie SDK Map Google na iOS w wersji 2.5 te problemy z układem są usuwane automatycznie. Gdy aplikacja jest używana na iPhonie X lub nowszym, dopełnienie w polach GMSMapView i GMSPanoramaView jest zwiększone, dzięki czemu elementy wizualne nie są przycinane.

Domyślnie zawsze będziemy uwzględniać dopełnienie. Pakiet SDK Map Google na iOS zakłada, że dopełnienie ma być wypełniane z bezpiecznego obszaru. Jeśli projektujesz interfejs z założeniem, że wszystko znajduje się w bezpiecznym obszarze, będzie to działać bez dodatkowych działań.

Jeśli zaprojektowaliśmy interfejs, który nie współpracuje z naszą domyślną korektą, wprowadziliśmy w GMSMapView nową właściwość o nazwie fillAdjustBehavior. W GMSMapView możesz teraz wybrać jedno z 3 sposobów dostosowania dopełnienia: „Zawsze” (domyślnie), „Automatycznie” lub „Nigdy”.

Jeśli obiekt GMSMapView korzysta z dopełnienia „Zawsze”, dopełnienia zawsze dodaje wcięcia bezpiecznego obszaru. Pozwala to zaprojektować interfejs z założeniem, że wszystkie miejsca docelowe znajdują się od krawędzi bezpiecznego obszaru. jest to wartość domyślna

Jeśli obiekt GMSMapView korzysta z dopełnienia „Automatyczny”, wybiera on większe dopełnienie lub wcięcie bezpiecznego obszaru. Dzięki temu możesz dodać dopełnienie od krawędzi ekranu, jednocześnie zapewniając, że wszystkie elementy pozostają w bezpiecznym obszarze.

Jeśli obiekt GMSMapView ma ustawione zachowanie dopełnienia „Nigdy”, nie dodaje do dopełnienia bezpiecznych obszarów. Dzieje się tak przed wprowadzeniem wersji 2.5 i przydaje się, gdy dopełnienie uwzględnia już bezpieczny obszar lub gdy inne rozwiązania nie sprawdzają się w Twoim interfejsie. Twoim obowiązkiem jest dopilnowanie, by logo Google i informacje o prawach autorskich były zawsze widoczne, zgodnie z Warunkami korzystania z Google Maps Platform.

W przeciwieństwie do tego GMSPanoramaView nie ma opcjonalnej właściwości dopełnienia. Oznacza to, że nie ma żadnego dopełnienia, które można by dostosować, a GMSPanoramaView zawsze będzie stosować wymagane dopełnienie, by wszystkie elementy wizualne znajdowały się w bezpiecznym obszarze.

Google Maps SDK na Androida

Jak naprawić 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 Miejsc na Androida dla Usług 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 wyświetla tylko puste szare kafelki zamiast mapy. Jak rozwiązać ten problem?

Częstym powodem wyświetlania się pustych szarych kafelków zamiast mapy są problemy z uwierzytelnianiem. Aby rozwiązać te problemy, wykonaj podane niżej czynności za pomocą narzędzia adb logcat.

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

W pliku manifestu odwołuje się nieprawidłowy lub niezamierzony klucz 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 SHA1 jest dodany do ograniczeń klucza interfejsu API.
Plik build.gradle nie zawiera zależności od usługi Google Play.

Podpisywanie URL

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

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

Dlaczego otrzymuję odpowiedź HTTP 403 „Dostęp zabroniony” na żądania do usługi sieciowej interfejsu API Map Google?

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

Określono podpis, ale jest on nieprawidłowy w przypadku tego żądania.
Żądanie określa klucz interfejsu API w ramach abonamentu Premium na Google Maps Platform, ale nie określa podpisu, a wywoływana usługa wymaga, aby żądania wysyłane za pomocą klucza interfejsu API zawierały prawidłowy podpis.
Podpis został określony, ale nie podano powiązanego klucza interfejsu API wersji Google Maps Platform Premium.