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

Switch to English

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 stronach 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 z ich kombinacji:

Mapy:

Trasy:

Miejsca:

Środowisko:

Jak zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki z Google Maps Platform.

Który interfejs API jest potrzebny?

Aby uzyskać pomoc w znalezieniu odpowiedniego interfejsu API na podstawie swoich wymagań funkcjonalnych, zapoznaj się z selektorem interfejsów API.

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

Informacje o konkretnym interfejsie API lub pakiecie SDK, które Cię interesują, znajdziesz w przeglądzie, instrukcjach dla programistów i przewodnikach dla początkujących. Na przykład przeczytaj przewodniki dotyczące pakietu SDK Map Google na Androida lub interfejsu 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. Najnowsze informacje o zasięgu w Mapach Google znajdziesz w informacjach o zasięgu w Mapach Google. Dane możesz filtrować za pomocą pola filtra 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 których krajach są dostępne wskazówki dojazdu transportem publicznym?

Czy mogę umieścić Mapy Google w swojej witrynie bez używania usług Google Maps Platform?

Tak. W Mapach Google możesz teraz umieszczać wyświetlaną mapę na swojej stronie lub blogu bez konieczności programowania i korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.

Jak udostępniać 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 Maps SDK na iOS.

Interfejs Map JavaScript API opracowano z myślą o urządzeniach mobilnych i jest odpowiedni dla przeglądarek przeznaczonych zarówno na komputery, jak i na urządzenia z przeglądarkami z pełną implementacją JavaScriptu, np. 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:

Na komputerze

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

Android

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

iOS

Mobile Safari w aktualnej i poprzedniej głównej wersji iOS.
UIWebView i WKWebView w bieżącej i poprzedniej głównej wersji iOS.
Aktualna wersja Chrome na iOS.

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

Drukowanie za pomocą interfejsu Maps JavaScript API nie jest obsługiwane. Dzieje się tak, ponieważ obsługa drukowania jest niespójna w najczęściej używanych przeglądarkach.

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

Zasubskrybuj bloga Google Maps Platform, aby być na bieżąco z wiadomościami dotyczącymi różnych usług Google Geo dla deweloperów.

Jak skontaktować się z pomocą techniczną?

Więcej informacji o dostępnych opcjach pomocy znajdziesz na stronie pomocy i zasobów Google Maps Platform.

Kiedy dostępna jest pomoc techniczna?

Zespół pomocy jest dostępny przez całą dobę, 5 dni w tygodniu (od poniedziałku do piątku w godzinach 9:00–17:00 czasu pacyficznego w Tokio) 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ć przywrócić dostęp do konta, pobierają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 o dodanie Cię jako właściciela projektu lub edytującego projekt.
- Jeśli Twój projekt należy do organizacji: skontaktuj się z administratorami organizacji i poproś 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 możliwości odzyskania 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 do projektu Twojego nowego konta Google.

Czy mogę używać pakietu SDK Map Google i Miejsc na iOS na komputerach Mac z architekturą Arm?

Opracowanie aplikacji na nowych Macach z architekturą Arm jest możliwe, ale wymaga utworzenia i działania na fizycznym urządzeniu z iOS. Jest to ograniczenie tymczasowe, ponieważ pracujemy nad dodaniem obsługi tworzenia symulatorów.

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 spełnia Warunki korzystania z usługi Google Maps Platform?

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

Nie chcemy jednak oglądać niektórych przypadków użycia Google Maps Platform. Są to mapy wskazujące na przykład miejsca, w których można kupić narkotyki w mieście, lub inne nielegalne działania. Szanujemy też prywatność użytkowników, dlatego Google Maps Platform nie należy używać do identyfikowania prywatnych informacji o poszczególnych osobach.

Przed opracowaniem i uruchomieniem aplikacji upewnij się, że 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?

