Najczęstsze pytania dotyczące Google Maps Platform

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Pierwsze kroki

Omówienie warunków korzystania z usługi

Limity i opłaty za wykorzystanie

Korzystanie z Google Maps Platform

Błędy i rozwiązywanie problemów

Usługi Google Maps Platform

Maps JavaScript API

Google Maps SDK na iOS

Google Maps SDK na Androida

Podpisywanie URL

Pierwsze kroki

Co to 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 i witrynach mobilnych lub pobieranie danych z Map Google. Do wyboru jest kilka opcji. W zależności od potrzeb możesz zauważyć użycie jednego lub kilku interfejsów API i pakietów SDK:

Mapy:

Trasy:

Miejsca:

Jak zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki z Google Maps Platform.

Który interfejs API jest mi potrzebny?

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

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

Informacje o interesujących Cię interfejsach API lub pakietach SDK znajdziesz w przewodnikach Przegląd, Deweloper i Pierwsze kroki. Zapoznaj się z przewodnikami dotyczącymi SDK do Map na Androida lub interfejsu Maps JavaScript API.

Jakie kraje obejmuje Google Maps Platform?

Zespół Map Google stale przekazuje nowe dane map, aby zwiększyć zasięg na rynku międzynarodowym. Najnowsze informacje na temat pokrycia znajdziesz w danych o zasięgu Map Google. Dane możesz filtrować za pomocą pola filtra u góry strony. Dane dotyczące zasięgu mogą się zmieniać w przypadku zmiany umów licencyjnych z dostawcami danych.

Zobacz też:

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

Tak. Mapy Google umożliwiają teraz umieszczanie wyświetlanej mapy w Twojej witrynie lub na blogu bez konieczności programowania i korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.

Jak dostarczać aplikacje Map Google na urządzenia mobilne?

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

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

Interfejs API JavaScript Map Google został zaprojektowany z myślą o urządzeniach mobilnych i jest odpowiedni dla aplikacji do przeglądarek, które są przeznaczone zarówno na komputery, jak i na urządzenia wyposażone w przeglądarkę z pełną obsługą JavaScriptu, np. Apple iPhone.

W przypadku aplikacji kierowanych na urządzenia nieodpowiednie do korzystania z interfejsu Maps JavaScript API interfejs Maps Static API wyświetla obrazy map w formacie GIF, JPG i PNG, w tym ze znacznikami i liniami. Pamiętaj, że używanie interfejsu Maps Static API poza aplikacjami opartymi na przeglądarce wymaga połączenia obrazu mapy z Mapami Google.

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

Interfejs Maps JavaScript API i Maps Umieść API obsługują te przeglądarki:

Komputer
  • Bieżąca wersja przeglądarki Microsoft Edge (Windows)
  • bieżąca i poprzednia wersja przeglądarki Firefox (Windows, macOS, Linux).
  • Obecna i poprzednia wersja Chrome (Windows, macOS, Linux)
  • Aktualna i poprzednia wersja Safari (macOS)

Aby zwolnić zasoby potrzebne do obsługi funkcji wymaganych przez klientów dostępnych w nowoczesnych przeglądarkach, kończymy obsługę Internet Explorera 11. W 2021 r. firma Microsoft zakończyła obsługę przeglądarki IE11 i zachęciła ją do przejścia na przeglądarkę Microsoft Edge.

Od sierpnia 2021 r. użytkownikom przeglądarki Internet Explorer 11 będzie wyświetlać się ostrzeżenie. Ostatnia wersja interfejsu Maps JavaScript API obsługująca Internet Explorera w wersji 11 to 3.47. Obsługa przeglądarki Internet Explorer 11 zostanie całkowicie wyłączona w listopadzie 2022 r. Dotyczy to również trybu przeglądarki Internet Explorer w przeglądarce Edge.

Na urządzeniu z Androidem
  • Obecna wersja Chrome na Androida 4.1 lub nowszego.
  • Chrome WebView w Androidzie 4.4 lub nowszym.
iOS
  • Safari na iOS w bieżącej i poprzedniej głównej wersji iOS.
  • UIWebView i WKWebView w obecnej i poprzedniej głównej wersji iOS.
  • Obecna wersja Chrome na iOS.
Czy mogę drukować mapy za pomocą interfejsu Maps JavaScript API?

Drukowanie z interfejsu Maps JavaScript API nie jest obsługiwane. Wynika to z tego, że obsługa drukowania jest niespójna we wszystkich popularnych przeglądarkach.

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

Zasubskrybuj bloga o Mapach Google, aby otrzymywać najświeższe informacje dotyczące różnych ofert dla deweloperów w Google Geo.

Jak skontaktować się z pomocą techniczną?

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

Kiedy dostępna jest pomoc techniczna?
Zespół pomocy jest dostępny przez całą dobę, od poniedziałku do piątku w godzinach 9:00–17:00 czasu pacyficznego, z wyjątkiem regionów niedostępnych dla usługi.
Jak mogę odzyskać dostęp do konta Google?

Jeśli utracisz dostęp do konta Google (np. jan@mojafirma.com lub jan@gmail.com), możesz spróbować odzyskać dostęp, pobierając lub resetując hasło. Przeczytaj artykuł Jak odzyskać konto Google lub Gmail w Centrum pomocy konta Google.

Jak mogę odzyskać dostęp do określonego projektu?

Jeśli nie masz już dostępu do projektu, w którym zarządzasz wdrożeniem Google Maps Platform, możesz spróbować go odzyskać.

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

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

