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

Google Maps Platform – najczęstsze pytania

Pierwsze kroki

Czym jest Google Maps Platform?

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

Mapy:

Trasy:

Miejsca:

Środowisko:

Jak zacząć korzystać z Google Maps Platform?

Zobacz Pierwsze kroki z Google Maps Platform.

Którego interfejsu API potrzebuję?

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

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

Zapoznaj się z instrukcjami z podsumowaniem, przewodnikiem dla programistów i wprowadzeniem do konkretnego interfejsu API lub pakietu SDK, którego używasz co może Cię zainteresować. Zapoznaj się na przykład z przewodnikami dotyczącymi pakietu Maps SDK na Androida lub interfejsu Maps JavaScript API.

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

Zespół Map Google stale udostępnia nowe dane map i poszerza zasięg na świecie. Sprawdź Mapy Google dane o pokryciu. Dane można filtrować z polem filtra u góry strony. Pamiętaj, że dane o pokryciu może ulec zmianie, jeśli zmienią się umowy licencyjne zawarte z dostawcami danych.

Zobacz też:

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

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

Tak. Mapy Google umożliwia umieszczenie oglądanej mapy w witrynie lub bez konieczności programowania ani korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.

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

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

Aby dodać mapy do natywnej aplikacji na iOS, użyj Maps SDK na iOS

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

W przypadku aplikacji kierowanych na urządzenia, które nie nadają się do korzystania z interfejsu Maps JavaScript API, interfejs Maps Static API dostarcza obrazów map w formatach GIF, JPG i PNG, w tym znaczników i polilinii. Pamiętaj, że używanie statycznego interfejsu API Map Google poza przeglądarką wymaga powiązania obrazu mapy z Mapami Google.

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

Interfejs Maps JavaScript API i Maps Embed API w tych przeglądarkach:

Komputer

Aktualna 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).
Dwie najnowsze główne stabilne wersje Safari (macOS).

. Android

Aktualna wersja Chrome na Androidzie w wersji 4.1 lub nowszej.
Komponent WebView Chrome na Androidzie 4.4 i nowszych.

. iOS

przeglądarka Safari na urządzeniach mobilnych 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 z interfejsu Maps JavaScript API?

Drukowanie z użyciem interfejsu Maps JavaScript API nie jest obsługiwane. To dlatego, że drukowanie obsługa jest niespójna w popularnych przeglądarkach.

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

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

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

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

Kiedy dostępna jest pomoc techniczna?