Użytkownik nie może uzyskiwać dostępu do fragmentów map ani zdjęć satelitarnych w żaden inny sposób poza Google Maps Platform (takim jak tworzenie własnego interfejsu API do mapowania lub użycie skryptu zbiorczego pobierania fragmentów). Dostęp Twojej aplikacji do kafelków będzie zablokowany, jeśli będzie ona miała do nich dostęp 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 w czasie rzeczywistym (monitorowaniu) w usługach Google Maps Platform, o ile aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Czy mogę korzystać z Map Google w aplikacji innej niż internetowa?

Tak. Z usług Google Maps Platform można teraz korzystać w aplikacjach innych niż internetowe, o ile przestrzegają one innych ograniczeń wynikających z Warunków korzystania z usługi Google Maps Platform.

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

Czy z usług Google Maps Platform mogę korzystać 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ę zawierającą w dokumencie dane z Google Maps Platform?

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

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

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

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

Czy mogę wygenerować obraz mapy za pomocą interfejsu Maps Static API, który jest przechowywany i wyświetlany 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 wyświetlały się bezpośrednio użytkownikom przez Google.

Limity wykorzystania i płatności

Jak skonfigurować płatności w projekcie?

Zobacz Pierwsze kroki z Google Maps Platform.

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

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

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

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

W przypadku macierzy odległości limit jest określany w zdarzeniach na sekundę, obliczany jako suma zapytań po stronie klienta i po stronie serwera.

W przypadku Trasy:Compute Route matrix 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 limity wykorzystania poszczególnych interfejsów API.

API	Limit wykorzystania
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 kafelków mapy: kafelki 2D i kafelki Street View	6000 QPM i 15 000 QPD
Interfejs API kafelków mapy: fotorealistyczne kafelki 3D	300 QPD
Interfejs API kafelków mapy: 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 dla wszystkich żądań wysyłanych do dowolnego 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 opłatach za interfejsy API Google Maps Platform znajdziesz w opisie rozliczeń za Mapy, trasy, miejsca i środowisko.

Jak są liczone wczytania map w Google Maps Platform?

Opłata zostanie naliczona za pojedyncze wczytanie mapy, jeśli:

Strona internetowa lub aplikacja wyświetla mapę za pomocą interfejsu Maps JavaScript API.
Aplikacja żąda pojedynczego obrazu mapy z interfejsu Maps Static API.

Opłaty za panoramy Street View są naliczane oddzielnie od załadowań mapy:

Za każde żądanie do interfejsu Street View Static API, by umieścić statyczną (nieinteraktywną) panoramę Street View obciążamy statyczną panoramę Street View.
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.

Gdy strona internetowa lub aplikacja wczytuje mapę, statyczny obraz mapy lub panoramę Street View, wszelkie działania użytkownika, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie powodują dodatkowych operacji wczytywania mapy ani nie wpływają na limity wykorzystania.

Dodanie znacznika nie spowoduje dodatkowych operacji wczytywania mapy, ale może spowodować naliczenie opłat związanych z ustaleniem lokalizacji pinezki (np. wczytaniem lub ponownym załadowaniem klasy „google.maps.Map()”).

Jak monitorować wykorzystanie?

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

Wybierz projekt zawierający interfejs API, który chcesz sprawdzić.
Na liście interfejsów API w panelu kliknij nazwę interfejsu API.
U góry strony kliknij 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 za 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 sekcjach Raportowanie w Google Maps Platform oraz Monitorowanie wykorzystania interfejsu API i Ograniczanie 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 przekraczasz limity, dostęp do interfejsu API może zostać tymczasowo zablokowany.

Jeśli przekroczysz limity zapytań żądań lub będziesz w inny sposób nadużywać 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 internetowych mają odpowiadające im usługi po stronie klienta dostępne w interfejsie Maps JavaScript API: Directions, Distance 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 dostarczać normalne odpowiedzi i przechodzi w tryb zwracania tylko kodu stanu OVER_QUERY_LIMIT do momentu, gdy ponowne wykorzystanie będzie dozwolone. Może się to zdarzyć w ciągu kilku sekund, jeśli komunikat o błędzie został wyświetlony z powodu wysyłania przez aplikację zbyt wielu żądań na sekundę.