Czy mogę korzystać z pakietu SDK Map i Miejsc Google na iOS na komputerach Mac z systemem operacyjnym?

Programowanie na nowych Macach opartych na ramieniu jest możliwe, ale wymaga tworzenia i uruchamiania na fizycznym urządzeniu z iOS. To jest tymczasowe ograniczenie. Pracujemy nad dodaniem odpowiedniej obsługi do programowania w symulatorach.

Omówienie warunków korzystania z usługi

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

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

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

Czy moja witryna spełnia Warunki korzystania z usługi Google Maps Platform?

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

Istnieją jednak przypadki, których nie chcemy oglądać: Szanujemy też prywatność użytkowników, dlatego Google Maps Platform nie powinno być używane do identyfikowania prywatnych informacji o osobach.

Zanim utworzysz i opublikujesz aplikację, upewnij się, że jest ona zgodna z Warunkami korzystania z usługi Google Maps Platform. Inżynierowie Google mogą zaoferować tylko 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 kafelków na mapie i zdjęć satelitarnych?

Nie możesz korzystać z fragmentów mapy ani zdjęć satelitarnych za pomocą żadnego mechanizmu oprócz Google Maps Platform (np. utworzyć własny interfejs API mapowania lub użyć skryptu pobierania zbiorczego). Jeśli Twoja aplikacja będzie miała dostęp poza Google Maps Platform, dostęp do kafelków zostanie zablokowany. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform.

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

Wyświetlanie danych w czasie rzeczywistym w usługach Google Maps Platform (pod warunkiem, że są one zgodne z Warunkami usługi Google Maps Platform) nie jest ograniczone.

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

Tak, usług Google Maps Platform można używać w aplikacjach innych niż internetowe, pod warunkiem że spełniają one inne ograniczenia Warunków korzystania z usługi Google Maps Platform.

Interfejs Maps JavaScript API jest obsługiwany tylko wtedy, gdy działa w jednej z obsługiwanych przeglądarek.

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

Tak, Map Google, tras i miejsc można używać z aplikacjami z dostępem prywatnym. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform.

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

Jeśli aplikacja wygeneruje dokument w wersji elektronicznej lub drukowanej, nie będzie on zawierał danych z Google Maps Platform. Dotyczy to też obrazów. Więcej informacji znajdziesz w Warunkach korzystania z Google Maps Platform: „Brak scrapingu”.

Jak mogę zrezygnować z umieszczania 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ż rezygnować z tej funkcji, ale zalecamy jak najszybsze usunięcie tego parametru.

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

Czy mogę wygenerować obraz mapy za pomocą statycznego interfejsu API Map Google, który przechowuję i udostępniam w witrynie?

Nie możesz przechowywać ani wyświetlać kopii obrazów wygenerowanych przy użyciu interfejsu API statycznego Map Google w swojej witrynie. Wszystkie strony wymagające obrazów statycznych muszą zawierać 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 bezpośrednio w treści HTML strony i wyświetlane bezpośrednio użytkownikom Google.

Limity i opłaty za wykorzystanie

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 Google Cloud Platform Free Tier daje klientom bezpłatny okres próbny w wysokości 300 USD do wykorzystania w dowolnej usłudze Google Cloud Platform (GCP), w tym w interfejsach API Google Maps Platform (GMP). Po zakończeniu bezpłatnego okresu próbnego musisz przejść na płatne konto, aby nadal korzystać z tych usług. Aby przejść na płatne konto, przejdź do Cloud Console.
Czy w Google Maps Platform obowiązują limity wykorzystania?

Nie ma maksymalnej dziennej liczby żądań, które można przesłać do usług Google Maps Platform, a jedyne limity wykorzystania są związane z maksymalną liczbą zapytań na sekundę (QPS). W przypadku tablicy odległości limit jest ustalany w zdarzeniach na sekundę (EPS). Jest to suma zapytań po stronie klienta i serwera. W poniższej tabeli podano limit wykorzystania dla każdego interfejsu API.

Interfejs API Limit wykorzystania
Weryfikacja adresu 6000 QPM
Trasa 50 kl./s
Tablica odległości 1000 PST
Wzniesienie 100 kl./s
Geokodowanie 50 kl./s
Geolokalizacja 100 kl./s
Mapy dynamiczne 500 kl./s
Mapy statyczne 500 kl./s
Street View Image API 500 kl./s
Strefa czasowa 500 kl./s
Miejsca (z wyjątkiem urządzeń mobilnych) 100 kl./s
Drogi 500 kl./s

Aby zarządzać wydatkami, możesz monitorować korzystanie z interfejsów API oraz ustawiać limity dzienne dla wszystkich żądań do dowolnego rozliczanego interfejsu API.

Usługi Google Maps Platform należy wdrażać zgodnie ze standardowymi Warunkami korzystania z usługi Google Maps Platform.

Jak oblicza się koszt wykorzystania?

Ceny obowiązujące w usługach Google Maps Platform znajdziesz w tym arkuszu.

Więcej informacji o opłatach za interfejsy API Google Maps Platform znajdziesz w artykule Rozliczenia za Mapy, Trasy i Miejsca.

Jak liczone są mapy w Google Maps Platform?

Jeśli wystąpi jedna z tych sytuacji:

  • Strona internetowa lub aplikacja wyświetla mapę za pomocą interfejsu Maps JavaScript API.
  • Aplikacja wysyła do Google Maps Static API jeden obraz mapy.