Zespół pomocy jest dostępny przez całą dobę, 5 dni w tygodniu (od poniedziałku od poniedziałku od 9:00 czasu Tokio do piątek, 17:00 czasu pacyficznego z wyłączeniem dni świątecznych Wyrażenie „nie można korzystać z usługi” problemów.

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

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

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

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

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

Jeśli nie masz dostępu do konta Google: spróbuj w celu odzyskania nazwy użytkownika lub hasła do konta.
Jeśli nie możesz odzyskać dostępu do konta Google: utwórz nowe konto Google, a potem skontaktować się z właścicielem projektu i poprosić go o dodać do projektu nowe konto Google.

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

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

Warunki korzystania z usługi

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

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

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

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

Możesz używać Google Maps Platform w swoich aplikacjach tak długo, jak Twoja witryna jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Są jednak sposoby korzystania z platformy Map Google, których nie akceptujemy: mapy wskazujące miejsca, w których można kupić narkotyki, czy też inne nielegalne działania. Szanujemy też prywatność ludzi, Google Maps Platform nie powinno być używane do identyfikowania informacji prywatnych o osób fizycznych.

Zanim zaczniesz tworzyć i wprowadzać aplikację, powinnaś/powinieneś skorzystać z usług prawnika, aby sprawdzić, czy aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform. Inżynierowie Google mogą oferować tylko pomoc techniczną i nie są uprawnieni do udzielania porad prawnych. Google zastrzega sobie prawo do zawieszenia lub możesz w każdej chwili przestać korzystać z usługi, więc przeczytaj Dokładnie zapoznaj się z warunkami korzystania z interfejsów API Map Google.

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

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

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

W Google Maps Platform nie ma ograniczeń dotyczących wyświetlania danych w czasie rzeczywistym (śledzenia) usług pod warunkiem, że aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform.

Czy mogę używać Map Google w aplikacji niebędącej aplikacją internetową?

Tak. Usług Google Maps Platform można teraz używać w aplikacjach innych niż internetowe. pod warunkiem, że przestrzegają innych ograniczeń określonych w Warunkach korzystania z usługi Google Maps Platform.

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

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

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

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

Jeśli aplikacja generuje dokument w formie elektronicznej lub drukowanej, dokument nie może zawierać żadnych danych z Google Maps Platform, w tym zdjęć. Zapoznaj się z Warunki korzystania z Google Maps Platform „Zakaz przyciągania” .

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

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

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

Czy mogę wygenerować obraz mapy za pomocą statycznego interfejsu API Map Google, i wyświetlać w witrynie?

Nie możesz przechowywać i przesyłać kopii obrazów wygenerowanych za pomocą interfejsu Maps Static API w swojej witrynie. Wszystkie strony internetowe, które wymagają obrazy statyczne muszą łączyć atrybut src w kodzie HTML img lub atrybut CSS background-image elementu HTML div bezpośrednio do statycznego interfejsu API Map Google, dzięki czemu wszystkie obrazy map są wyświetlane w treści HTML strony internetowej, a wyświetlanych użytkownikom bezpośrednio przez Google.

Limity wykorzystania i rozliczenia

Jak skonfigurować rozliczenia w projekcie?

Zobacz Pierwsze kroki z Google Maps Platform.

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

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

Czy Google Maps Platform ma limity wykorzystania?

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

W przypadku funkcji Distance Matrix limit jest ustawiany w zdarzeniu na minutę (EPM) obliczanym jako suma zapytań po stronie klienta i serwera.

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

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

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

Interfejs API	Limit wykorzystania
Weryfikacja adresów	6000 QPM
Aerial View: Lookup Video	180 QPM i 100 000 QPD
Widok z lotu: renderowanie filmu	100 QPM i 100 QPD
Jakość powietrza	6000 QPM
Instrukcje	3000 QPM
Macierz odległości	60 tys. EPM
Mapy dynamiczne	30 000 QPM
Wysokość	6000 QPM
Geokodowanie	3000 QPM
Geolokalizacja	6000 QPM
Interfejs Map Tiles API: kafelki 2D i kafelki Street View	6000 QPM i 15 000 QPD
Interfejs API Tiles: fotorealistyczne kafelki 3D	10 000 QPD
Interfejs API Tiles: fotorealistyczne kafelki 3D: mechanizm renderowania	12 000 QPM
Nawigacja: ustawianie żądań miejsc docelowych	30 tys. QPM
Miejsca	6000 QPM
Pyłek	6000 QPM
Drogi	30 000 QPM
Trasy: obliczanie tras	3000 QPM
Trasy: macierz tras Compute	3000 EPM
Panele słoneczne	600 QPM
Mapy statyczne	30 tys. QPM
Street View Image API	30 tys. QPM
Strefa czasowa	30 tys. QPM

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

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

Jak oblicza się koszty użytkowania?

Przegląd cen usług Google Maps Platform znajdziesz w arkuszu z cenami.

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

Jak są liczone wczytywania mapy w Google Maps Platform?

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

Na stronie internetowej lub w aplikacji wyświetlana jest mapa, przy użyciu której Maps JavaScript API.
Aplikacja wysyła żądanie pojedynczego obrazu mapy do interfejsu Maps Static API.

Panorama Street View jest naliczana osobno od wczytania mapy:

Za każde żądanie wysłane do Street View płacisz za statyczną panoramę Street View. Wyświetl statyczny interfejs API, aby umieścić statyczną (nieinteraktywną) panoramę Street View.
Za każdą instancję obiektu panoramy w interfejsie Maps JavaScript API, pakiecie Maps SDK na Androida lub pakiecie Maps SDK na iOS naliczana jest opłata za dynamiczną panoramę Street View.

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

Dodanie znacznika nie spowoduje dodatkowego wczytywania mapy, ale może spowodować wygenerowanie opłat związanych z określona lokalizacja pinezki (np. wczytanie lub ponowne załadowanie klasy „google.maps.Map()”).

Jak monitorować użycie?

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

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

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

Jeśli jeszcze tego nie zrobiono, skonfiguruj rozliczenia.
Otwórz stronę płatności Cloud Console.
Wybierz projekt.
Na pasku bocznym po lewej stronie kliknij Raporty. Użyj filtrów na na prawym pasku bocznym, aby wyświetlić raporty na koncie rozliczeniowym.

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

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

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

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

Uwaga: 4 z interfejsów API usług internetowych mają odpowiednik usługi po stronie klienta dostępny w Maps JavaScript API: Directions (wyznaczanie trasy), Distance Matrix (macierz odległości), Elevation (wysokość) i Geocoding (geokodowanie).

Przekroczono limity wykorzystania

Jeśli przekroczysz limity wykorzystania, otrzymasz OVER_QUERY_LIMIT kodu stanu jako odpowiedzi.

Ten komunikat oznacza, że usługa internetowa przestała wysyłać normalne odpowiedzi i zmieniła się na zwracanie tylko kodu stanu OVER_QUERY_LIMIT do czasu ponownego zezwolenia na dalsze korzystanie. Ten scenariusz może wystąpić w ciągu kilku sekund, jeśli błąd ponieważ Twoja aplikacja wysłała zbyt wiele żądań na minutę.

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

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

Tak. Zalecamy jednak zapoznanie się z limity wykorzystania dowolnej usługi Google Maps Platform. zależy od niej.

Czy jeśli moja witryna lub aplikacja stanie się nagle popularna, moje mapy przestaną się wyświetlać pracujesz?

Po przekroczeniu bezpłatnego limitu wykorzystania w wysokości 200 USD miesięcznie po przekroczeniu limitu wykorzystania konta rozliczeniowego nie masz na koncie rozliczeniowym ważnej formy płatności (karta kredytowa, przelew bankowy itp.), interfejs API przestanie działać, dopóki nie dodasz prawidłowej formy płatności.

Jak będą obliczane i rozliczane wykorzystanie?

Korzystanie z usługi jest obliczane pod koniec każdego dnia i obliczane zgodnie z arkuszem cen. Pod koniec każdego miesiąca łączna kwota za korzystanie jest obciążana formą płatności powiązaną z Twoim kontem rozliczeniowym. Więcej informacji: Rozliczenia za Google Maps Platform.

Ile kosztuje korzystanie z Google Maps Platform?

Aby zapoznać się z kosztami poszczególnych interfejsów API, zapoznaj się z cennikiem. Jeśli Twoja aplikacja generuje żądania lub obciążenia mapy do 200 USD miesięcznie; korzystanie z usługi nie jest obciążane opłatami. Wykorzystanie przekraczające 200 USD miesięcznie obciążono Twoje konto rozliczeniowe. Aby dowiedzieć się więcej, zapoznaj się z przewodnik po zrozumieniu Rozliczenia za Google Maps Platform.

Czy ceny są dostępne w innych walutach?

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

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

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

Dodatkowe zasoby:

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

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

W Google Maps Platform możesz ustawić dzienne limity żądań oraz maksymalne dzienne limity rozliczeniowe. Aby chronić się przed nieoczekiwanymi wzrostami, możesz ustawić maksymalny dzienny limit wykorzystania. Możesz też ustawić alerty dotyczące budżetu, aby otrzymywać e-maile z powiadomieniami, gdy obciążenia na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg.

Ograniczenie maksymalnego dziennego limitu naliczania należności:

Aby uniknąć dużych opłat, możesz ustawić dzienny limit wykorzystania aby zapobiec nieoczekiwanym wzrostom intensywności użytkowania. Dostępne opcje zmień ten limit w konsoli Cloud, wykonując te czynności:

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

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

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

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

Pojawił się komunikat, że mój projekt jest połączony z „Google Maps Platform „Przenieś konto”, ale ja nie mam do niego dostępu. Co mam zrobić?

„Konto przejściowe Google Maps Platform” która ma ułatwić klientów przechodzi na nowy abonament – płatność według wykorzystania. To przejście pozwoliło Google przyznać tym klientom jednorazowe środki, że mogą w dalszym ciągu korzystać z Google Maps Platform do limitu 200 USD poziomu bezpłatnego. Po przekroczeniu tego limitu konto rozliczeniowe zostanie zamknięte, utracisz dostęp do usługi. Aby uniknąć przerw w działaniu usługi, skonfiguruj własne konto rozliczeniowe i nadal korzystaj z taryfy bez opłat w wysokości 200 USD miesięcznie. Aby zmienić konto rozliczeniowe projektu:

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

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

Jeśli nie masz utworzonego konta rozliczeniowego ani nie dołączono do niego konta rozliczeniowego, interfejsy Maps Platform API będzie ograniczona do 1 żądania dziennie. Możesz zwiększyć limit, tworząc i dołączając informacje o płatnościach koncie. Aby dowiedzieć się, jak to zrobić, zobacz Pierwsze kroki z Google Maps Platform.

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

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

Otrzymaliśmy to powiadomienie, ponieważ stwierdziliśmy, że Twoje konto korzystało z kilku kont rozliczeniowych. Jest to naruszenie Warunków Google zgodnie z definicją w sekcji 3.2.4 Warunków korzystania z usługi Google Maps Platform. Zgodnie z tymi warunkami tworzenie wielu kont rozliczeniowych jest zabronione. Więcej informacji znajdziesz w artykule Płatności Najczęstsze pytania dotyczące naruszeń na koncie.

Korzystanie z Google Maps Platform

Których kluczy lub danych logowania należy używać w przypadku różnych Map i usługach?

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

Klucz interfejsu API:

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

Podpis cyfrowy:

Podpis cyfrowy jest generowany przy użyciu udostępnionego Ci tajnego klucza podpisywania URL-a przez Google. Podpisów cyfrowych są używane w interfejsie static API Map Google oraz Street View Static API.

Ograniczenia:

Ograniczenia klucza interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy API dla większego bezpieczeństwa. Zobacz Więcej informacji znajdziesz w artykule Sprawdzone metody zabezpieczania interfejsów API.
Możesz dodać do klucza interfejsu API ograniczenie aplikacji. Po ograniczeniu dostępu klucz będzie działać tylko na platformach, które obsługują tego typu ograniczenie. Dostępne są 4 typy ograniczeń aplikacji. Interfejsy API stosujące ten sam typ ograniczenia mogą używać tego samego klucza z ograniczeniem.
- Adresy IP (pojedyncze serwery) – na potrzeby interfejsów API usług sieciowych.
- Strony odsyłające HTTP (witryny internetowe) – do stosowania z interfejsami API sieci web.
- Ograniczenia aplikacji na Androida (według nazwy pakietu i odcisku palca) – do użytku z Maps SDK na Androida
- Ograniczenia aplikacji na iOS (według identyfikatora pakietu na iOS) – do użycia z Maps SDK na iOS
Możesz też dodać ograniczenie interfejsu API do klucza interfejsu API. Więcej informacji: Uzyskiwanie, dodawanie i ograniczanie klucza interfejsu API

W tabeli poniżej znajdziesz klucz/dane logowania i aplikację dla każdego interfejsu Google Maps Platform API lub pakietu SDK.

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

¹ Ograniczenia klucza interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy API w celu zwiększenia bezpieczeństwa.

² W zależności od sposobu użycia interfejsu Maps Static API i interfejsu Street View Static API może być wymagana podpis cyfrowy. Niezależnie od sposobu użycia zdecydowanie zalecamy uwierzytelnianie żądań za pomocą zarówno klucza interfejsu API, jak i podpisu cyfrowego.

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

Ważne: jeśli używasz interfejsów API usług sieciowych za pomocą klucza interfejsu API z ograniczeniami dotyczącymi stron odsyłających, żądania zakończą się niepowodzeniem z komunikat o błędzie: "Użyte klucze interfejsu API nie mogą mieć ograniczeń dotyczących stron odsyłających API”. Zamiast tego należy używać klucza API z ograniczeniami dotyczącymi adresów IP.

Zanim zmienisz typ ograniczenia klucza interfejsu API z strony odsyłającej HTTP na adres IP upewnij się, że wszystkie interfejsy API używające klucza API obsługują ten adres typu ograniczenia. Interfejsy API tego samego typu ograniczenia mogą używać tego samego klucza. Jeśli musisz zastosować więcej niż 1 ograniczenie, dodaj osobny klucz z wymaganym ograniczeniem. Zobacz, jak dodać nową kartę API.

Dowiedz się więcej o kluczu interfejsu API związane z usługami Google Maps Platform.

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

W konsoli Cloud otwórz stronę Dane logowania.
Wybierz projekt, który zawiera klucz API, który chcesz edytować.
Na stronie Dane logowania z listy kluczy interfejsu API wybierz nazwę. klucza interfejsu API, aby edytować jego szczegóły.
W sekcji Kluczowe ograniczenie 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 każdej wersji interfejsów API Map Google?

Informacje o zmianach wersji wielu interfejsów API Map Google są dostępne na tych stronach:

Możesz też sprawdzić, w której wersji Google Maps Platform wystąpił dany błąd. przedstawione i rozwiązane podczas korzystania z narzędzia Google Maps Platform Issue Tracker na stronie:

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

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

Wystarczy, że podczas wczytywania interfejsu API określisz parametr wywołania zwrotnego. Więcej informacji a przykładowy kod można znaleźć Otrzymywanie Rozpoczęcie rozdziału dokumentacji interfejsu Maps JavaScript API.

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

Domyślnie interfejs API będzie próbował załadować najbardziej odpowiedni język na podstawie lokalizację użytkownika lub ustawienia przeglądarki. Niektóre interfejsy API umożliwiają język docelowy, na podstawie którego wyślesz prośbę. Więcej informacji o ustawianiu języka znajdziesz w dokumentacji poszczególnych interfejsów API:

. Obsługiwane języki:

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

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

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

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

Maps JavaScript API, Maps Static API Interfejsy Web Service API mogą być dostępne przez bezpieczne połączenia (HTTPS). Zapoznaj się z dokumentacją dotyczącą API w celu uzyskania informacji na temat dostępu do niego przez SSL.

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

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

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

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

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

Zanim dodasz błąd lub prośbę o dodanie funkcji do narzędzia Issue Tracker, upewnij się, że: sprawdź, czy błąd lub funkcja, których dotyczy problem, nie zostały już dodane. Jeśli tak, możesz oznaczyć dany problem gwiazdką, aby wyrazić zainteresowanie i otrzymywać powiadomienia o aktualizacjach.

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

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

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

Zespół ds. relacji z deweloperami w Google jest obecny na stronie Stack Overflow – stronie z odpowiedziami na pytania i pytaniami edytowanymi wspólnie przez programistów. To to świetne miejsce do zadawania pytań technicznych na temat tworzenia aplikacji Mapy Google. Więcej informacji o zadawanie pytań w Stos Rozszerzone menu jest dostępne na stronie Pomoc.

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

wyszukiwać bieżące dyskusje; Prawdopodobnie ktoś inny miał podobny problem i znalazł jego rozwiązanie.
Jeśli to możliwe, prześlij link do swojej witryny. Publikuj fragmenty kodu tylko wtedy, gdy kod nie są łatwo dostępne online.
Podaj wszystkie istotne informacje, w tym wersje przeglądarki i błędy inne fakty, które mogą pomóc w rozwiązaniu tego problemu.

Błędy i rozwiązywanie problemów

Co oznacza ten błąd?

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

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

W pewnych okolicznościach może zostać wyświetlona przyciemniona mapa lub „negatywowy” obraz Street View z znakami wodnymi z tekstem „Tylko do celów rozwojowych”. 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. Poniższa procedura pomoże Ci rozwiązać ten problem:

Czy używasz klucza interfejsu API?

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

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

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

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

Informacje dla programistów stron internetowych:

Jeśli masz dostęp do kodu źródłowego aplikacji, poszukaj parametru Tag <script>, który służy do wczytywania interfejsu Maps JavaScript API. Podczas wczytywania interfejsu Maps JavaScript API zastąp w poniżej zamieszczonym kodzie wartość YOUR_API_KEY swoim kluczem interfejsu API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Sprawdź w przeglądarce ruch sieciowy generowany przez Twoją witrynę. W Chrome możesz to zobaczyć za pomocą DevTools Sieć. Zobaczysz tu żądania sieci wysłane przez Twoją witrynę. Żądania wysyłane za pomocą interfejsu Maps JavaScript API będą znajdować się na ścieżce maps/api/js. Tutaj możesz sprawdzić, czy żądania używają parametru key. Pomocne może być filtrować ruch w sieci według parametru 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 przewodnika konfiguracji, postępuj zgodnie z szczegółowe instrukcje na stronie Pierwsze kroki w Mapach Google Platforma.
Pierwsze kroki

Tak, używam klucza interfejsu API.

Świetnie. Sprawdźmy, czy z projektem jest połączone konto rozliczeniowe.

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

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

Przejdź do stronie Płatności w konsoli Google Cloud i wybierz projekt, w którym został utworzony klucz interfejsu API. Aby potwierdzić, że klucz jest powiązany z projektem:

Otwórz sekcję Dane logowania, do której możesz przejść z poziomego paska po lewej stronie w sekcji Google Maps Platform > Dane logowania.
Sprawdź, czy na liście znajduje się klucz interfejsu API, którego obecnie używasz w witrynie. Jeśli tak nie jest, przełącz się na inny projekt i sprawdź w nim dane logowania.
Jeśli nie możesz znaleźć projektu ze swoim kluczem interfejsu API, być może nie masz dostępu do tego projektu. Poproś o pomoc innych użytkowników w organizacji. Jeśli nie możesz znaleźć pierwotnego projektu, wykonaj te czynności:
1. Utwórz nowy projekt. W tym celu wybierz New Project (Nowy projekt). na liście projektów lub wybierając Utwórz projekt na Strona Menedżera zasobów.
2. Tworzenie nowego klucza interfejsu API Możesz to zrobić na stronie Dane logowania. Następnie kliknij kolejno Utwórz dane logowania i Klucz interfejsu API.

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

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

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

Tak, do mojego projektu jest przypisane konto rozliczeniowe.

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

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

Ty mogą dodawać, usuwać i aktualizować formy płatności w Cloud Console.

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

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

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

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

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

Kluczy interfejsu API z ograniczeniem adresów IP można używać tylko w usługach internetowych, które są przeznaczone do użytku po stronie serwera (np. Interfejs API geokodowania i innych interfejsów API usług sieciowych). Większość z tych usług internetowych ma swoje odpowiedniki w ramach interfejsu Maps JavaScript API (na przykład zobacz usługa geokodowania). Aby korzystać z usług po stronie klienta Maps JavaScript API, trzeba utworzyć oddzielny klucz interfejsu API, który można zabezpieczyć za pomocą ograniczenia strony odsyłającej HTTP (zobacz Pobieranie, dodawanie i ograniczanie klucza interfejsu API

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

Kody błędów mogą być zwracane z jednego z tych powodów:

W żądaniu brakuje klucza interfejsu API.
Podany klucz API jest nieprawidłowy.
Projekt nie ma przypisanego konta rozliczeniowego.
Przekroczono limit wykorzystania.
Podana forma płatności straciła ważność (na przykład ważność karty kredytowej wygasła).
Przekraczasz limity dla danego interfejsu API.

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

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

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

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

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

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

masz włączone ograniczenia adresów IP (serwerów) w swoim kluczu API, a nieautoryzowany adres IP próbuje wysłać żądanie.
w kluczu interfejsu API masz włączone ograniczenia dotyczące stron odsyłających HTTP (witryna), a nieautoryzowana strona odsyłająca próbuje wysłać żądanie.
Ograniczyłeś(-aś) możliwość korzystania z aplikacji na Androida przez ustawienie nazwa pakietu i odcisk cyfrowy oraz nieautoryzowana aplikacja na Androida próbuje przesłać żądanie.
Ograniczyłeś żądania z aplikacji na iOS, podając identyfikatory pakietów, a nierozpoznana aplikacja na iOS próbuje wysłać żądanie.
Wcześniej ten błąd mógł wystąpić, jeśli używasz interfejsów API usług internetowych z kluczem API, który ma ograniczenia dotyczące strony odsyłającej HTTP. Żądania wysyłane do tych interfejsów API powinny być identyfikowane za pomocą klucza API z ograniczeniami dotyczącymi adresu IP. Zmień typ ograniczenia klucza z ograniczenia dotyczącego strony odsyłającej HTTP na ograniczenie adresu IP. Więcej informacji o ograniczaniu kluczy interfejsu API znajdziesz w artykule Sprawdzone metody dotyczące kluczy interfejsu API.

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

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

W konsoli Cloud otwórz stronę Dane logowania.
Wybierz projekt zawierający klucz interfejsu API, który chcesz sprawdzić.
Aby wyświetlić szczegóły danych logowania, w tym wszelkie ograniczenia ustawione dla klucza, kliknij jego nazwę na liście kluczy API.
Zostaną wyświetlone pełne dane uwierzytelniające wybranego klucza interfejsu API, w tym wszystkie ograniczenia ustawione dla klucza. Tutaj możesz dodać ograniczenia zmienione, usunięte lub zaktualizowane odpowiednio do potrzeb.

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

Korzystasz z dowolnego interfejsu API usługi internetowej z kluczem API ograniczonym do strony odsyłającej HTTP. Ze względów bezpieczeństwa usługa sieciowa Interfejsy API muszą używać kluczy API ograniczonych do adresów IP. Zmień typ ograniczenia klucza z strony odsyłającej HTTP do ograniczenia 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 na świadczenie usług geokodowania. Klasa: google.maps.Geocoder.

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

W jakich krajach jest dostępna geokodowanie?

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

Dokładność geolokalizacji może się różnić w zależności od kraju, dlatego warto użyć zwróconych location_type, aby określić, czy znaleziono dopasowanie na potrzeby aplikacji. Pamiętaj, że dostępność dane geokodowania zależą od naszych umów z dostawcami danych, .

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 okresowo aktualizowany o nowe dane, więc z czasem możesz zauważyć zmiany lub poprawę wyników.

Jak sformatować zapytania geokodera, by zmaksymalizować liczbę udanych o prośbach?

Geokoder służy do mapowania adresów ulic na współrzędne geograficzne. Z tego powodu zalecamy sformatowanie żądań geokodera zgodnie z te wskazówki pomogą Ci zwiększyć prawdopodobieństwo pomyślnego wykonania zapytania:

Określ adresy w formacie używanym przez krajową pocztę danego kraju.
Nie podawaj dodatkowych elementów adresu, takich jak nazwy firm, numery lokali, numery pięter ani numery pokoi, które nie są uwzględnione w adresie określonym przez pocztę danego kraju. Może to spowodować odpowiedzi z ZERO_RESULTS.
Formatuj kody plusa w ten sposób (znaki plusa są zastępowane w adresie URL przez %2B, a spacje przez %20):
- Kod globalny to 4-znakowy kod obszaru i 6-znakowy lub dłuższy kod lokalny (849VCWC8+R9 to 849VCWC8%2BR9).
- złożony kod to co najmniej 6-znakowy kod lokalny ze znakiem bezpośrednia lokalizacja (CWC8+R9 Mountain View, CA, USA to CWC8%2BR9%20Mountain%20View%20CA%20USA).
Jeśli to możliwe, zamiast nazwy budynku użyj numeru domu.
Jako prefiksu należy podać numer ulicy, gdzie jak to tylko możliwe.
Nie podawaj „wskazówek” np. pobliskich punktów orientacyjnych.

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

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

County Roads:"Co Road NNN" gdzie NNN to numer drogi. Przykład: "Co Road 82"
Drogi stanowe: "State NNN" gdzie State to pełna nazwa stanu, a NNN to numer drogi. Przykład: "California 82"
Amerykańskie autostrady: "U.S. NNN" gdzie NNN to numer autostrady. np. "U.S. 101"
Stany Zjednoczone Międzystanami: "Interstate NNN", gdzie NNN to droga międzystanowa numer. np. "Interstate 280"

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

Zapoznaj się z dokumentem: Geokodowanie Strategie, które opisują wady i zalety różnych geokodowania. strategii ustalania stawek.

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

Usługa Compute Routes interfejsu Routes API oraz Interfejs Directions API umożliwia podawanie wskazówek dojazdu dla podróży jedno- i wieloetapowych. Opcje routingu pomagają określić trasę za pomocą trybu podróżowania (jazda samochodem), pojedynczej lub wielu tras oraz ograniczeń (bez dróg płatnych). Te usługi są dostępne w tych formach:

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

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

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

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

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

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

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

Ograniczenia rozmiaru i złożoności wyświetlania plików KML za pomocą Dokument zawiera KmlLayer zajęcia tutaj.

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

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

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

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

Nie ma ograniczeń co do liczby znaczników lub wierzchołków ścieżki obsługiwanych przez Statyczny interfejs API Map Google. W przypadku ikon niestandardowych możesz określić maksymalnie 5 niepowtarzalnych ikon na żądanie, ale każda z nich może być używana wielokrotnie na mapie.

Pamiętaj, że statyczne adresy URL Map Google mogą zawierać maksymalnie około 8192 znaków,co ogranicza liczbę znaczników wierzchołki ścieżki, które można określić na podstawie liczby miejsc po przecinku używane przy określaniu każdej pary długości i szerokości geograficznej. Informacje o tym, jak liczba użytych miejsc po przecinku ma się do dokładności na Ziemi, znajdziesz w artykule na Wikipedii Stopnie dziesiętne.

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

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

Jak zgłosić problem z mapą bazową Google?

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

nieprawidłowe adresy lub błędne lokalizacje znaczników.
nieprawidłowe nazwy dróg,
Nieprawidłowe informacje o drodze jednokierunkowej lub dwukierunkowej.
drogę przebiegającą nieprawidłowo,
zamknięte drogi,
nieistniejące drogi,

Aby poprawić informacje o miejscu lub firmie, zaproponuj zmianę.

Jeśli treści w Mapach Google należy usunąć z powodów prawnych, prześlij wniosek prawny.

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

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

Niektóre funkcje po stronie klienta są instrumentowane w celu raportowania powodzenia lub niepowodzenia w celu obliczenia docelowego poziomu usług. Te informacje są wysyłane do Google na adres maps.googleapis.com/maps_api_js_slo/log w wywołaniach rejestrujących informacje o docelowym poziomie usług. Informacje te obejmują stan powodzenia, czas oczekiwania oraz wersję i kanał używanego interfejsu Maps JavaScript API. Wywołania mogą być grupowane w celu zapewnienia wydajności. Pamiętaj, że może być konieczne włączenie maps.googleapis.com w Content Security Policy zapewnia Nie są one blokowane na poziomie przeglądarki. Na przykład: Content-Security-Policy: default-src 'self' maps.googleapis.com; z nagłówkami HTTP lub <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> z metatagami HTML.

Maps JavaScript API

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

Google Maps SDK na iOS

Jak naprawić błąd: kGMSPlacesRateLimitExceeded?

Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Places SDK na iOS. Pakiet SDK Miejsc na iOS w wersji 2.7.0 zawiera została wyłączona i nie jest już dostępna. Jak najszybciej zaktualizuj aplikację, aby korzystać z jej najnowszej wersji. Zapoznaj się z przewodnikiem po migracji. .

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

Jeśli napotkasz problemy podczas debugowania na urządzeniach z iOS 8.x, wykonaj te czynności, aby wyłączyć przechwytywanie klatek przez procesor graficzny w uruchomionym schemacie XCode:

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

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

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

Począwszy od iPhone’a X ekrany iPhone’ów mają zaokrąglone rogi, wycięcie na górze dla komory czujnika oraz wskaźnik u dołu ekranu, który umożliwia dostęp do ekranu głównego. W pakiecie SDK iOS 11.0 firma Apple dodała interfejs Safe Area API, który umożliwia deweloperom umieszczanie elementów w obszarze, który nie zostanie przycięty przez nowy kształt ekranu.

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

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

Domyślnie zawsze będziemy uwzględniać dopełnienie. Pakiet SDK Map Google na iOS zakłada, że wypełnienie ma być dodane w bezpiecznym obszarze. Jeśli zaprojektuj interfejs tak, aby wszystkie elementy znajdowały się wewnątrz w bezpiecznym obszarze, wszystko to działa bez dodatkowego wysiłku.

Jeśli zaprojektowano interfejs, który nie działa z naszymi domyślnymi, wprowadziliśmy w GMSMapView nową właściwość o nazwie paddingAdjustmentBehavior. Widok mapy GMSMapView umożliwia teraz wybranie jedno z trzech ustawień dopełnienia: „Zawsze” (domyślnie), „Automatycznie”, i „Nigdy”.

Jeśli obiekt GMSMapView jest ustawiony na używanie wartości „Zawsze” będzie zawsze działać dodaj wcięcia bezpiecznego obszaru do dopełnienia. Dzięki temu możesz zaprojektować przy założeniu, że wszystkie miejsca docelowe znajdują się na krawędziach bezpiecznych w pobliżu. jest to wartość domyślna

Jeśli obiekt GMSMapView jest ustawiony na używanie wartości „Automatyczny” będzie zawsze działać wybierz większe dopełnienie lub wcięcie obszaru bezpiecznego. Pozwoli Ci to dodać dopełnienie od krawędzi ekranu przy jednoczesnym zapewnieniu, że wszystkie elementy pozostaną w bezpiecznym obszarze.

Jeśli obiekt GMSMapView jest ustawiony na używanie wartości „Never” dopełnienie, nigdy nie zostanie dodane bezpieczny obszar jest wgłębiany w dopełnienie. Takie działanie było możliwe przed wydaniem wersji 2.5. Może być przydatne, jeśli margines już uwzględnia bezpieczną strefę lub jeśli inne zachowania nie działają prawidłowo w Twoim interfejsie. Twoim obowiązkiem jest dopilnowanie, aby logo Google i informacje o prawach autorskich były zawsze widoczne, zgodnie z opisem w Google Maps Platform Warunki korzystania z usługi.

W przypadku GMSPanoramaView opcjonalna właściwość padding nie jest dostępna. Ten oznacza, że nie ma dopełnienia, które można dostosować, a widok GMSPanoramaView zawsze jest stosowany. wszelkie niezbędne dopełnienia, dzięki którym wszystkie elementy wizualne znajdują się w bezpiecznym miejscu w pobliżu.

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 interfejsu Pakiet SDK Miejsc na Androida Wersja usługi Google Play Pakiet SDK Miejsc na Androida został wyłączony i nie jest już dostępny. Jak najszybciej zaktualizuj aplikację, aby korzystać z jej najnowszej wersji. Zobacz przewodniku po migracji.

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

Częstym powodem wyświetlania się pustych szarych kafelków zamiast mapy są problemy z uwierzytelnianiem. Aby rozwiązać te problemy, wykonaj czynności opisane poniżej, korzystając z polecenia adb logcat.

Sprawdź, czy masz zainstalowany adb. Jeśli nie, możesz postępować zgodnie z tym przewodnikiem.
Zainstaluj aplikację, która powoduje 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 polecenie adb logcat -e "Google Maps Android API". Wyświetli to tylko te wiersze, w których komunikat dziennika pasuje do „Google Maps Android API”. (Opcjonalnie możesz wyprowadzić dziennik do pliku tekstowego, dodając: > logcat.txt)
Odtwórz problem na urządzeniu i sprawdź, czy nie występują typowe błędy, takie jak:

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

Podpisywanie URL

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

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

Dlaczego otrzymuję odpowiedź HTTP 403 „Zabroniony” na mój Żądania usług sieciowych interfejsu API Map Google?

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

Określono podpis, ale jest on nieprawidłowy w przypadku tego żądania.
żądanie zawiera klucz API w ramach subskrypcji Google Maps Platform Premium, ale nie zawiera podpisu, a usługa, do której się odwołujesz, wymaga, aby żądania wysyłane za pomocą klucza API zawierały prawidłowy podpis;
Określono podpis, ale powiązany Klucz interfejsu API wersji premium Google Maps Platform nie został określony.