Jeśli regularnie przekraczasz limity wykorzystania zapytań na sekundę, rozważ zmniejszenie wykorzystania przez optymalizację aplikacji w taki sposób, aby efektywniej korzystać z usług Google Maps Platform. Więcej informacji znajdziesz w przewodniku po optymalizacji.

Na mojej stronie jest duży ruch. Czy mogę korzystać z usług Google Maps Platform?

Tak. Zalecamy jednak zapoznanie się z limitami wykorzystania każdej z usług Google Maps Platform, z których korzysta Twoja aplikacja.

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

Jeśli po założeniu konta rozliczeniowego przekroczysz limit bezpłatnego wykorzystania w wysokości 200 USD miesięcznie, a na koncie rozliczeniowym nie będzie ważna forma 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 wycenione w cenniku. Pod koniec każdego miesiąca łączne 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 obciążenie mapami do 200 USD miesięcznie, wykorzystanie nie będzie obciążane. Opłaty za wykorzystanie powyżej kwoty 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?

W konsoli mogą być dostępne dodatkowe waluty. Gdy wybierzesz inną walutę, stawki zostaną przeliczone z ich odpowiednika w USD podanego w arkuszu opłat.

Skonfigurowałem(-am) płatności. Jak wyświetlić rachunek?

Na początku każdego miesiąca Google obciąża Cię opłatami za aktywność z poprzedniego miesiąca przy użyciu określonej formy płatności. Szczegółowe informacje o rachunku znajdziesz w przewodniku po płatnościach 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 konfigurować alerty rozliczeniowe i 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 naliczanych. Możesz określić maksymalny dzienny limit wykorzystania, aby zapobiec nieoczekiwanym wzrostom. 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.
Jeśli pojawi się taka prośba, wybierz projekt.
Wybierz interfejs API z listy i kliknij kartę Limity.
Kliknij ikonę edycji obok limitu żądań dziennie.

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

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

Skonfiguruj alerty budżetowe, aby wysyłać do administratorów płatności e-maile z powiadomieniami, gdy obciążenia na koncie rozliczeniowym osiągną wyznaczony próg. Administratorzy rozliczeń otrzymają e-maile z powiadomieniami, gdy szacunkowe obciążenia na koncie rozliczeniowym przekroczą 50%, 90% lub 100% progu.

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

Konto przeniesione z Google Maps Platform zostało utworzone po to, aby ułatwić niektórym klientom przejście na nowy abonament z płatnościami według wykorzystania. To przeniesienie pozwoliło Google przyznać tym klientom jednorazowe środki, aby mogli nadal korzystać z Google Maps Platform do osiągnięcia limitu bezpłatnego poziomu o wartości 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 bezpłatnego poziomu 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 utworzysz konta rozliczeniowego i nie dołączysz do projektu konta rozliczeniowego, liczba Twoich interfejsów API Maps Platform będzie ograniczona do 1 żądania dziennie. Możesz uzyskać większy limit, tworząc i dołączając konto rozliczeniowe. Aby to zrobić, zobacz Pierwsze kroki z Google Maps Platform.

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

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 usługi Google Maps Platform. Zgodnie z tymi warunkami tworzenie wielu kont rozliczeniowych jest zabronione. Więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania dotyczące naruszeń na koncie rozliczeniowym.

Korzystanie z Google Maps Platform

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