Opłaty za zdjęcia Street View są naliczane niezależnie od wczytania mapy:

  • Za każde żądanie przesłane do interfejsu Street View Static API pobierana jest statyczna panorama Street View, aby umieścić statyczną (nieinteraktywną) panoramę Street View.
  • Dynamiczna panorama Street View jest obciążana za każde wystąpienie obiektu panoramicznego w Maps JavaScript API, Maps SDK na Androida lub Maps SDK na iOS.

Gdy strona internetowa lub aplikacja wczytuje mapę, statyczny obraz mapy lub panoramę Street View, wszelkie interakcje użytkownika z nią, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie generują dodatkowych wczytań mapy ani nie mają wpływu na limity wykorzystania.

Dodanie znacznika nie powoduje wygenerowania dodatkowych wczytań mapy, ale może spowodować naliczenie opłat za sposób określenia lokalizacji pinezki (np. wczytanie lub ponowne załadowanie klasy `google.maps.Map()`).

Jak monitorować wykorzystanie?

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

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

Aby wyświetlić raport na temat ruchu i informacje rozliczeniowe dla całego projektu:

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

Więcej informacji znajdziesz w artykułach na temat raportowania wykorzystania interfejsu Google Maps Platform oraz monitorowania wykorzystania interfejsu API i określania limitów wykorzystania interfejsu API.

Co się stanie, jeśli przekroczym limit żądań (QPS)?

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

Jeśli przekroczysz limity zapytań na sekundę lub wprowadzisz w inny sposób nadużycie do usługi, żądania będą zwracać konkretny komunikat o błędzie. Jeśli nadal będziesz przekraczać limity, możesz utracić dostęp do Google Maps Platform.

Uwaga: 4 interfejsy API usług internetowych mają odpowiedniki po stronie klienta w interfejsie API Map Google JavaScript: Wskazówki dojazdu, Tablica odległości, Wzniesienie i Geokodowanie.

Przekroczono limit wykorzystania

Jeśli przekroczysz limity wykorzystania, otrzymasz odpowiedź w postaci kodu stanu OVER_QUERY_LIMIT.

Oznacza to, że usługa internetowa przestanie wyświetlać normalne odpowiedzi i wróci do kodu stanu „OVER_QUERY_LIMIT” do chwili, gdy Więcej plików nie zostanie ponownie dozwolone. Może się to zdarzyć w ciągu kilku sekund, jeśli błąd został odebrany, ponieważ aplikacja wysyła zbyt wiele żądań na sekundę.

Jeśli regularnie przekraczasz limity wykorzystania zapytań na sekundę, rozważ obniżenie wykorzystania, optymalizując aplikacje pod kątem efektywnego wykorzystania usług Google Maps Platform. Więcej informacji znajdziesz w przewodniku po optymalizacji.

Ruch w mojej witrynie jest duży. Czy mogę używać usług Google Maps Platform?

Tak. Zalecamy jednak zapoznanie się z limitami użytkowania dowolnej platformy Google Maps Platform, z której korzysta Twoja aplikacja.

Jeśli po utworzeniu konta rozliczeniowego przekroczysz bezpłatny limit 200 USD miesięcznie i nie będziesz mieć ważnej formy płatności (karty kredytowej, przelewu bankowego itp.), interfejs API przestanie działać, dopóki nie dodasz prawidłowej formy płatności.

Jak obliczane będą opłaty za wykorzystanie?

Wykorzystanie jest obliczane na koniec każdego dnia i według cen znajdziesz w arkuszu cenowym. Pod koniec każdego miesiąca łączne wykorzystanie zostanie naliczone za pomocą formy płatności powiązanej z Twoim kontem rozliczeniowym. Więcej informacji znajdziesz w artykule dotyczącym płatności za Google Maps Platform.

Ile kosztuje korzystanie z Google Maps Platform?

Informacje o koszcie interfejsu API znajdziesz w cenniku. Jeśli aplikacja generuje żądania lub rejestruje obciążenie mapy na kwotę do 200 USD miesięcznie, opłaty nie są pobierane. Opłaty za wykorzystanie przekraczające miesięczny limit środków w wysokości 200 USD zostaną naliczone na Twoim koncie rozliczeniowym. Więcej informacji znajdziesz w przewodniku po płatnościach w Google Maps Platform.

Czy ceny są dostępne w innych walutach?

W konsoli mogą być dostępne dodatkowe waluty. Jeśli wybierzesz inną walutę, ceny zostaną przeliczone z dolara cenowego w dolarach amerykańskich.

Mam skonfigurowane rozliczenia. Jak wyświetlić rachunek?

Google nalicza opłaty na początku każdego miesiąca za aktywność z poprzedniego miesiąca przy użyciu określonej formy płatności. Szczegółowe informacje o rozliczeniach znajdziesz w naszym przewodniku po rozliczeniach w Google Maps Platform.

Dodatkowe zasoby:

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

Google Maps Platform umożliwia ustawianie dziennych limitów żądań i wyznaczanie maksymalnych dziennych limitów rozliczeniowych. Możesz ograniczyć 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 powiadomieniem, gdy opłaty na koncie rozliczeniowym osiągną wyznaczony próg.

Ograniczenie maksymalnego dziennego limitu obciążeń:

Aby uniknąć dużego rachunku, możesz ustawić dzienny limit wykorzystania, który zapobiegnie niespodziewanym wzrostom wykorzystania. Możesz zmienić ten limit w Cloud Console, wykonując te czynności:

  1. Otwórz Panel interfejsów API i usług.
  2. Jeśli pojawi się taka prośba, wybierz projekt.
  3. Wybierz interfejs API z listy i kliknij kartę Limity.
  4. Kliknij ikonę edycji obok limitu żądania dziennie.

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

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

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

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

„Konto z przenoszeniem Google Maps Platform” zostało utworzone, aby pomóc niektórym klientom w przejściu na nowy abonament według wykorzystania. To konto pozwoliło Google udostępnić tym klientom jednorazowy kredyt, dzięki czemu mogą nadal korzystać z Google Maps Platform aż do limitu poziomu bezpłatnego (200 USD). Po przekroczeniu tego limitu konto rozliczeniowe zostanie zamknięte i utracisz dostęp do usługi. Jeśli chcesz uniknąć przerw w działaniu usługi, utwórz własne konto rozliczeniowe i korzystaj z bezpłatnego poziomu miesięcznych 200 USD. Aby zmienić konto rozliczeniowe dla Twojego projektu:

  1. Utwórz nowe konto rozliczeniowe (jeśli masz już konto rozliczeniowe, możesz pominąć ten krok).
  2. Powiąż konto rozliczeniowe z projektem.
Dlaczego mój limit jest ustawiony na 1 żądanie dziennie? Jak zwiększyć ten limit?

Jeśli nie masz jeszcze utworzonego konta rozliczeniowego i nie jest ono połączone z projektem, interfejsy API Maps Platform będą ograniczone do 1 żądania dziennie. Możesz uzyskać wyższy limit, tworząc i dołączając konto rozliczeniowe. Aby to zrobić, zobacz Pierwsze kroki z Google Maps Platform.

Gdy utworzysz i dodasz konto rozliczeniowe, limit dzienny zostanie usunięty. Aby uniknąć nieoczekiwanych wydatków, możesz ustawić limit w Cloud Console.

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

Wysłaliśmy do Ciebie to powiadomienie, ponieważ według naszych danych 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 nie można tworzyć wielu kont rozliczeniowych. Więcej informacji znajdziesz w Najczęstszych pytaniach dotyczących naruszenia konta rozliczeniowego.

Korzystanie z Google Maps Platform

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

Za każdym razem, gdy używasz usług Google Maps Platform, musisz zweryfikować klucz za pomocą klucza interfejsu API. Usługa Google Maps Platform jest dostępna w aplikacjach na Androida, iOS i internet oraz przez usługi internetowe HTTP.

Klucz interfejsu API:

  • Klucz interfejsu API jest unikalnym identyfikatorem generowanym przy użyciu Cloud Console.
  • Przykład wczytywania interfejsu API z kluczem: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Podpis cyfrowy:

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

Ograniczenia:

Poniższa tabela przedstawia ograniczenie klucza/danych logowania i ograniczenia aplikacji dla każdego interfejsu API/pakietu Google Maps Platform API.

Interfejs API/SDK Dane logowania i ograniczenia aplikacji
Pakiet SDK Map na Androida Klucz interfejsu API z ograniczeniami Androida1
Pakiet SDK Miejsc na Androida Klucz interfejsu API z ograniczeniami Androida1
Pakiet SDK Map na iOS Klucz interfejsu API z ograniczeniem iOS1
Pakiet SDK Miejsc na iOS Klucz interfejsu API z ograniczeniem iOS1
Interfejs Maps JavaScript API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1
Map Static API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1 + podpis cyfrowy2
Street Static API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1 + podpis cyfrowy2
Interfejs Maps Umieszczanie API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1
Interfejs Address Validation API Klucz interfejsu API z ograniczeniem adresu IP1
Trasa dojazdu Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs DISTANCE Matrix API Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs Elevation API Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs Geocoding API Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs API geolokalizacji Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs Roads API Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs API strefy czasowej Klucz interfejsu API z ograniczeniem adresu IP1
Interfejs Places API Klucz interfejsu API z ograniczeniem adresu IP1
1 Ograniczenia klucza interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API, aby zwiększyć bezpieczeństwo.
2 W zależności od sposobu użycia interfejs Maps Static API i Street View Static API mogą wymagać podpisu cyfrowego. Niezależnie od użycia zdecydowanie zalecamy używanie kluczy interfejsu API i podpisu cyfrowego do uwierzytelniania żądań.
Jak zmienić typ ograniczenia klucza z odesłania HTTP na ograniczenie adresu IP?

Ważne: jeśli używasz któregokolwiek z interfejsów API usługi internetowej z kluczem interfejsu API z ograniczeniami dotyczącymi stron odsyłających, Twoje żądania kończą się niepowodzeniem i komunikatem 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 dotyczącymi adresów IP.

Zanim zmienisz typ ograniczenia klucza interfejsu API z adresu URL HTTP na adres IP, sprawdź, czy wszystkie interfejsy API, które używają 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ż jedno ograniczenie, dodaj oddzielny klucz z wymaganym ograniczeniem. Zobacz, jak dodać nowy klucz interfejsu API.

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

Aby zmienić klucz interfejsu API z ograniczeniem strony odsyłającej HTTP na ograniczenie adresu IP:

  1. Otwórz stronę Dane logowania w Cloud Console.
  2. Wybierz projekt zawierający klucz interfejsu API, który chcesz edytować.
  3. Na stronie Dane logowania wybierz nazwę klucza interfejsu API, aby edytować jego szczegóły.
  4. W sekcji Ograniczenie klucza strony wybierz „Adresy IP (serwery WWW, zadania cron itp.)” i wpisz odpowiednie adresy IP serwera, a potem 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:

Wersję, która została naprawiona w Google Maps Platform, możesz też sprawdzić w narzędziu do śledzenia problemów:

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

Jak mogę asynchronicznie wczytać interfejs API po wczytaniu strony?

Wystarczy podać parametr wywołania zwrotnego podczas wczytywania interfejsu API. Więcej informacji i przykładowy kod znajdziesz w rozdziale Pierwsze kroki w dokumentacji interfejsu Maps JavaScript API.

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

Domyślnie interfejs API próbuje wczytać odpowiedni język na podstawie lokalizacji użytkownika lub ustawień przeglądarki. Niektóre interfejsy API pozwalają wyraźnie określić język podczas przesyłania żądania. Więcej informacji o ustawianiu języka znajdziesz w dokumentacji dotyczącej każdego interfejsu 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 Malayalam
ca kataloński mr marathi
zh chiński mn mongolski
zh-CN chiński (uproszczony) ne nepalski
zh-HK chiński (Hongkong) nie norweski,
zh-TW chiński (tradycyjny) pl polski
godz. chorwacki pt portugalski
cs czeski pt-BR portugalski (Brazylia)
da duński pt-PT portugalski (Portugalia)
nl niderlandzki pa pendżabski
en angielski ro rumuński
en-AU angielski (Australia) ru rosyjski,
en-GB angielski (Wielka Brytania) sr serbski
et estoński si syngaleski
fa perski sk słowacki
fi fiński sl słoweński
fil filipiński es hiszpański
fr francuski es-419 hiszpański (Ameryka Łacińska)
fr-CA francuski (Kanada) sw suahili
gl galicyjski sv szwedzki.
ka gruziński ta tamilski
de niemiecki te telugu
el grecki th tajski
gu gudżarati tr turecki
iw hebrajski uk ukraiński
hi hindi ur urdu
hu węgierski uz uzbecki
jest islandzki vi wietnamski
id indonezyjski zu zulu
it włoski

Możesz zobaczyć, jak mapa będzie wyglądać w każdym z wymienionych powyżej języków w tej przykładowej aplikacji.

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

Interfejs Maps JavaScript API, Maps Static API i Web Service API są dostępne przez bezpieczne połączenia (HTTPS). Informacje o uzyskiwaniu dostępu do interfejsu API przez SSL znajdziesz w dokumentacji dotyczącej tego interfejsu.

Pamiętaj, że interfejs Statyczny interfejs API Map Google nie obsługuje niestandardowych adresów URL ikon używających protokołu HTTPS. Wyświetli się ikona domyślna.

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

Jeśli uważasz, że to pomyłka, najpierw zgłoś to na odpowiednim forum. Umożliwi to innym deweloperom sprawdzenie błędu i wyeliminowanie wszelkich potencjalnych problemów z kodem.

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

Gdy potwierdzisz, że wystąpił nowy błąd lub nie spełniasz już wymagań obowiązujących w usługach Google Maps Platform, zgłoś błąd lub prośbę o dodanie funkcji, korzystając z narzędzia do śledzenia problemów Google Maps Platform.

Przed dodaniem błędu lub funkcji do narzędzia Issue Tracker sprawdź, czy problem nie został już dodany. Jeśli ją ma, możesz oznaczyć problem gwiazdką, aby zgłosić zainteresowanie i otrzymywać powiadomienia o aktualizacjach.

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

Maps SDK na Androida i SDK do Map na iOS korzysta z plików cookie podlegających Polityce prywatności Google, takich jak obliczanie liczby aktywnych użytkowników dziennie i 7 dni oraz zapobieganie nadużyciom usług. Te pliki cookie nie są powiązane z żadnym zalogowanym kontem Google i nie są rejestrowane w pozostałych informacjach zebranych przez wywołania interfejsu API.

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

Zespół Google ds. relacji z deweloperami dba o to, aby witryna Stack Overflow była wspólnym miejscem do pytań i odpowiedzi dla programistów. Można tutaj zadać pytania techniczne dotyczące tworzenia i utrzymywania aplikacji Map Google. Więcej informacji na temat zadawania pytań na stronie Stack Overflow znajdziesz na stronie Pomoc.

Podczas zwracania się o pomoc warto pamiętać o tych kwestiach:

  • Przeszukaj bieżące dyskusje. Być może ktoś inny miał podobny problem i znalazł rozwiązanie.
  • Jeśli to możliwe, prześlij link do swojej witryny. Używaj tylko tych fragmentów kodu, których nie można łatwo wyświetlić online.
  • Podaj wszystkie istotne informacje, w tym wersje przeglądarki, błędy i inne fakty, które mogą być przydatne podczas rozwiązywania tego problemu.

Błędy i rozwiązywanie problemów

Co oznacza ten błąd?

Jeśli podczas wczytywania lub uruchamiania interfejsów API Map Google wystąpi błąd, te linki pomogą Ci znaleźć kody błędów:

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

W pewnych okolicznościach może się wyświetlać ciemna mapa lub „negatywny” obraz Street View z komunikatem „tylko do celów programistycznych”. To zwykle pokazuje problemy z kluczem interfejsu API lub rozliczeniami. Aby korzystać z usług Google Maps Platform, musisz mieć konto rozliczeniowe, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Ten proces pomoże Ci rozwiązać ten problem:


Jak naprawić kody błędów: OVER_DAILY_LIMIT lub OVER_QUERY_LIMIT?
Te kody błędów można zwrócić z dowolnego z tych powodów:
  • W żądaniu nie ma klucza interfejsu API.
  • Podany klucz interfejsu API jest nieprawidłowy.
  • Projekt nie ma dołączonego konta rozliczeniowego.
  • Przekroczono limit użycia.
  • Podana forma płatności jest już nieważ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:

Jak naprawić kody błędów: kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Jeśli widzisz kGMSPlacesRateLimitExceeded lub 9005 PLACES_API_RATE_LIMIT_EXCEEDED, być może używasz wycofanej wersji pakietu SDK Miejsc na Androida lub pakietu SDK Miejsc na iOS. Więcej informacji i informacje o nowych pakietach SDK znajdziesz na stronie https://goo.gle/places-sdk-deprecation.
Jak naprawić błąd: „Ten adres IP, witryna lub aplikacja mobilna nie ma uprawnień do korzystania z tego klucza interfejsu API”?

Możliwe przyczyny tego błędu:

  • Włączono ograniczenia adresów IP (serwera) w kluczu interfejsu API, a nieautoryzowany adres IP próbuje wysłać żądanie.
  • W swoim kluczu interfejsu API włączono ograniczenia strony odsyłającej HTTP (witrynę), a nieupoważniona strona odsyłająca próbuje przesłać żądanie.
  • Użycie aplikacji na Androida zostało ograniczone przez ustawienie nazwy pakietu i odcisku cyfrowego, 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 występował wcześniej przy użyciu dowolnego z interfejsów usługi internetowej z kluczem interfejsu API z ograniczeniami dotyczącymi stron odsyłających HTTP. Żądania do tych interfejsów API powinny być powiązane z kluczem interfejsu API z ograniczeniami adresu IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej na ograniczenie adresu IP Więcej informacji o ograniczaniu kluczy interfejsu API znajdziesz w artykule Sprawdzone metody korzystania z 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:

  1. Otwórz stronę Dane logowania w Cloud Console.
  2. Wybierz projekt zawierający klucz interfejsu API, który chcesz sprawdzić.
  3. Aby wyświetlić szczegóły danych logowania, w tym ograniczenia ustawione dla klucza, na liście kluczy interfejsu API kliknij nazwę klucza.
  4. Wyświetlane są pełne dane logowania wybranego klucza interfejsu API, w tym wszystkie ograniczenia skonfigurowane dla tego klucza. W tym miejscu możesz zmieniać, usuwać i aktualizować ograniczenia.
Jak naprawić błąd: „Nie można używać kluczy interfejsu API z ograniczeniami dotyczącymi strony odsyłającej”?

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

Usługi Google Maps Platform

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

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

Możesz też udostępnić interfejs Geocoding API, który udostępnia interfejs REST w formacie JSON i XML.

W których krajach dostępne jest kodowanie geograficzne?

Aby zobaczyć kraje, w których obecnie dostępne są kodery Google Maps Platform, zapoznaj się z danymi o zasięgu w Mapach Google.

Dokładność lokalizacji kodowanych geograficznie może się różnić w zależności od kraju, dlatego rozważ użycie zwróconego pola location_type, aby określić, czy na potrzeby Twojej aplikacji wykryto wystarczające dopasowanie. Dostępność danych geokodowania zależy od umów z dostawcami danych, dlatego może ulec zmianie.

Dlaczego geokodery Google Maps Platform określają 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). Koder interfejsu API jest czasami aktualizowany o nowe dane, więc możesz się spodziewać zmian lub poprawy wyników.

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