Za każdym razem, gdy korzystasz z usług Google Maps Platform, musisz uwzględniać klucz interfejsu API, aby zweryfikować żądanie. Usługa Google Maps Platform jest dostępna dla aplikacji na Androida, iOS, aplikacji internetowych i usług 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 adresu URL udostępnionego przez Google. Podpisy cyfrowe są używane w interfejsach 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 w artykule o sprawdzonych metodach zabezpieczania interfejsów API.
Do klucza interfejsu API możesz dodać ograniczenie aplikacji. Po wprowadzeniu ograniczeń klucz będzie działać tylko na platformach, które obsługują tego typu ograniczenia. Dostępne są 4 typy ograniczeń aplikacji. Interfejsy API wymuszające ten sam typ ograniczenia mogą używać tego samego klucza z ograniczeniami.
- Adresy IP (pojedyncze serwery) do użytku z interfejsami API usług internetowych.
- Strony odsyłające HTTP (witryny internetowe) – do użycia z internetowymi interfejsami API.
- Ograniczenie aplikacji na Androida (według nazwy pakietu i odcisku cyfrowego) – 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 interfejsu API. Więcej informacji znajdziesz w artykule o pobieraniu, dodawanie i ograniczaniu klucza interfejsu API.

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

API/SDK	Ograniczenie dotyczące danych logowania i aplikacji
Pakiet SDK Map Google na Androida	Klucz interfejsu API z ograniczeniem dla Androida¹
Pakiet SDK Miejsc na Androida	Klucz interfejsu API z ograniczeniem dla Androida¹
Pakiet SDK Maps na iOS	Klucz interfejsu API z ograniczeniem iOS¹
Pakiet SDK Miejsc na iOS	Klucz interfejsu API z ograniczeniem iOS¹
Interfejs 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¹
Map Static API	Klucz interfejsu API z ograniczeniem odsyłającym HTTP¹ + podpis cyfrowy²
Street View Static API	Klucz interfejsu API z ograniczeniem odsyłającym HTTP¹ + podpis cyfrowy²
Interfejs Maps Embed API	Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP¹
Address Validation API	Klucz interfejsu API z ograniczeniem adresu IP¹
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¹
Geolocation API	Klucz interfejsu API z ograniczeniem adresu IP¹
Miejsca 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 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 korzystania z Map Static API i Street View Static API może być wymagany podpis cyfrowy. Niezależnie od sposobu uwierzytelniania zdecydowanie zalecamy uwierzytelnianie żądań zarówno z użyciem klucza interfejsu API, jak i podpisu cyfrowego.

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

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

Zanim zmienisz typ ograniczenia klucza interfejsu API z odsyłającego HTTP na adres IP, sprawdź, czy wszystkie interfejsy API korzystające z klucza interfejsu API obsługują typ ograniczenia adresu IP. Interfejsy API z tym samym typem ograniczenia 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:

Otwórz stronę Dane logowania w konsoli Google Cloud.
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 mogę 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:

Za pomocą narzędzia do śledzenia problemów Google Maps Platform możesz też sprawdzić, w której wersji Google Maps Platform wystąpił dany błąd i został on naprawiony:

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

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

Wystarczy, że podczas wczytywania interfejsu API określisz parametr wywołania zwrotnego. Więcej informacji i przykładowy kod znajdziesz w rozdziale 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 spróbuje 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 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
godz.	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
hej	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)?

Dostęp do interfejsów Maps JavaScript API, Maps Static API i interfejsów API usługi internetowej można uzyskać przez bezpieczne połączenia (HTTPS). Informacje o tym, jak uzyskać do niego dostęp przez SSL, znajdziesz w dokumentacji interfejsu API.

Pamiętaj, że Maps Static API nie obsługuje adresów URL niestandardowych ikon, 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 zachowanie, które Twoim zdaniem może być wynikiem błędu, zgłoś je na odpowiednim forum. Dzięki temu inni deweloperzy będą mogli zweryfikować błąd i wyeliminować potencjalne problemy z kodem.

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

Po potwierdzeniu, że wykryliśmy 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 błąd lub prośbę o dodanie funkcji, sprawdź, czy dany błąd lub funkcja nie zostały jeszcze dodane. Jeśli tak, możesz oznaczyć problem gwiazdką, aby zarejestrować się i otrzymywać powiadomienia o aktualizacjach.

W jaki sposób interfejsy API Google Maps Platform używają plików cookie witryny?

Pakiet Maps SDK na Androida i Maps SDK na iOS używa plików cookie zgodnie z Polityką prywatności Google, np. obliczaniem liczby aktywnych użytkowników w ciągu doby i ostatnich 7 dni oraz zapobieganiem nadużyciom w zakresie usług. Te pliki cookie nie są powiązane z żadnym kontem Google, na które się zalogowano, ani rejestrowane wraz z pozostałymi informacjami zebranymi z wywołań interfejsu API.

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

Zespół Google ds. relacji z deweloperami jest obecny na stronie Stack Overflow – edytowanej we współpracy witryny z pytaniami i odpowiedziami dla programistów. To także świetne miejsce na pytania techniczne dotyczące tworzenia i obsługi aplikacji Map Google. Więcej informacji o zadawaniem pytań na Stack Overflow znajdziesz na stronie pomocy.

Pamiętaj o tych kwestiach:

Przeszukaj bieżące dyskusje. Możliwe, że ktoś inny miał podobny problem i znajdował rozwiązanie.
Jeśli to możliwe, prześlij link do swojej witryny. Kody należy publikować tylko wtedy, gdy nie można ich łatwo wyświetlić online.
Podaj wszystkie istotne informacje, w tym wersje przeglądarki, błędy i wszystkie 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, wyjaśnienia dotyczące kodów błędów znajdziesz tutaj:

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

W niektórych przypadkach może się wyświetlać zaciemniona mapa lub „negatywne” zdjęcie Street View ze znakiem wodnym 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. Oto instrukcje, które pomogą Ci rozwiązać ten problem:

Czy używasz klucza interfejsu API?

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

Klucz interfejsu API jest przekazywany jako parametr key w adresie URL, 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. Pozwala to określić, czy Twoja witryna prawidłowo implementuje interfejsy API Map Google licencjonowane przez 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 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ź ruch sieciowy generowany przez Twoją witrynę w przeglądarce. W Chrome możesz go wyświetlić na karcie Sieć w DevTools. Wyświetlą się żądania sieci nadesłane przez Twoją witrynę. Żądania wykonane za pomocą interfejsu Maps JavaScript API będą miały ścieżkę maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Warto filtrować ruch sieciowy według wartości maps/api/js na karcie Sieć.

Nie, nie używam klucza interfejsu API.

Aby uzyskać klucz interfejsu API, kliknij przycisk poniżej. Jeśli nie widzisz instrukcji konfiguracji, wykonaj pełne instrukcje z artykułu Pierwsze kroki z Google Maps Platform.
Rozpocznij

Tak, używam klucza interfejsu API.

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

Czy z projektem jest połączone konto rozliczeniowe?

Tego nie wiem. Jak mogę 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:

Otwórz sekcję Dane logowania, którą znajdziesz na pasku po lewej stronie w sekcji Google Maps Platform > Dane logowania.
Sprawdź, czy klucz interfejsu API, którego aktualnie używasz w witrynie, jest widoczny na liście. Jeśli nie, przełącz się na inny projekt i sprawdź dane logowania.
Jeśli nie możesz znaleźć projektu powiązanego z Twoim kluczem interfejsu API, być może nie masz już do niego dostępu. Poproś o pomoc inne osoby ze swojej organizacji. Jeśli nie możesz znaleźć pierwotnego projektu:
1. Utwórz nowy projekt. Aby to zrobić, wybierz Nowy projekt z listy 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 zlokalizowaniu projektu w Cloud Console otwórz sekcję Płatności w menu po lewej stronie i sprawdź, czy jest połączone konto rozliczeniowe.

Nie, z moim projektem 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 Pierwsze kroki 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 (na przykład karta kredytowa straciła ważność)?

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

Czy został przekroczony limit dzienny interfejsu API?