Koder ten służy do mapowania adresów ulic do współrzędnych geograficznych. Dlatego zalecamy formatowanie żądań kodera zgodnie z tymi wytycznymi, aby zmaksymalizować prawdopodobieństwo zrealizowania zapytania.

  • Prześlij adresy zgodnie z formatem używanym w krajowym urzędzie pocztowym.
  • Nie podawaj dodatkowych elementów adresu, takich jak nazwy firm, numery jednostek, numery pięter i numery mieszkań, które nie są uwzględnione w adresie zgodnie z definicją pocztowym danego kraju. Może to spowodować otrzymanie odpowiedzi z odpowiedzią ZERO_RESULTS.
  • Sformatuj kody Plus Code jak w tym miejscu (znaki plusa mają znaczenie, gdy adresy są zmienione na %2B), a spacje mają zmianę do %20):
    • kod globalny to 4-znakowy kod obszaru i co najmniej 6 znak lokalny (849VCWC8+R9 to 849VCWC8%2BR9).
    • kod złożony to co najmniej 6-znakowy kod lokalny z wyraźną lokalizacją (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Jeśli to możliwe, użyj numeru budynku należącego do nazwy budynku.
  • W miarę możliwości używaj skrzyżowań z numerem adresowym.
  • Nie podawaj „wskazówek” takich jak punkty orientacyjne w pobliżu.
Jak sformatować adres USA na numerowanej drodze do geokodowania?

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

  • Drogi hrabstwa: "Co Road NNN", gdzie NNN to numer drogi. "Co Road 82"
  • Drogi stanowe: "State NNN", gdzie Stan to pełna nazwa stanu, a NNN to numer autostrady, np. "California 82"
  • Stany Zjednoczone:"U.S. NNN", gdzie NNN to numer drogi. np. "U.S. 101"
  • Międzystanowe Stany Zjednoczone"Interstate NNN", gdzie NNN to numer międzystanowy. np. "Interstate 280"
Kiedy należy używać klasy kodera interfejsów API, a kiedy usługi geokodowania HTTP?

Zapoznaj się z artykułem na temat strategii geokodowania przedstawiających wady i zalety różnych strategii geokodowania.

Jak podać trasę dojazdu w Google Maps Platform?

Interfejs DIRECTION API umożliwia podawanie wskazówek dojazdu na trasach jedno- i wieloetapowych. Opcje wyznaczania tras pomagają kształtować trasy za pomocą środka transportu (trasa), pojedynczej lub zestawu tras oraz ograniczeń (brak dróg płatnych). Usługa jest dostępna w tych formatach:

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

Aby zobaczyć w usługach Google Maps Platform, które kraje obsługują obecnie wskazówki dojazdu w Mapach Google, zapoznaj się z danymi o zasięgu Map Google. Pamiętaj, że dostępność wskazówek dojazdu zależy od umów z dostawcami danych i może ulec zmianie.

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

Interfejs API wskazówek dojazdu i interfejs DISTANCE Matrix API obsługują wszystkich partnerów Google Transportu publicznego 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 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 interfejsu Maps JavaScript API?

Limity rozmiaru i złożoności wyświetlania pliku KML za pomocą klasy KmlLayer opisano tutaj.

Jak renderować pliki KML, które znajdują się w witrynach intranetowych na mapie?

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

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

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

Nie ma ograniczeń co do liczby znaczników ani wierzchołków ścieżek obsługiwanych przez interfejs Statyczny interfejs API Map Google. W przypadku ikon niestandardowych można określić maksymalnie 5 unikalnych ikon na żądanie, ale każdej z nich można używać wiele razy na mapie.

Adres URL statycznego interfejsu API Map Google może mieć maksymalnie 8192 znaki, które ograniczają liczbę znaczników i wierzchołków ścieżek, które można określić na podstawie liczby miejsc dziesiętnych używanych do określania każdej pary szerokości i długości geograficznej. Informacje o tym, jak stosowana jest liczba miejsc dziesiętnych w odniesieniu do dokładności na Ziemi, znajdziesz w artykule o stopniach dziesiętnych w Wikipedii.

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

interfejsów API Map Google nie można używać w terytoriach objętych zakazem. Więcej informacji znajdziesz w Warunkach korzystania z usługi.

Jak zgłosić problem na mapie podstawowej Google?
Prześlij opinię w Mapach Google z błędnymi lub brakującymi informacjami o mapie, takimi jak:
  • nieprawidłowe adresy lub błędne lokalizacje znaczników.
  • nieprawidłowe nazwy dróg,
  • Nieprawidłowe informacje o drogach jedno- i dwukierunkowych
  • drogę przebiegającą nieprawidłowo,
  • zamknięte drogi,
  • nieistniejące drogi,

Aby poprawić miejsce lub wizytówkę firmy, zaproponuj zmianę.

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

W przypadku zgłoszeń o znaczeniu krytycznym lub wrażliwych na czas prześlij zgłoszenie do zespołu pomocy ze szczegółowymi informacjami o tym, co trzeba naprawić.

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

Niektóre funkcje po stronie klienta służą do raportowania sukcesu lub niepowodzenia w celu obliczania docelowego poziomu usług. Te informacje są wysyłane do Google pod numer maps.googleapis.com/maps_api_js_slo/log w wywołaniach logu docelowego poziomu usług. Informacje te obejmują stan sukcesu, opóźnienie oraz wersję/kanał używanego interfejsu Maps JavaScript API. Połączenia mogą być grupowane w celu wydajności. Uwaga: aby mieć pewność, że te wywołania nie są blokowane na poziomie przeglądarki, konieczne może być pozwolenie aplikacji maps.googleapis.com w Polityce treści. Na przykład: Content-Security-Policy: default-src 'self' maps.googleapis.com; z nagłówkami HTTP lub <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> z metatagami HTML.

Maps JavaScript API

Jak długo będzie działać interfejs Maps JavaScript API po jego wczytaniu?

Co najmniej raz na 5 dni odświeżaj stronę, która wczytuje interfejs Maps JavaScript API.

Google Maps SDK na iOS

W Xcode 12 aplikacje nie są prawidłowo kompilowane dla symulatora. Jak rozwiązać ten problem?

Aby rozwiązać ten problem, otwórz ustawienia kompilacji swojego projektu w Xcode i dodaj arm64 do Excluded Architectures tylko dla kompilacji „iOS Simulator”.

Więcej informacji znajdziesz w tym wątku StackOverflow.

Jak naprawić błąd: kGMSPlacesRateLimitExceeded?
Jeśli widzisz ten błąd, być może korzystasz z wycofanej wersji pakietu SDK Miejsc na iOS. Wersja 2.7.0 pakietu SDK Miejsc na iOS została wyłączona i nie jest już dostępna. Zaktualizuj jak najszybciej aplikację do najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.
Podczas debugowania na urządzeniu z iOS 8.x pojawiają się błędy. Co mam zrobić?

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

  1. W narzędziu XCode wybierz Produkt, Schemat lub Zarządzaj schematami.
  2. Wybierz schemat i kliknij Edytuj...
  3. Ustaw opcję Gam Frame Capture na ustawienie Wyłączone. Pamiętaj, że na niektórych urządzeniach ta opcja może nie być dostępna.
Jaki jest wpływ zaokrąglonych i szerszych ekranów w pakiecie SDK Map Google na iOS?

Począwszy od iPhone'a iPhone ma kształt ekranu z zaokrąglonymi rogami, nacięcie u góry pokrywa czujnika urządzenia i wskaźnik na dole ekranu umożliwiający dostęp do ekranu głównego. W wersji 11.0 pakietu Apple iOS dodaliśmy Safe Area API, który pozwala programistom umieścić elementy w obszarze, który nie zostanie przycięty do nowego kształtu ekranu.

Pakiet SDK Map Google na iOS ma wiele elementów wizualnych i elementów sterujących, takich jak wewnętrzny selektor i link do zgłaszania problemu. W wersji 2.4 te elementy wizualne i elementy sterujące mogą zostać przycięte według nowego kształtu ekranu. W trybie poziomym selektor pomieszczeń wewnętrznych może zostać przycięty przez wskaźnik lub przycisk ekranu głównego.

W pakiecie SDK Map Google na iOS do wersji 2.5 automatycznie usuwamy problemy z układem. Gdy używasz aplikacji na iPhonie X lub nowszym, dopełnienie w GMSMapView i GMSPanoramaView jest zwiększane, aby elementy wizualne nie zostały przycięte.

Domyślnie zawsze umieszczamy dopełnienie. Pakiet SDK Map Google na iOS zakłada, że dopełnienie ma pojawiać się w bezpiecznym obszarze. Jeśli interfejs zostanie zaprojektowany przy założeniu, że wszystkie elementy są umieszczone w bezpiecznym miejscu, to nic nie szkodzi.

Jeśli Twój interfejs nie działa z dostosowaniem domyślnym, wprowadziliśmy w GMSMapView nową właściwość o nazwie adjustadjustZachowanie. W GMSMapView możesz teraz wybrać jedno z 3 dostosowań wypełnienia: „Zawsze” (domyślnie), „Automatyczny” lub „Nigdy”.

Jeśli zasada GMSMapView jest ustawiona na dopełnienie „Zawsze”, dopełnienie to zawsze powoduje dodanie dopełnienia bezpiecznego obszaru. Umożliwia to zaprojektowanie interfejsu przy założeniu, że wszystkie miejsce docelowe znajduje się poza krawędziami bezpiecznej strefy. jest to wartość domyślna

Jeśli w GMSMapView jest ustawione dopełnienie „Automatyczne”, zawsze większe jest dopełnienie lub bezpieczne wcięcie obszaru. Umożliwi to dodanie dopełnienia od krawędzi ekranu przy jednoczesnym zapewnieniu, że wszystkie elementy pozostaną w bezpiecznym obszarze.

Jeśli zasada GMSMapView jest ustawiona na dopełnienie „Nigdy”, dopełnienie nie zostanie dodane do bezpiecznej strefy. Tak wygląda sytuacja przed aktualizacją do wersji 2.5. Może się ona przydać, jeśli dopełnienie uwzględnia już bezpieczny obszar lub gdy inne elementy interfejsu nie współgrają z interfejsem. Twoim obowiązkiem jest dbanie o to, aby logo Google i informacje o prawach autorskich były zawsze widoczne, zgodnie z Warunkami korzystania z Google Maps Platform.

Z kolei GMSPanoramaView nie ma opcjonalnej właściwości dopełnienia. Oznacza to, że nie ma dopełnienia, które można by dostosować, a panorama GMS Panoramiczne widoki zawsze zastosuje niezbędne dopełnienie, aby 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 korzystasz z wycofanej wersji pakietu SDK Miejsc na Androida. Wersja pakietu SDK Miejsc Google na Androida została wyłączona i nie jest już dostępna. Zaktualizuj jak najszybciej aplikację do najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.
Moja aplikacja wyświetla zamiast mapy tylko puste szare kafelki. Jak rozwiązać ten problem?

Częstym powodem problemów z uwierzytelnianiem są puste szare kafelki zamiast mapy. Aby rozwiązać te problemy, wykonaj czynności opisane poniżej w narzędziu adb logcat.

  1. Zainstaluj narzędzie adb. Jeśli jeszcze nie masz dostępu, zapoznaj się z przewodnikiem, który znajdziesz tutaj.
  2. Zainstaluj aplikację, która pokazuje problem na urządzeniu lub w emulatorze Androida. Jeśli używasz emulatora Androida, upewnij się, że jego ustawienia są uwzględnione w Sklepie Play.
  3. W terminalu Android Studio uruchom polecenie adb logcat -e "Google Maps Android API". Spowoduje to wydrukowanie wierszy tylko wtedy, gdy komunikat dziennika będzie zgodny z interfejsem „Google Maps Android API” (opcjonalnie możesz wyeksportować dziennik do pliku tekstowego, dołączając plik > logcat.txt).
  4. Odtwórz problem na urządzeniu i sprawdź, czy nie występują typowe błędy, takie jak:
    • W pliku manifestu odwołuje się 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 dodano nieprawidłowy odcisk SHA1.
    • Plik build.gradle nie korzysta z zależności usługi Google Play.

Podpisywanie URL

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

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

Dlaczego w odpowiedzi na żądania usługi internetowej interfejsu Maps API otrzymuję odpowiedź HTTP 403 Forbidden?

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

  1. Podpis został podany, ale jest nieprawidłowy w przypadku tego żądania.
  2. Żądanie określa abonament Premium Google Maps Platform dla klucza interfejsu API, 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.
  3. Podpis został określony, ale nie określono powiązanego klucza interfejsu API abonamentu Google Maps Platform Premium.