Jeśli masz ustawiony dzienny limit dowolnych interfejsów API, co często pozwala uniknąć nieoczekiwanych wzrostów liczby konwersji, zwiększając dzienny limit.

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

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

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

Kluczy interfejsu API z ograniczeniem dotyczącym adresów IP można używać tylko w usługach internetowych, które są przeznaczone do użytku 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 (przykład: Usługa geokodowania). Aby korzystać z usług interfejsu Maps JavaScript API po stronie klienta, musisz utworzyć oddzielny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia stron odsyłających HTTP (zobacz Pobieranie, dodawanie i ograniczanie klucza interfejsu API).

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

Te kody błędów mogą zostać zwrócone 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 ustawiony samodzielnie limit wykorzystania.
Podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność).
Przekroczono limit 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ć limit dzienny (jeśli dotyczy).

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

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

Jak naprawić błąd „Ten adres IP, ta 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 masz włączone ograniczenia dotyczące adresów IP (serwerów), a nieautoryzowany adres IP próbuje wysłać żądanie.
W kluczu interfejsu API masz włączone ograniczenia dotyczące stron odsyłających HTTP (witryny), a nieupoważniona strona odsyłająca próbuje wykonać żądanie.
Ograniczasz dostęp do swoich aplikacji na Androida, ustawiając nazwę pakietu i odcisk palca, a nieupoważniona aplikacja na Androida próbuje wysłać żądanie.
Ograniczasz żądania wysyłane przez aplikacje na iOS, podając identyfikatory pakietów i używając nierozpoznanej aplikacji na iOS wysyłającej żądanie.
Wcześniej ten błąd mógł się pojawiać, jeśli używany był którykolwiek z interfejsów API usługi internetowej z kluczem interfejsu API z ograniczeniami dotyczącymi stron odsyłających HTTP. Żądania wysyłane do tych interfejsów API powinny być identyfikowane za pomocą klucza interfejsu API z ograniczeniami dotyczącymi adresu IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP. Więcej informacji o ograniczaniu kluczy interfejsu API znajdziesz w opisie sprawdzonych metod dotyczących kluczy interfejsu API.

Wyświetlanie i edytowanie danych logowania klucza interfejsu API

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

Otwórz stronę Dane logowania w konsoli Google 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 nazwę klucza.
Wyświetlą się pełne dane logowania wybranego klucza interfejsu API, w tym wszystkie ograniczenia skonfigurowane dla tego klucza. W tym miejscu 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 dowolnych interfejsów API usługi internetowej z kluczem interfejsu API ograniczonym do strony odsyłającej HTTP. Ze względów bezpieczeństwa interfejsy API usług internetowych muszą używać kluczy API ograniczonych do adresów IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP lub utwórz nowy klucz interfejsu API, jeśli Twój klucz jest już używany 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, który udostępnia interfejs REST umożliwiający odpowiadanie w formatach JSON i XML.

W jakich krajach działa geokodowanie?

Listę krajów obecnie obsługiwanych przez geokodery Google Maps Platform znajdziesz w danych o zasięgu w Mapach Google.

Dokładność geokodowanych lokalizacji może się różnić w zależności od kraju, dlatego zalecamy skorzystanie z zwróconego pola location_type, aby sprawdzić, czy znaleziono wystarczająco dobre dopasowanie na potrzeby Twojej aplikacji. Pamiętaj, że dostępność danych geokodowania zależy od umów z dostawcami danych, więc może ulec zmianie.

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

Geokoder interfejsu API i geokoder Map Google czasami korzystają z różnych zbiorów danych (w zależności od kraju). Geokoder interfejsu API jest co jakiś czas aktualizowany o nowe dane, więc z czasem wyniki mogą się zmieniać lub poprawiać.

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

Geokoder służy do mapowania adresów z ulic na współrzędne geograficzne. Z tego względu, aby zmaksymalizować prawdopodobieństwo pomyślnego zapytania, zalecamy formatowanie żądań geokodera zgodnie z tymi wytycznymi:

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 budynków, numery pięter czy numery lokali, które nie znajdują się w adresie określonym przez urząd pocztowy w danym kraju. Może to spowodować otrzymanie odpowiedzi z atrybutem ZERO_RESULTS.
Sformatuj kody plus w ten sposób (znaki plusa zawierają zmianę znaczenia w adresie URL %2B, a spacje – do %20):
- Kod globalny to 4-znakowy numer kierunkowy i co najmniej 6-znakowy kod lokalny (849VCWC8+R9 to 849VCWC8%2BR9).
- kod złożony 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 numeru budynku, a nie jego nazwy.
W miarę możliwości stosuj adresowanie numeru domu, a nie przecznice.
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 określenia adresów dróg numerowanych w Stanach Zjednoczonych w następujących 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"
Międzystanowe w Stanach Zjednoczonych: "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 HTTP Geocoding Service?

Zapoznaj się z dokumentem Geocoding Strategies (Strategie geokodowania), w którym szczegółowo opisujemy zalety i wady różnych strategii geokodowania.

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

Usługa Compute Routes dla Routes API oraz Directions API umożliwiają podawanie wskazówek dojazdu w przypadku podróży jednoetapowych i wieloetapowych. Opcje wyznaczania trasy pomagają w wyznaczaniu wskazówek dojazdu z użyciem trybu podróży (samochodu), pojedynczej trasy lub zestawu tras oraz ograniczeń (bez dróg płatnych). Usługi te są dostępne w tych formach:

Interfejs żądań/odpowiedzi HTTP (używany w aplikacjach mobilnych i innych) jest zgodny z pakietem SDK Map Google na Androida i innymi usługami internetowymi Map Google.
JavaScript API (na potrzeby aplikacji po stronie klienta) umożliwia podawanie wskazówek dojazdu za pomocą klasy google.maps.DirectionsService. Klasa DirectionsRenderer może automatycznie utworzyć za Ciebie nakładki i panel wskazówek dojazdu. 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 artykule o bibliotekach klienta interfejsu Directions API.

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

Aby zobaczyć kraje, w których obecnie dostępne są wskazówki dojazdu w Google Maps Platform, zapoznaj się z danymi 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 są dostępne wskazówki dojazdu transportem publicznym?

Interfejs Directions API i Distance Matrix API obsługują wszystkich partnerów Transportu publicznego Google, 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?

Limity 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 hostowanej przez Google usługi do pobierania i analizowania plików KML na potrzeby renderowania. Nie można więc wyświetlać plików KML, które nie są hostowane pod adresem URL dostępnym publicznie lub wymagające uwierzytelnienia.

Jeśli chcesz tworzyć 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 interfejs Maps Static API. Gdy używasz ikon niestandardowych, możesz określić do 5 unikalnych ikon na żądanie, ale każdej z nich możesz używać wiele razy w mapie.

Adresy URL statycznego interfejsu API Map Google 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ć z uwzględnieniem 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 wpływa na dokładność na Ziemi, znajdziesz w artykule w Wikipedii o stopniach dziesiętnych.

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 na mapie bazowej Google?

Prześlij opinię w Mapach Google, jeśli brakuje 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 jedno- 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 żądanie prawne.

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

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

Niektóre funkcje po stronie klienta służą do zgłaszania powodzenia 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, które rejestrują informacje o docelowym poziomie usług. Te informacje obejmują stan powodzenia, czas oczekiwania i wersję/kanał interfejsu Maps JavaScript API. Aby zwiększyć wydajność, wywołania mogą być grupowane. Aby mieć pewność, że te połączenia nie są blokowane na poziomie przeglądarki, może być konieczne pozwolenie 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ć interfejs Maps JavaScript API po 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 używasz wycofanej wersji pakietu Miejsca SDK na iOS. Pakiet SDK Miejsc 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.

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

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

W XCode wybierz Produkt, Schemat, 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 X iPhone'y mają kształt ekranu z zaokrąglonymi rogami, wycięciem u góry obudowy czujnika oraz u dołu ekranu wskaźnik umożliwiający dostęp do ekranu głównego. W pakiecie SDK iOS 11.0 firma Apple dodała interfejs Safe Area API, dzięki któremu deweloperzy mogą umieszczać elementy w obszarze, od którego 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 można teraz przyciąć. W trybie poziomym selektor podłóg wewnętrznych może być przycięty przez wcięcie lub wskaźnik przycisku ekranu głównego.

W wersji 2.5 pakietu SDK Map Google na iOS te problemy z układem są automatycznie naprawiane. 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. Pakiet SDK Map Google na iOS zakłada, że dopełnienie ma na celu wypełnienie bezpiecznego obszaru. Jeśli projektujesz interfejs z założeniem, że wszystkie elementy znajdują się w bezpiecznym obszarze, nie trzeba będzie robić nic więcej.

Jeśli masz interfejs, który nie działa z naszym dostosowaniem domyślnym, wprowadziliśmy w widoku GMSMapView nową właściwość o nazwie paddingAdjustBehavior. Widok GMSMapView umożliwia teraz wybór jednego z trzech typów dostosowań dopełnienia: „Zawsze” (domyślnie), „Automatycznie” i „Nigdy”.

Jeśli widok GMSMapView jest skonfigurowany tak, aby używać dopełnienia „Zawsze”, zawsze dodaje do dopełnienia bezpiecznego obszaru. Pozwala to zaprojektować interfejs z założeniem, że wszystkie miejsca docelowe będą znajdowały się od krawędzi bezpiecznego obszaru. jest to wartość domyślna

Jeśli widok GMSMapView jest skonfigurowany pod kątem używania automatycznego dopełnienia, zawsze wybiera większe dopełnienie lub wstawienie bezpiecznego obszaru. W ten sposób możesz dodać dopełnienie od krawędzi ekranu, a jednocześnie mieć pewność, że wszystkie elementy pozostaną w bezpiecznym obszarze.

Jeśli widok GMSMapView jest skonfigurowany tak, aby używać dopełnienia „Never” (Nigdy), nigdy nie dodaje do dopełnienia 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 Twoim interfejsem. Twoim obowiązkiem jest dopilnowanie, aby logo Google i informacje o prawach autorskich były zawsze widoczne, zgodnie z Warunkami korzystania z usługi Google Maps Platform.

Natomiast GMSPanoramaView nie ma opcjonalnej właściwości dopełnienia. Oznacza to, że nie można dostosować dopełnienia, a GMSPanoramaView zawsze stosuje potrzebne dopełnienie, aby wszystkie elementy wizualne znajdowały 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 Miejsca SDK na Androida. Wersja pakietu Miejsc SDK 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 są puste, szare kafelki, są problemy z uwierzytelnianiem. Aby rozwiązać te problemy, wykonaj czynności opisane poniżej za pomocą narzędzia adb logcat.

Upewnij się, że masz zainstalowane narzędzie adb. Jeśli nie, postępuj zgodnie z instrukcjami z tego przewodnika.
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ę Sklep Play.
W terminalu Android Studio uruchom adb logcat -e "Google Maps Android API". Spowoduje to wydrukowanie tylko tych wierszy, w których komunikat logu pasuje do „Google Maps Android API” (opcjonalnie możesz wyeksportować dziennik do pliku tekstowego, dołączając: > logcat.txt).
Odtwórz błąd na urządzeniu i sprawdź, czy nie występują typowe błędy, takie jak:

W pliku manifestu znajduje się odwołanie do nieprawidłowego lub niezamierzonego klucza interfejsu API.
W projekcie nie włączono 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ług Google Play.

Podpisywanie URL

Czy można podpisywać adresy URL za pomocą języka JavaScript?

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 na moje żądania usługi internetowej interfejsu API Map Google otrzymujesz odpowiedź HTTP 403 „Forbidden”?

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

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