Pierwsze kroki
- Co to jest Google Maps Platform?
- Jak zacząć korzystać z Google Maps Platform?
- Którego interfejsu API potrzebuję?
- Jak zacząć korzystać z interfejsów API w witrynie?
- Które kraje obejmuje Google Maps Platform?
- Czy mogę umieścić Mapy Google w swojej witrynie, nie korzystając z usług Google Maps Platform?
- Jak udostępniać aplikacje Map Google na urządzeniach mobilnych?
- Które przeglądarki obsługują interfejsy Maps JavaScript API i Maps Embed API?
- Czy mogę drukować mapy z poziomu interfejsu Maps JavaScript API?
- Jak otrzymywać powiadomienia o zmianach w usługach Google Maps Platform?
- Jak skontaktować się z zespołem pomocy technicznej?
- Kiedy dostępna jest pomoc techniczna?
- Jak mogę odzyskać dostęp do konta Google?
- Jak odzyskać dostęp do konkretnego projektu?
- Czy mogę używać pakietu SDK Map i Miejsc na iOS na komputerach Mac z systemem Arm?
Omówienie warunków korzystania z usługi
- Jakie są warunki korzystania z usług Google Maps Platform?
- Czy moja witryna spełnia Warunki korzystania z usługi Google Maps Platform?
- Czy mogę uzyskać bezpośredni dostęp do fragmentów mapy i zdjęć satelitarnych?
- Czy mogę używać usług Google Maps Platform do śledzenia aplikacji?
- Czy mogę korzystać z usług Google Maps Platform w aplikacji innej niż internetowa?
- Czy mogę używać usług Google Maps Platform w witrynie chronionej hasłem?
- Czy mogę utworzyć aplikację zawierającą w dokumencie dane z Google Maps Platform?
- Jak mogę zrezygnować z umieszczania swoich treści w wynikach wyszukiwania Google?
- Czy mogę wygenerować obraz mapy za pomocą interfejsu Maps Static API, który przechowuję i udostępniam z mojej witryny?
Limity wykorzystania i płatności
- Jak skonfigurować płatności w projekcie?
- Jak klienci poziomu bezpłatnego Google Cloud Platform mogą przejść na płatne konto?
- Czy w Google Maps Platform obowiązują limity wykorzystania?
- Jak obliczamy koszt wykorzystania?
- Jak są liczone wczytania map w Google Maps Platform?
- Jak monitorować wykorzystanie limitu?
- Co się stanie, jeśli przekroczę limity wykorzystania?
- Moja witryna generuje duży ruch. Czy mogę korzystać z usług Google Maps Platform?
- Czy jeśli moja witryna lub aplikacja nagle stanie się popularna, moje mapy przestaną działać?
- Jak będzie obliczane i rozliczane wykorzystanie?
- Ile kosztuje korzystanie z Google Maps Platform?
- Czy ceny są dostępne w innych walutach?
- Płatności zostały skonfigurowane. Jak wyświetlić rachunek?
- Jak zabezpieczyć się przed wysokimi kosztami w przypadku nieoczekiwanego wzrostu wykorzystania?
- Widzę komunikat, że mój projekt jest połączony z „kontem przenoszonym w Google Maps Platform”, ale nie mam dostępu do tego konta. Co mam zrobić?
- Dlaczego mój limit jest ustawiony na 1 żądanie dziennie? Jak zwiększyć ten limit?
- Dotarło do mnie powiadomienie o naruszeniu zasad rozliczeń. Jak rozwiązać ten problem?
Korzystanie z Google Maps Platform
- Jakich kluczy lub danych logowania mam używać w różnych usługach Google Maps Platform?
- Jak zmienić typ ograniczenia klucza z strony odsyłającej HTTP na ograniczenie dotyczące adresu IP?
- Jak uzyskać nowy klucz interfejsu API?
- Jak znaleźć zmiany wprowadzone w poszczególnych wersjach Google Maps Platform?
- Jak asynchronicznie wczytać interfejs API na stronie po jej załadowaniu?
- Co zrobić, aby usługi Google Maps Platform wyświetlały się w języku innym niż angielski?
- Czy dostęp do Google Maps Platform można uzyskać przez protokół SSL (HTTPS)?
- Jak zgłosić błąd lub poprosić o dodanie nowej funkcji w Google Maps Platform?
- Jak interfejsy Google Maps Platform API używają plików cookie witryny?
- Nie mogę znaleźć odpowiedzi na moje pytanie. Z kim mogę się skontaktować?
Błędy i rozwiązywanie problemów
- Co oznacza ten błąd?
- Moje mapy są ciemniejsze niż zwykle. Co tu się odbywa?
-
Jak naprawić kody błędów
OVER_DAILY_LIMIT
lubOVER_QUERY_LIMIT
? -
Jak naprawić kody błędów
kGMSPlacesRateLimitExceeded
lub9005 PLACES_API_RATE_LIMIT_EXCEEDED
? - Jak naprawić błąd „Ten adres IP, ta witryna lub aplikacja mobilna nie ma uprawnień do korzystania z tego klucza interfejsu API”?
- Jak naprawić błąd „Klucze API z ograniczeniami dotyczącymi stron odsyłających nie mogą być używane z tym interfejsem 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?
- W których krajach dostępne jest geokodowanie?
- Dlaczego geokodery Google Maps Platform podają inne lokalizacje niż Mapy Google?
- Jak sformatować zapytania geokodera, aby zmaksymalizować liczbę udanych żądań?
- Jak sformatować adres w Stanach Zjednoczonych na autostradzie numerowanej na potrzeby geokodowania?
- Kiedy należy korzystać z klasy geokodera interfejsów API, a kiedy z usługi geokodowania HTTP?
- Jak podać wskazówki dojazdu za pomocą Google Maps Platform?
- W których krajach dostępne są wskazówki dojazdu?
- W których krajach dostępne są wskazówki dojazdu transportem publicznym?
- Które funkcje plików KML i GeoRSS są obsługiwane przez interfejs Maps JavaScript API?
- Jakie są ograniczenia rozmiaru i złożoności pliku KML, które można wyświetlić za pomocą klasy KmlLayer w interfejsie Maps JavaScript API?
- Jak renderować na mapie pliki KML przechowywane w witrynach intranetowych?
- Jaka jest maksymalna liczba znaczników lub wierzchołków ścieżek obsługiwanych przez interfejs Maps Static API?
- Dlaczego w niektórych krajach nie mogę uzyskać dostępu do usług Google Maps Platform?
- Jak zgłosić problem na mapie bazowej Google?
- Jak jest monitorowana wydajność usług używanych z interfejsem Maps JavaScript API?
Maps JavaScript API
Google Maps SDK na iOS
-
Jak usunąć błąd:
kGMSPlacesRateLimitExceeded
? - Podczas debugowania urządzenia z iOS 8.x występują awarie. Co mam zrobić?
- Jaki wpływ mają zaokrąglone i szersze ekrany na pakiet SDK Map Google na iOS?
Google Maps SDK na Androida
-
Jak usunąć błąd:
9001 Operation failed due to exceeding the quota usage limit
? - Moja aplikacja zamiast mapy wyświetla tylko puste szare kafelki. Jak rozwiązać ten problem?
Podpisywanie URL
- Czy mogę podpisywać adresy URL za pomocą JavaScriptu?
- Dlaczego na moje żądania usługi internetowej interfejsu API Map Google otrzymuję odpowiedź HTTP 403 „Forbidden”?
Pierwsze kroki
- Co to jest Google Maps Platform?
-
Google Maps Platform to zestaw interfejsów API i pakietów SDK, który umożliwia programistom umieszczanie Map Google w aplikacjach mobilnych i stronach internetowych oraz pobieranie danych z Map Google. Dostępnych jest kilka opcji. W zależności od potrzeb możesz korzystać z jednego z tych interfejsów API i pakietów SDK lub z ich kombinacji:
Mapy:
- Interfejs API JavaScript Map Google
- Pakiet SDK Map Google na Androida
- Pakiet SDK Map Google na iOS
- Interfejs API Map Tiles
- Aerial View API
- Statyczny interfejs API Map Google
- Statyczny interfejs API Street View
- Adresy URL Map Google
- Interfejs Maps Embed API
Trasy:
Miejsca:
- Places API,
- Pakiet SDK Miejsc Google na Androida
- Pakiet SDK Miejsc Google na iOS
- Biblioteka miejsc, Maps JavaScript API
- Adres API do weryfikacji adresów
- Geocoding API
- Interfejs API geolokalizacji
- Time Zone API
Środowisko:
- Jak zacząć korzystać z Google Maps Platform?
- Który interfejs API jest potrzebny?
-
Aby uzyskać pomoc w znalezieniu odpowiedniego interfejsu API na podstawie swoich wymagań funkcjonalnych, zapoznaj się z selektorem interfejsów API.
- Jak zacząć korzystać z interfejsów API w witrynie?
-
Informacje o konkretnym interfejsie API lub pakiecie SDK, które Cię interesują, znajdziesz w przeglądzie, instrukcjach dla programistów i przewodnikach dla początkujących. Na przykład przeczytaj przewodniki dotyczące pakietu SDK Map Google na Androida lub interfejsu Maps JavaScript API.
- Które kraje są dostępne w ramach Google Maps Platform?
-
Zespół Map Google nieustannie pracuje nad nowymi danymi map i zwiększa zasięg na całym świecie. Najnowsze informacje o zasięgu w Mapach Google znajdziesz w informacjach o zasięgu w Mapach Google. Dane możesz filtrować za pomocą pola filtra u góry strony. Pamiętaj, że dane o zasięgu mogą ulec zmianie w przypadku zmiany umów licencyjnych z dostawcami danych.
Zobacz też:
- Czy mogę umieścić Mapy Google w swojej witrynie bez używania usług Google Maps Platform?
-
Tak. W Mapach Google możesz teraz umieszczać wyświetlaną mapę na swojej stronie lub blogu bez konieczności programowania i korzystania z Google Maps Platform. Więcej informacji znajdziesz tutaj.
- Jak udostępniać aplikacje Map Google na urządzeniach mobilnych?
-
Aby umieścić mapy w aplikacji na Androida, użyj pakietu SDK Map Google na Androida.
Aby umieścić mapy w natywnej aplikacji na iOS, użyj pakietu Maps SDK na iOS.
Interfejs Map JavaScript API opracowano z myślą o urządzeniach mobilnych i jest odpowiedni dla przeglądarek przeznaczonych zarówno na komputery, jak i na urządzenia z przeglądarkami z pełną implementacją JavaScriptu, np. Apple iPhone.
W przypadku aplikacji kierowanych na urządzenia, które nie obsługują interfejsu Maps JavaScript API, interfejs Maps Static API dostarcza obrazy map w formatach GIF, JPG i PNG, w tym znaczniki i linie łamane. Pamiętaj, że korzystanie z interfejsu Maps Static API poza aplikacjami opartymi na przeglądarce wymaga połączenia obrazu mapy z Mapami Google.
- Które przeglądarki obsługują interfejsy Maps JavaScript API i Maps Embed API?
-
Interfejs Maps JavaScript API i Maps Embed API obsługują te przeglądarki:
Na komputerze- bieżąca wersja Microsoft Edge (Windows), z wyłączeniem trybu programu Internet Explorer.
- Dwie najnowsze główne stabilne wersje przeglądarki Firefox (Windows, macOS, Linux).
- Dwie najnowsze główne stabilne wersje Chrome (Windows, macOS, Linux).
- 2 najnowsze główne stabilne wersje Safari (macOS).
- Aktualna wersja Chrome na Androidzie 4.1 lub nowszym.
- Chrome WebView na Androidzie 4.4 lub nowszym.
- Mobile Safari w aktualnej i poprzedniej głównej wersji iOS.
- UIWebView i WKWebView w bieżącej i poprzedniej głównej wersji iOS.
- Aktualna wersja Chrome na iOS.
- Czy mogę drukować mapy za pomocą interfejsu Maps JavaScript API?
-
Drukowanie za pomocą interfejsu Maps JavaScript API nie jest obsługiwane. Dzieje się tak, ponieważ obsługa drukowania jest niespójna w najczęściej używanych przeglądarkach.
- Jak otrzymywać powiadomienia o zmianach w usługach Google Maps Platform?
-
Zasubskrybuj bloga Google Maps Platform, aby być na bieżąco z wiadomościami dotyczącymi różnych usług Google Geo dla deweloperów.
- Jak skontaktować się z pomocą techniczną?
-
Więcej informacji o dostępnych opcjach pomocy znajdziesz na stronie pomocy i zasobów Google Maps Platform.
- Kiedy dostępna jest pomoc techniczna?
- Zespół pomocy jest dostępny przez całą dobę, 5 dni w tygodniu (od poniedziałku do piątku w godzinach 9:00–17:00 czasu pacyficznego w Tokio) z wyjątkiem dni świątecznych w przypadku problemów związanych z brakiem możliwości korzystania z usługi.
- Jak mogę odzyskać dostęp do konta Google?
-
Jeśli nie masz dostępu do konta Google (np. jan@mojafirma.com lub jan@gmail.com), możesz spróbować przywrócić dostęp do konta, pobierając lub resetując hasło. Przeczytaj artykuł Jak odzyskać konto Google lub Gmail w Centrum pomocy konta Google.
- Uwaga: aby przywrócić dostęp do konta G Suite, poproś administratora organizacji o przywrócenie konta.
- Jak mogę odzyskać dostęp do konkretnego projektu?
-
Jeśli nie masz dostępu do projektu, w którym zarządzasz implementacją Google Maps Platform, możesz spróbować go odzyskać.
Jeśli masz dostęp do konta Google powiązanego z projektem:
- Jeśli znasz właściciela projektu i masz dostęp do swojego konta Google: poproś właściciela projektu o dodanie Cię jako właściciela projektu lub edytującego projekt.
- Jeśli Twój projekt należy do organizacji: skontaktuj się z administratorami organizacji i poproś o dodanie Cię jako właściciela projektu.
- Jeśli nie znasz żadnego z obecnych właścicieli projektu: jeśli nie wiesz, kto jest właścicielem projektu lub jest on niedostępny, skontaktuj się z zespołem pomocy, aby poznać dodatkowe możliwości odzyskania projektu.
Jeśli nie masz dostępu do konta Google powiązanego z projektem:
- Jeśli nie masz dostępu do konta Google: spróbuj odzyskać nazwę użytkownika lub hasło do konta.
- Jeśli nie możesz odzyskać dostępu do swojego konta Google: utwórz nowe konto Google, a następnie skontaktuj się z obecnym właścicielem projektu i poproś go o dodanie do projektu Twojego nowego konta Google.
- 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.
- Czy mogę używać pakietu SDK Map Google i Miejsc na iOS na komputerach Mac z architekturą Arm?
-
Opracowanie aplikacji na nowych Macach z architekturą Arm jest możliwe, ale wymaga utworzenia i działania na fizycznym urządzeniu z iOS. Jest to ograniczenie tymczasowe, ponieważ pracujemy nad dodaniem obsługi tworzenia symulatorów.
Omówienie warunków korzystania z usługi
- Jakie są warunki korzystania z usług Google Maps Platform?
-
Warunki korzystania z usługi Google Maps Platform są dostępne na stronie:
- Czy moja witryna spełnia Warunki korzystania z usługi Google Maps Platform?
-
Możesz korzystać z Google Maps Platform w swoich aplikacjach, o ile Twoja witryna spełnia Warunki korzystania z usługi Google Maps Platform.
Nie chcemy jednak oglądać niektórych przypadków użycia Google Maps Platform. Są to mapy wskazujące na przykład miejsca, w których można kupić narkotyki w mieście, lub inne nielegalne działania. Szanujemy też prywatność użytkowników, dlatego Google Maps Platform nie należy używać do identyfikowania prywatnych informacji o poszczególnych osobach.
Przed opracowaniem i uruchomieniem aplikacji upewnij się, że jest ona zgodna z Warunkami korzystania z usługi Google Maps Platform. Inżynierowie Google mogą zaoferować jedynie pomoc techniczną i nie mają kwalifikacji do udzielania porad prawnych. Google zastrzega sobie prawo do zawieszenia lub zakończenia korzystania z usługi w dowolnym momencie, dlatego dokładnie zapoznaj się z Warunkami korzystania z interfejsów API Map Google.
- Czy mogę uzyskać bezpośredni dostęp do fragmentów mapy i zdjęć satelitarnych?
-
Użytkownik nie może uzyskiwać dostępu do fragmentów map ani zdjęć satelitarnych w żaden inny sposób poza Google Maps Platform (takim jak tworzenie własnego interfejsu API do mapowania lub użycie skryptu zbiorczego pobierania fragmentów). Dostęp Twojej aplikacji do kafelków będzie zablokowany, jeśli będzie ona miała do nich dostęp poza Google Maps Platform. Więcej informacji znajdziesz w Warunkach korzystania z usługi Google Maps Platform.
- Czy mogę używać usług Google Maps Platform do śledzenia aplikacji?
-
Nie ma ograniczeń w wyświetlaniu danych w czasie rzeczywistym (monitorowaniu) w usługach Google Maps Platform, o ile aplikacja jest zgodna z Warunkami korzystania z usługi Google Maps Platform.
- Czy mogę korzystać z Map Google w aplikacji innej niż internetowa?
-
Tak. Z usług Google Maps Platform można teraz korzystać w aplikacjach innych niż internetowe, o ile przestrzegają one innych ograniczeń wynikających z Warunków korzystania z usługi Google Maps Platform.
Interfejs Maps JavaScript API jest obsługiwany tylko w jednej z obsługiwanych przeglądarek.
- Czy z usług Google Maps Platform mogę korzystać w witrynie chronionej hasłem?
-
Tak, usługi Mapy Google, Trasy, Miejsca i Środowisko mogą być używane z aplikacjami z dostępem prywatnym. Więcej informacji znajdziesz w Warunkach korzystania z usługi Google Maps Platform.
- Czy mogę utworzyć aplikację zawierającą w dokumencie dane z Google Maps Platform?
-
Jeśli Twoja aplikacja wygeneruje dokument w formie elektronicznej lub drukowanej, nie może on zawierać danych z Google Maps Platform, w tym obrazów. Więcej informacji znajdziesz w sekcji „Zakaz kopiowania danych” w Warunkach korzystania z usługi Google Maps Platform.
- Jak mogę zrezygnować z umieszczania swoich treści w wynikach wyszukiwania Google?
-
Nie zbieramy już tych danych. Używanie parametru
indexing
zostało wycofane i nie ma żadnego efektu. Nie musisz już od razu rezygnować, ale zachęcamy do jak najszybszego usunięcia tego parametru.Aby usunąć stronę lub witrynę z wyników wyszukiwania, postępuj zgodnie z instrukcjami podanymi w Centrum pomocy dla webmasterów.
- Czy mogę wygenerować obraz mapy za pomocą interfejsu Maps Static API, który jest przechowywany i wyświetlany z mojej witryny?
-
Nie możesz przechowywać ani wyświetlać kopii obrazów wygenerowanych w Twojej witrynie za pomocą interfejsu Maps Static API. Wszystkie strony internetowe, które wymagają obrazów statycznych, muszą łączyć atrybut
src
tagu HTMLimg
lub atrybut CSSbackground-image
tagu HTMLdiv
bezpośrednio z interfejsem Maps Static API, aby wszystkie obrazy map były wyświetlane w treści HTML strony i wyświetlały się bezpośrednio użytkownikom przez Google.
Limity wykorzystania i płatności
- Jak skonfigurować płatności w projekcie?
- Zobacz Pierwsze kroki z Google Maps Platform.
- Jak klienci korzystający z poziomu bezpłatnego Google Cloud Platform mogą przejść na płatne konto?
- Program poziomu bezpłatnego Google Cloud Platform zapewnia klientom bezpłatny okres próbny z kwotą 300 USD do wykorzystania w dowolnej usłudze Google Cloud Platform (GCP), w tym interfejsach API Google Maps Platform (GMP). Po zakończeniu bezpłatnego okresu próbnego musisz przejść na płatne konto, aby nadal korzystać z tych usług. Aby przejść na konto płatne, otwórz Cloud Console.
- Czy w Google Maps Platform obowiązują limity wykorzystania?
-
Nie ma maksymalnego dziennego limitu liczby żądań, które możesz wysłać do usług Google Maps Platform. Jedyne limity wykorzystania dotyczą maksymalnej liczby zapytań na sekundę (QPS) lub zapytań na minutę (QPM).
W przypadku macierzy odległości limit jest określany w zdarzeniach na sekundę, obliczany jako suma zapytań po stronie klienta i po stronie serwera.
W przypadku Trasy:Compute Route matrix limit jest wyrażony w elementach na minutę (EPM), gdzie liczba elementów w żądaniu jest równa: (liczba punktów początkowych × liczba miejsc docelowych).
W tabeli poniżej znajdziesz limity wykorzystania poszczególnych interfejsów API.
API Limit wykorzystania Weryfikacja adresu 6000 QPM Widok z lotu ptaka: wyszukiwanie filmu 180 QPM i 100 000 QPD Widok z lotu ptaka: renderowanie filmu 100 QPM i 100 QPD Jakość powietrza 6000 QPM Trasa 3000 QPM Macierz odległości 60 000 EPM Mapy dynamiczne 30 000 QPM Wysokość 6000 QPM Geokodowanie 3000 QPM Geolokalizacja 6000 QPM Interfejs API kafelków mapy: kafelki 2D i kafelki Street View 6000 QPM i 15 000 QPD Interfejs API kafelków mapy: fotorealistyczne kafelki 3D 300 QPD Interfejs API kafelków mapy: fotorealistyczne kafelki 3D: mechanizm renderowania 12 000 QPM Miejsca 6000 QPM Pyłek 6000 QPM Drogi 30 000 QPM Trasy: trasy obliczeniowe 3000 QPM Trasy: macierz tras Compute 3000 EPM Panele słoneczne 600 QPM Mapy statyczne 30 000 QPM Street View Image API 30 000 QPM Strefa czasowa 30 000 QPM Aby zarządzać wydatkami, możesz monitorować wykorzystanie interfejsu API i ustawić limity dzienne dla wszystkich żądań wysyłanych do dowolnego rozliczanego interfejsu API.
Usługi Google Maps Platform muszą być wdrażane zgodnie ze standardowymi Warunkami korzystania z usługi Google Maps Platform.
- Jak jest obliczany koszt wykorzystania?
-
Omówienie cen usług Google Maps Platform znajdziesz w cenniku.
Więcej informacji o opłatach za interfejsy API Google Maps Platform znajdziesz w opisie rozliczeń za Mapy, trasy, miejsca i środowisko.
- Jak są liczone wczytania map w Google Maps Platform?
-
Opłata zostanie naliczona za pojedyncze wczytanie mapy, jeśli:
- Strona internetowa lub aplikacja wyświetla mapę za pomocą interfejsu Maps JavaScript API.
- Aplikacja żąda pojedynczego obrazu mapy z interfejsu Maps Static API.
Opłaty za panoramy Street View są naliczane oddzielnie od załadowań mapy:
- Za każde żądanie do interfejsu Street View Static API, by umieścić statyczną (nieinteraktywną) panoramę Street View obciążamy statyczną panoramę Street View.
- Opłata za dynamiczną panoramę Street View jest naliczana za każde wystąpienie obiektu panoramy w interfejsie Maps JavaScript API, pakiecie Maps SDK na Androida lub Maps SDK na iOS.
Gdy strona internetowa lub aplikacja wczytuje mapę, statyczny obraz mapy lub panoramę Street View, wszelkie działania użytkownika, takie jak przesuwanie, powiększanie czy przełączanie warstw mapy, nie powodują dodatkowych operacji wczytywania mapy ani nie wpływają na limity wykorzystania.
Dodanie znacznika nie spowoduje dodatkowych operacji wczytywania mapy, ale może spowodować naliczenie opłat związanych z ustaleniem lokalizacji pinezki (np. wczytaniem lub ponownym załadowaniem klasy „google.maps.Map()”).
- Jak monitorować wykorzystanie?
-
Wykorzystanie poszczególnych interfejsów API możesz monitorować w konsoli Google Cloud.
- Wybierz projekt zawierający interfejs API, który chcesz sprawdzić.
- Na liście interfejsów API w panelu kliknij nazwę interfejsu API.
- U góry strony kliknij Wskaźniki lub Limity.
Aby wyświetlić raport o ruchu i informacje rozliczeniowe dla całego projektu, wykonaj te czynności:
- Skonfiguruj rozliczenia, jeśli jeszcze nie zostało to zrobione.
- Otwórz stronę płatności za Cloud Console.
- Wybierz projekt.
- Na pasku bocznym po lewej stronie kliknij Raporty. Aby wyświetlić raporty na koncie rozliczeniowym, użyj filtrów na pasku bocznym po prawej stronie.
Więcej informacji znajdziesz w sekcjach Raportowanie w Google Maps Platform oraz Monitorowanie wykorzystania interfejsu API i Ograniczanie wykorzystania interfejsu API.
- Co się stanie, jeśli przekroczę limity liczby żądań (QPS)?
-
Jeśli przekroczysz limity zapytań na sekundę w danej usłudze Google Maps Platform, interfejs API zwróci komunikat o błędzie. Jeśli wielokrotnie przekraczasz limity, dostęp do interfejsu API może zostać tymczasowo zablokowany.
Jeśli przekroczysz limity zapytań żądań lub będziesz w inny sposób nadużywać usługi, żądania będą zwracać określony komunikat o błędzie. Jeśli nadal będziesz przekraczać limity, Twój dostęp do Google Maps Platform może zostać zablokowany.
Uwaga: 4 interfejsy API usług internetowych mają odpowiadające im usługi po stronie klienta dostępne w interfejsie Maps JavaScript API: Directions, Distance Matrix, Elevation i Geocoding.
Przekroczono limity wykorzystania
Jeśli przekroczysz limity wykorzystania, w odpowiedzi otrzymasz kod stanu
OVER_QUERY_LIMIT
.Oznacza to, że usługa internetowa przestanie dostarczać normalne odpowiedzi i przechodzi w tryb zwracania tylko kodu stanu
OVER_QUERY_LIMIT
do momentu, gdy ponowne wykorzystanie będzie dozwolone. Może się to zdarzyć w ciągu kilku sekund, jeśli komunikat o błędzie został wyświetlony z powodu wysyłania przez aplikację zbyt wielu żądań na sekundę.Jeśli regularnie przekraczasz limity wykorzystania zapytań na sekundę, rozważ zmniejszenie wykorzystania przez optymalizację aplikacji w taki sposób, aby efektywniej korzystać z usług Google Maps Platform. Więcej informacji znajdziesz w przewodniku po optymalizacji.
- Na mojej stronie jest duży ruch. Czy mogę korzystać z usług Google Maps Platform?
-
Tak. Zalecamy jednak zapoznanie się z limitami wykorzystania każdej z usług Google Maps Platform, z których korzysta Twoja aplikacja.
- Czy jeśli moja witryna lub aplikacja nagle stanie się popularna, moje mapy przestaną działać?
-
Jeśli po założeniu konta rozliczeniowego przekroczysz limit bezpłatnego wykorzystania w wysokości 200 USD miesięcznie, a na koncie rozliczeniowym nie będzie ważna forma płatności (karta kredytowa, przelew bankowy itp.), interfejs API przestanie działać, dopóki nie dodasz prawidłowej formy płatności.
- Jak będzie obliczane i rozliczane wykorzystanie?
-
Wykorzystanie jest obliczane na koniec każdego dnia i wycenione w cenniku. Pod koniec każdego miesiąca łączne wykorzystanie jest obciążane formą płatności powiązaną z Twoim kontem rozliczeniowym. Więcej informacji znajdziesz w artykule o płatnościach za Google Maps Platform.
- Ile kosztuje korzystanie z Google Maps Platform?
-
Omówienie kosztu interfejsu API znajdziesz w cenniku. Jeśli Twoja aplikacja generuje żądania lub obciążenie mapami do 200 USD miesięcznie, wykorzystanie nie będzie obciążane. Opłaty za wykorzystanie powyżej kwoty 200 USD miesięcznie będą obciążać Twoje konto rozliczeniowe. Więcej informacji znajdziesz w przewodniku po płatnościach za Google Maps Platform.
- Czy ceny są dostępne w innych walutach?
-
W konsoli mogą być dostępne dodatkowe waluty. Gdy wybierzesz inną walutę, stawki zostaną przeliczone z ich odpowiednika w USD podanego w arkuszu opłat.
- Skonfigurowałem(-am) płatności. Jak wyświetlić rachunek?
-
Na początku każdego miesiąca Google obciąża Cię opłatami za aktywność z poprzedniego miesiąca przy użyciu określonej formy płatności. Szczegółowe informacje o rachunku znajdziesz w przewodniku po płatnościach za Google Maps Platform.
Dodatkowe zasoby:
- Dowiedz się, jak wyświetlić historię kosztów i płatności.
- Dowiedz się, jak uzyskać fakturę lub pokwitowanie płatności.
- Dowiedz się, jak konfigurować alerty rozliczeniowe i nimi zarządzać.
- Jak zabezpieczyć się przed wysokimi kosztami w przypadku niespodziewanego wzrostu wykorzystania?
-
Google Maps Platform umożliwia ustawianie dziennych limitów żądań i maksymalnych dziennych limitów naliczanych. Możesz określić maksymalny dzienny limit wykorzystania, aby zapobiec nieoczekiwanym wzrostom. Możesz też skonfigurować alerty dotyczące budżetu tak, aby otrzymywać e-maile z powiadomieniami, gdy obciążenia na koncie rozliczeniowym osiągną ustawiony przez Ciebie próg.
Ograniczenie maksymalnego dziennego limitu rozliczanego:
Aby uniknąć dużego rachunku, możesz ustawić dzienny limit wykorzystania w celu ochrony przed nieoczekiwanym wzrostem wykorzystania. Możesz zmienić ten limit w Cloud Console, wykonując te czynności:
- Otwórz panel interfejsów API i usług.
- Jeśli pojawi się taka prośba, wybierz projekt.
- Wybierz interfejs API z listy i kliknij kartę Limity.
- Kliknij ikonę edycji obok limitu żądań dziennie.
Możesz też edytować wiele limitów dla wielu interfejsów API za pomocą panelu uprawnień i limitów administratora.
Ustawianie alertów dotyczących budżetu i zarządzanie nimi:
Skonfiguruj alerty budżetowe, aby wysyłać do administratorów płatności e-maile z powiadomieniami, gdy obciążenia na koncie rozliczeniowym osiągną wyznaczony próg. Administratorzy rozliczeń otrzymają e-maile z powiadomieniami, gdy szacunkowe obciążenia na koncie rozliczeniowym przekroczą 50%, 90% lub 100% progu.
- Otrzymuję komunikat, że mój projekt jest połączony z „kontem przeniesienia Google Maps Platform”, ale nie mam dostępu do tego konta. Co mam zrobić?
-
Konto przeniesione z Google Maps Platform zostało utworzone po to, aby ułatwić niektórym klientom przejście na nowy abonament z płatnościami według wykorzystania. To przeniesienie pozwoliło Google przyznać tym klientom jednorazowe środki, aby mogli nadal korzystać z Google Maps Platform do osiągnięcia limitu bezpłatnego poziomu o wartości 200 USD. Po przekroczeniu tego limitu konto rozliczeniowe zostanie zamknięte i utracisz dostęp do usługi. Aby uniknąć przerw w działaniu usługi, załóż własne konto rozliczeniowe i nadal korzystaj z bezpłatnego poziomu 200 USD miesięcznie. Aby zmienić konto rozliczeniowe projektu:
- Utwórz nowe konto rozliczeniowe (jeśli masz już konto rozliczeniowe, możesz pominąć ten krok).
- Powiąż konto rozliczeniowe z projektem
- Dlaczego mój limit jest ustawiony na 1 żądanie dziennie? Jak zwiększyć ten limit?
-
Jeśli nie utworzysz konta rozliczeniowego i nie dołączysz do projektu konta rozliczeniowego, liczba Twoich interfejsów API Maps Platform będzie ograniczona do 1 żądania dziennie. Możesz uzyskać większy limit, tworząc i dołączając konto rozliczeniowe. Aby to zrobić, zobacz Pierwsze kroki z Google Maps Platform.
Gdy utworzysz i dołączysz konto rozliczeniowe, Twój dzienny limit zostanie usunięty. Możesz ustawić w Cloud Console limit, który zapobiegnie nieoczekiwanym wydatkom.
- Dotarło do mnie powiadomienie o naruszeniu zasad dotyczących płatności. Jak rozwiązać ten problem?
-
Wysłaliśmy to powiadomienie, ponieważ ustaliliśmy, że Twoje konto korzysta z wielu kont rozliczeniowych. Stanowi to naruszenie warunków Google określonych w sekcji 3.2.4 Warunków korzystania z usługi Google Maps Platform. Zgodnie z tymi warunkami tworzenie wielu kont rozliczeniowych jest zabronione. Więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania dotyczące naruszeń na koncie rozliczeniowym.
Korzystanie z Google Maps Platform
- Jakich kluczy lub danych logowania mam używać w różnych usługach Map Google?
-
Za każdym razem, gdy korzystasz z usług Google Maps Platform, musisz uwzględniać klucz interfejsu API, aby zweryfikować żądanie. Usługa Google Maps Platform jest dostępna dla aplikacji na Androida, iOS, aplikacji internetowych i usług internetowych HTTP.
Klucz interfejsu API:
- Klucz interfejsu API to unikalny identyfikator, który generujesz za pomocą Cloud Console.
- Przykład wczytywania interfejsu API za pomocą klucza:
&key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo
Podpis cyfrowy:
- Podpis cyfrowy jest generowany przy użyciu tajnego klucza podpisywania adresu URL udostępnionego przez Google. Podpisy cyfrowe są używane w interfejsach Maps Static API i Street View Static API.
Ograniczenia:
- Ograniczenia kluczy interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API w celu zwiększenia bezpieczeństwa. Więcej informacji znajdziesz w artykule o sprawdzonych metodach zabezpieczania interfejsów API.
- Do klucza interfejsu API możesz dodać ograniczenie aplikacji.
Po wprowadzeniu ograniczeń klucz będzie działać tylko na platformach, które obsługują tego typu ograniczenia.
Dostępne są 4 typy ograniczeń aplikacji. Interfejsy API wymuszające ten sam typ ograniczenia mogą używać tego samego klucza z ograniczeniami.
- Adresy IP (pojedyncze serwery) do użytku z interfejsami API usług internetowych.
- Strony odsyłające HTTP (witryny internetowe) – do użycia z internetowymi interfejsami API.
- Ograniczenie aplikacji na Androida (według nazwy pakietu i odcisku cyfrowego) – do użycia z pakietem SDK Map Google na Androida.
- Ograniczenie aplikacji na iOS (według identyfikatora pakietu na iOS) – do użytku z pakietem SDK Map Google na iOS.
- Do klucza interfejsu API możesz też dodać ograniczenie interfejsu API. Więcej informacji znajdziesz w artykule o pobieraniu, dodawanie i ograniczaniu klucza interfejsu API.
W tabeli poniżej znajdziesz klucze/dane logowania i ograniczenia aplikacji dla każdego interfejsu API lub pakietu SDK Google Maps Platform.
API/SDK Ograniczenie dotyczące danych logowania i aplikacji Pakiet SDK Map Google na Androida Klucz interfejsu API z ograniczeniem dla Androida1 Pakiet SDK Miejsc na Androida Klucz interfejsu API z ograniczeniem dla Androida1 Pakiet SDK Maps 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 Interfejs API Map Tiles Klucz interfejsu API z ograniczeniem adresu IP1 Interfejs Aerial View API Klucz interfejsu API z ograniczeniem adresu IP1 Map Static API Klucz interfejsu API z ograniczeniem odsyłającym HTTP1 + podpis cyfrowy2 Street View Static API Klucz interfejsu API z ograniczeniem odsyłającym HTTP1 + podpis cyfrowy2 Interfejs Maps Embed API Klucz interfejsu API z ograniczeniem strony odsyłającej HTTP1 Address Validation API Klucz interfejsu API z ograniczeniem adresu IP1 Directions API Klucz interfejsu API z ograniczeniem adresu IP1 Distance Matrix API Klucz interfejsu API z ograniczeniem adresu IP1 Elevation API Klucz interfejsu API z ograniczeniem adresu IP1 Geocoding API Klucz interfejsu API z ograniczeniem adresu IP1 Geolocation API Klucz interfejsu API z ograniczeniem adresu IP1 Miejsca API Klucz interfejsu API z ograniczeniem adresu IP1 Interfejs Roads API Klucz interfejsu API z ograniczeniem adresu IP1 Interfejs Routes API Klucz interfejsu API z ograniczeniem adresu IP1 Time Zone API Klucz interfejsu API z ograniczeniem adresu IP1 Air Quality API Klucz interfejsu API z ograniczeniem adresu IP1 Pollen API Klucz interfejsu API z ograniczeniem adresu IP1 Solar API Klucz interfejsu API z ograniczeniem adresu IP1 1 Ograniczenia klucza interfejsu API są opcjonalne, ale zdecydowanie zalecamy ograniczenie wszystkich kluczy interfejsu API w celu zwiększenia bezpieczeństwa.2 W zależności od sposobu korzystania z Map Static API i Street View Static API może być wymagany podpis cyfrowy. Niezależnie od sposobu uwierzytelniania zdecydowanie zalecamy uwierzytelnianie żądań zarówno z użyciem klucza interfejsu API, jak i podpisu cyfrowego. - Jak zmienić typ ograniczenia klucza z strony odsyłającej HTTP na ograniczenie dotyczące adresu IP?
-
Ważne: jeśli używasz któregokolwiek z interfejsów API usług internetowych z kluczem interfejsu API, który ma ograniczenia dotyczące stron odsyłających, żądania będą kończyć się niepowodzeniem i wyświetlonym komunikatem o błędzie: „Klucze API nie mogą mieć ograniczeń dotyczących stron odsyłających, gdy są używane z tym interfejsem API”. Przełącz się na klucz interfejsu API z ograniczeniami adresów IP.
Zanim zmienisz typ ograniczenia klucza interfejsu API z odsyłającego HTTP na adres IP, sprawdź, czy wszystkie interfejsy API korzystające z klucza interfejsu API obsługują typ ograniczenia adresu IP. Interfejsy API z tym samym typem ograniczenia mogą używać tego samego klucza ograniczonego. Jeśli chcesz wymusić stosowanie więcej niż 1 ograniczenia, dodaj oddzielny klucz z wymaganym ograniczeniem. Dowiedz się, jak dodać nowy klucz interfejsu API.
Dowiedz się więcej o ograniczeniach dotyczących klucza interfejsu API związanych z usługami Google Maps Platform.
Aby zmienić klucz interfejsu API z ograniczeniem odsyłającym HTTP na ograniczenie adresu IP, wykonaj te czynności:
- Otwórz stronę Dane logowania w konsoli Google Cloud.
- Wybierz projekt zawierający klucz interfejsu API, który chcesz edytować.
- Na stronie Dane logowania na liście kluczy interfejsu API wybierz nazwę klucza interfejsu API, aby edytować jego szczegóły.
- W sekcji Ograniczenie klucza na tej stronie wybierz „Adresy IP (serwery WWW, zadania cron itp.)” i wstaw odpowiednie adresy IP serwerów, a następnie kliknij Zapisz.
- Jak uzyskać nowy klucz interfejsu API?
- Zobacz Pierwsze kroki z Google Maps Platform.
- Jak mogę znaleźć zmiany wprowadzone w poszczególnych wersjach interfejsów API Map Google?
-
Informacje o zmianach wersji wielu interfejsów API Map Google są dostępne pod tymi linkami:
- Interfejs API JavaScript Map Google
- Interfejs API Trasy
- Directions API
- Distance Matrix API
- Pakiet SDK Map Google na Androida
- Pakiet SDK Miejsc Google na Androida
- Pakiet SDK Map Google na iOS
- Pakiet SDK Miejsc Google na iOS
- Adres API do weryfikacji adresów
- Aerial View API
- Air Quality API
- Pollen API
- Solar API
- Interfejs API Map Tiles
Za pomocą narzędzia do śledzenia problemów Google Maps Platform możesz też sprawdzić, w której wersji Google Maps Platform wystąpił dany błąd i został on naprawiony:
- Jak asynchronicznie wczytać interfejs API na stronie po jej załadowaniu?
-
Wystarczy, że podczas wczytywania interfejsu API określisz parametr wywołania zwrotnego. Więcej informacji i przykładowy kod znajdziesz w rozdziale Pierwsze kroki dokumentacji interfejsu Maps JavaScript API.
- Co zrobić, aby usługi Google Maps Platform wyświetlały się w języku innym niż angielski?
-
Domyślnie interfejs API spróbuje wczytać najbardziej odpowiedni język na podstawie lokalizacji użytkownika lub ustawień przeglądarki. Niektóre interfejsy API umożliwiają jawne ustawienie języka podczas wysyłania żądania. Więcej informacji o ustawianiu języka znajdziesz w dokumentacji poszczególnych interfejsów API:
- Interfejs API JavaScript Map Google
- Geocoding API
- Interfejs API Trasy
- Directions API
- Distance Matrix API
- Places API,
- Statyczny interfejs API Map Google
Google często aktualizuje obsługiwane języki. Ta lista może nie być pełna i może ulec zmianie.
Kod języka Język Kod języka Język af afrikaans ja japoński sq albański kn kannada AM amharski kk kazachski ar arabski km khmerski hy ormiański ko koreański az azerski ky kirgiski eu baskijski lo laotański be Białoruski lv łotewski bn bengalski lt litewski bs bośniacki mk Macedoński bg bułgarski ms malajski my birmański ml malajalam ca kataloński mr marathi zh chiński mn mongolski zh-CN chiński (uproszczony) ne nepalski zh-HK chiński (Hongkong) nie norweski zh-TW chiński (tradycyjny) pl polski godz. chorwacki pt portugalski cs czeski pt-BR portugalski (Brazylia) da duński pt-PT portugalski (Portugalia) nl niderlandzki pa pendżabski angielski angielski ro rumuński en-AU angielski (Australia) ru rosyjski en-GB angielski (Wielka Brytania) sr serbski et estoński si syngaleski fa perski sk słowacki fi fiński sl słoweński fil filipiński es hiszpański fr francuski es-419 hiszpański (Ameryka Łacińska) fr-CA Francuski (Kanada) sw suahili gl galicyjski sv szwedzki ka gruziński ta tamilski de niemiecki te telugu el grecki th tajski gu gudżarati tr turecki iw hebrajski uk ukraiński hej hindi ur urdu hu węgierski uz uzbecki jest islandzki vi wietnamski id indonezyjski zu zulu włoski włoski W tej przykładowej aplikacji możesz zobaczyć, jak będzie wyglądać mapa w dowolnym z wymienionych wyżej języków.
- Czy do Google Maps Platform można uzyskać dostęp przez protokół SSL (HTTPS)?
-
Dostęp do interfejsów Maps JavaScript API, Maps Static API i interfejsów API usługi internetowej można uzyskać przez bezpieczne połączenia (HTTPS). Informacje o tym, jak uzyskać do niego dostęp przez SSL, znajdziesz w dokumentacji interfejsu API.
Pamiętaj, że Maps Static API nie obsługuje adresów URL niestandardowych ikon, które korzystają z HTTPS. Wyświetlana jest ikona domyślna.
- Jak zgłosić błąd lub poprosić o dodanie nowej funkcji w Google Maps Platform?
-
Jeśli zauważysz zachowanie, które Twoim zdaniem może być wynikiem błędu, zgłoś je na odpowiednim forum. Dzięki temu inni deweloperzy będą mogli zweryfikować błąd i wyeliminować potencjalne problemy z kodem.
Jeśli chcesz poprosić o dodanie funkcji, najpierw zgłoś ją na odpowiednim forum, aby upewnić się, że nie ma jeszcze rozwiązania, które spełnia Twoje wymagania.
Po potwierdzeniu, że wykryliśmy nowy błąd lub że obecne funkcje usług Google Maps Platform nie spełniają Twoich wymagań, zgłoś błąd lub prośbę o funkcję za pomocą narzędzia do śledzenia problemów z Google Maps Platform.
Zanim dodasz do narzędzia Issue Tracker błąd lub prośbę o dodanie funkcji, sprawdź, czy dany błąd lub funkcja nie zostały jeszcze dodane. Jeśli tak, możesz oznaczyć problem gwiazdką, aby zarejestrować się i otrzymywać powiadomienia o aktualizacjach.
-
Pakiet Maps SDK na Androida i Maps SDK na iOS używa plików cookie zgodnie z Polityką prywatności Google, np. obliczaniem liczby aktywnych użytkowników w ciągu doby i ostatnich 7 dni oraz zapobieganiem nadużyciom w zakresie usług. Te pliki cookie nie są powiązane z żadnym kontem Google, na które się zalogowano, ani rejestrowane wraz z pozostałymi informacjami zebranymi z wywołań interfejsu API.
- Nie mogę znaleźć odpowiedzi na moje pytanie. Z kim mogę się skontaktować?
-
Zespół Google ds. relacji z deweloperami jest obecny na stronie Stack Overflow – edytowanej we współpracy witryny z pytaniami i odpowiedziami dla programistów. To także świetne miejsce na pytania techniczne dotyczące tworzenia i obsługi aplikacji Map Google. Więcej informacji o zadawaniem pytań na Stack Overflow znajdziesz na stronie pomocy.
Pamiętaj o tych kwestiach:
- Przeszukaj bieżące dyskusje. Możliwe, że ktoś inny miał podobny problem i znajdował rozwiązanie.
- Jeśli to możliwe, prześlij link do swojej witryny. Kody należy publikować tylko wtedy, gdy nie można ich łatwo wyświetlić online.
- Podaj wszystkie istotne informacje, w tym wersje przeglądarki, błędy i wszystkie inne informacje, które mogą pomóc w rozwiązaniu problemu.
Błędy i rozwiązywanie problemów
- Co oznacza ten błąd?
-
Jeśli podczas wczytywania lub uruchamiania interfejsów API Map Google wystąpi błąd, wyjaśnienia dotyczące kodów błędów znajdziesz tutaj:
- Interfejs API JavaScript Map Google
- Statyczny interfejs API Map Google
- Statyczny interfejs API Street View
- Interfejs Maps Embed API
- Interfejs Elevation API
- Geocoding API
- Interfejs API geolokalizacji
- Interfejs API Trasy
- Directions API
- Distance Matrix API
- Interfejs Roads API
- Time Zone API
- Places API,
- Adres API do weryfikacji adresów
- Moje mapy są ciemniejsze niż zwykle. Co tu się odbywa?
-
W niektórych przypadkach może się wyświetlać zaciemniona mapa lub „negatywne” zdjęcie Street View ze znakiem wodnym z tekstem „tylko do celów programistycznych”. Zwykle oznacza to problemy z kluczem interfejsu API lub płatnościami. Aby korzystać z usług Google Maps Platform, musisz mieć konto rozliczeniowe, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Oto instrukcje, które pomogą Ci rozwiązać ten problem:
-
Jak naprawić kody błędów:
OVER_DAILY_LIMIT
lubOVER_QUERY_LIMIT
? - Te kody błędów mogą zostać zwrócone z dowolnego z tych powodów:
- W żądaniu brakuje klucza interfejsu API.
- Podany klucz interfejsu API jest nieprawidłowy.
- Projekt nie ma dołączonego konta rozliczeniowego.
- Przekroczono ustawiony samodzielnie limit wykorzystania.
- Podana forma płatności nie jest już ważna (np. karta kredytowa straciła ważność).
- Przekroczono limit zapytań na sekundę dla danego interfejsu API.
Aby korzystać z usług Google Maps Platform, musisz mieć konto rozliczeniowe, a wszystkie żądania muszą zawierać prawidłowy klucz interfejsu API. Aby rozwiązać ten problem:
- Skonfiguruj konto rozliczeniowe
- Uzyskiwanie nowego klucza interfejsu API
- Dostosuj limit wykorzystania, aby zwiększyć limit dzienny (jeśli dotyczy).
-
Jak naprawić kody błędów:
kGMSPlacesRateLimitExceeded
lub9005 PLACES_API_RATE_LIMIT_EXCEEDED
? - Jeśli widzisz wartość
kGMSPlacesRateLimitExceeded
lub9005 PLACES_API_RATE_LIMIT_EXCEEDED
, być może używasz wycofanej wersji pakietu Miejsca SDK na Androida lub pakietu Miejsca SDK na iOS. Więcej informacji i opis nowych pakietów SDK znajdziesz na stronie https://goo.gle/places-sdk-deprecation. - Jak naprawić błąd „Ten adres IP, ta witryna lub aplikacja mobilna nie ma uprawnień do korzystania z tego klucza interfejsu API”?
-
Ten błąd może wystąpić w różnych sytuacjach:
- W kluczu interfejsu API masz włączone ograniczenia dotyczące adresów IP (serwerów), a nieautoryzowany adres IP próbuje wysłać żądanie.
- W kluczu interfejsu API masz włączone ograniczenia dotyczące stron odsyłających HTTP (witryny), a nieupoważniona strona odsyłająca próbuje wykonać żądanie.
- Ograniczasz dostęp do swoich aplikacji na Androida, ustawiając nazwę pakietu i odcisk palca, a nieupoważniona aplikacja na Androida próbuje wysłać żądanie.
- Ograniczasz żądania wysyłane przez aplikacje na iOS, podając identyfikatory pakietów i używając nierozpoznanej aplikacji na iOS wysyłającej żądanie.
- Wcześniej ten błąd mógł się pojawiać, jeśli używany był którykolwiek z interfejsów API usługi internetowej z kluczem interfejsu API z ograniczeniami dotyczącymi stron odsyłających HTTP. Żądania wysyłane do tych interfejsów API powinny być identyfikowane za pomocą klucza interfejsu API z ograniczeniami dotyczącymi adresu IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP. Więcej informacji o ograniczaniu kluczy interfejsu API znajdziesz w opisie sprawdzonych metod dotyczących kluczy interfejsu API.
Wyświetlanie i edytowanie danych logowania klucza interfejsu API
Aby wyświetlić klucze interfejsu API i zarządzać ograniczeniami, wykonaj te czynności:
- Otwórz stronę Dane logowania w konsoli Google Cloud.
- Wybierz projekt zawierający klucz interfejsu API, który chcesz sprawdzić.
- Aby wyświetlić szczegóły danych logowania, w tym wszelkie ograniczenia ustawione dla klucza, na liście kluczy interfejsu API kliknij nazwę klucza.
- Wyświetlą się pełne dane logowania wybranego klucza interfejsu API, w tym wszystkie ograniczenia skonfigurowane dla tego klucza. W tym miejscu możesz zmienić, usunąć lub zaktualizować ograniczenia.
- Jak naprawić błąd: „Klucze interfejsu API z ograniczeniami dotyczącymi stron odsyłających nie mogą być używane z tym interfejsem API”?
-
Używasz dowolnych interfejsów API usługi internetowej z kluczem interfejsu API ograniczonym do strony odsyłającej HTTP. Ze względów bezpieczeństwa interfejsy API usług internetowych muszą używać kluczy API ograniczonych do adresów IP. Zmień typ ograniczenia klucza z ograniczenia strony odsyłającej HTTP na ograniczenie adresu IP lub utwórz nowy klucz interfejsu API, jeśli Twój klucz jest już używany z interfejsem Maps JavaScript API.
Usługi Google Maps Platform
- Muszę przekonwertować adresy na pary szerokości i długości geograficznej. Czy mogę to zrobić za pomocą Google Maps Platform?
-
Tak. Ten proces nazywa się „geokodowaniem”. Interfejs Maps JavaScript API zawiera klasę do wykonywania usługi geokodowania. Klasa to: google.maps.Geocoder.
Google udostępnia też interfejs Geocoding API, który udostępnia interfejs REST umożliwiający odpowiadanie w formatach JSON i XML.
- W jakich krajach działa geokodowanie?
-
Listę krajów obecnie obsługiwanych przez geokodery Google Maps Platform znajdziesz w danych o zasięgu w Mapach Google.
Dokładność geokodowanych lokalizacji może się różnić w zależności od kraju, dlatego zalecamy skorzystanie z zwróconego pola location_type, aby sprawdzić, czy znaleziono wystarczająco dobre dopasowanie na potrzeby Twojej aplikacji. Pamiętaj, że dostępność danych geokodowania zależy od umów z dostawcami danych, więc może ulec zmianie.
- Dlaczego geokodery Google Maps Platform podają inne lokalizacje niż Mapy Google?
-
Geokoder interfejsu API i geokoder Map Google czasami korzystają z różnych zbiorów danych (w zależności od kraju). Geokoder interfejsu API jest co jakiś czas aktualizowany o nowe dane, więc z czasem wyniki mogą się zmieniać lub poprawiać.
- Jak mam sformatować zapytania geokodera, aby zmaksymalizować liczbę udanych żądań?
-
Geokoder służy do mapowania adresów z ulic na współrzędne geograficzne. Z tego względu, aby zmaksymalizować prawdopodobieństwo pomyślnego zapytania, zalecamy formatowanie żądań geokodera zgodnie z tymi wytycznymi:
- Podaj adresy zgodnie z formatem używanym przez krajowy urząd pocztowy w danym kraju.
-
Nie podawaj dodatkowych elementów adresu, takich jak nazwy firm, numery budynków, numery pięter czy numery lokali, które nie znajdują się w adresie określonym przez urząd pocztowy w danym kraju.
Może to spowodować otrzymanie odpowiedzi z atrybutem
ZERO_RESULTS
. -
Sformatuj kody plus w ten sposób (znaki plusa zawierają zmianę znaczenia w adresie URL
%2B
, a spacje – do%20
):- Kod globalny to 4-znakowy numer kierunkowy i co najmniej 6-znakowy kod lokalny (849VCWC8+R9 to
849VCWC8%2BR9
). - kod złożony to co najmniej 6-znakowy kod lokalny z konkretną lokalizacją (CWC8+R9 Mountain View, CA, USA to
CWC8%2BR9%20Mountain%20View%20CA%20USA
).
- Kod globalny to 4-znakowy numer kierunkowy i co najmniej 6-znakowy kod lokalny (849VCWC8+R9 to
- W miarę możliwości używaj numeru budynku, a nie jego nazwy.
- W miarę możliwości stosuj adresowanie numeru domu, a nie przecznice.
- Nie podawaj podpowiedzi, takich jak punkty orientacyjne w pobliżu.
- Jak sformatować adres w USA na autostradzie numerowanej na potrzeby geokodowania?
-
Geokoder Google Maps Platform wymaga określenia adresów dróg numerowanych w Stanach Zjednoczonych w następujących adresach:
-
Drogi regionalne:
"Co Road NNN"
, gdzie NNN to numer drogi, np."Co Road 82"
-
Drogi stanowe:
"State NNN"
, gdzie Stan to pełna nazwa stanu, a NNN to numer drogi, np."California 82"
-
Drogi w Stanach Zjednoczonych:
"U.S. NNN"
, gdzie NNN to numer drogi. np."U.S. 101"
-
Międzystanowe w Stanach Zjednoczonych:
"Interstate NNN"
, gdzie NNN to numer międzystanowy, np."Interstate 280"
-
Drogi regionalne:
- Kiedy należy używać klasy geokodera interfejsów API, a kiedy usługi HTTP Geocoding Service?
-
Zapoznaj się z dokumentem Geocoding Strategies (Strategie geokodowania), w którym szczegółowo opisujemy zalety i wady różnych strategii geokodowania.
- Jak udostępnić wskazówki dojazdu za pomocą Google Maps Platform?
-
Usługa Compute Routes dla Routes API oraz Directions API umożliwiają podawanie wskazówek dojazdu w przypadku podróży jednoetapowych i wieloetapowych. Opcje wyznaczania trasy pomagają w wyznaczaniu wskazówek dojazdu z użyciem trybu podróży (samochodu), pojedynczej trasy lub zestawu tras oraz ograniczeń (bez dróg płatnych). Usługi te są dostępne w tych formach:
- Interfejs żądań/odpowiedzi HTTP (używany w aplikacjach mobilnych i innych) jest zgodny z pakietem SDK Map Google na Androida i innymi usługami internetowymi Map Google.
- JavaScript API (na potrzeby aplikacji po stronie klienta) umożliwia podawanie wskazówek dojazdu za pomocą klasy google.maps.DirectionsService. Klasa DirectionsRenderer może automatycznie utworzyć za Ciebie nakładki i panel wskazówek dojazdu. Dodatkowe przykłady znajdziesz w dokumentacji.
- Interfejsy klienta Java, Python, go i Node.js w przypadku aplikacji po stronie serwera zapewniają te same funkcje. Więcej informacji o bibliotekach klienta znajdziesz w artykule o bibliotekach klienta interfejsu Directions API.
- W jakich krajach dostępne są wskazówki dojazdu?
-
Aby zobaczyć kraje, w których obecnie dostępne są wskazówki dojazdu w Google Maps Platform, zapoznaj się z danymi o zasięgu Map Google. Pamiętaj, że dostępność danych o trasach dojazdu zależy od naszych umów z dostawcami danych i może ulec zmianie.
- W jakich krajach są dostępne wskazówki dojazdu transportem publicznym?
-
Interfejs Directions API i Distance Matrix API obsługują wszystkich partnerów Transportu publicznego Google, z wyjątkiem tych w Japonii.
- Które funkcje plików KML i GeoRSS są obsługiwane przez interfejs Maps JavaScript API?
-
Klasa KmlLayer w interfejsie Maps JavaScript API umożliwia programistom nakładanie plików KML/KMZ i GeoRSS na mapę. Dokumentację i przykłady znajdziesz tutaj.
- Jakie są limity rozmiaru i złożoności pliku KML, które można wyświetlić za pomocą klasy KmlLayer w interfejsie Maps JavaScript API?
-
Limity rozmiaru i złożoności wyświetlania pliku KML przy użyciu klasy
KmlLayer
zostały opisane tutaj. - Jak renderować na mapie pliki KML przechowywane w witrynach intranetowych?
-
Klasa
KmlLayer
, która generuje nakładki KML w interfejsie Maps JavaScript API, korzysta z hostowanej przez Google usługi do pobierania i analizowania plików KML na potrzeby renderowania. Nie można więc wyświetlać plików KML, które nie są hostowane pod adresem URL dostępnym publicznie lub wymagające uwierzytelnienia.Jeśli chcesz tworzyć aplikacje, które korzystają z plików KML hostowanych w witrynach intranetowych, zalecamy wyrenderowanie pliku KML po stronie klienta przy użyciu bibliotek JavaScript innych firm. Plik KML jest analizowany przez przeglądarkę, dlatego wydajność może być niższa niż przy użyciu klasy
KmlLayer
. - Jaka jest maksymalna liczba znaczników lub wierzchołków ścieżek obsługiwanych przez Maps Static API?
-
Nie ma ograniczeń co do liczby znaczników ani wierzchołków ścieżek obsługiwanych przez interfejs Maps Static API. Gdy używasz ikon niestandardowych, możesz określić do 5 unikalnych ikon na żądanie, ale każdej z nich możesz używać wiele razy w mapie.
Adresy URL statycznego interfejsu API Map Google mogą zawierać maksymalnie około 8192 znaków, co ogranicza liczbę znaczników i wierzchołków ścieżek, które można określić z uwzględnieniem liczby miejsc po przecinku używanych podczas określania każdej pary szerokości i długości geograficznej. Informacje o tym, jak liczba używanych miejsc po przecinku wpływa na dokładność na Ziemi, znajdziesz w artykule w Wikipedii o stopniach dziesiętnych.
- Dlaczego w niektórych krajach nie mam dostępu do usług Google Maps Platform?
-
Interfejsów API Map Google nie można używać na terytoriach objętych zakazem. Zapoznaj się też z Warunkami korzystania z usługi.
- Jak zgłosić problem na mapie bazowej Google?
-
Prześlij opinię w Mapach Google, jeśli brakuje błędnych lub brakujących informacji na mapie, takich jak:
- nieprawidłowe adresy lub błędne lokalizacje znaczników.
- nieprawidłowe nazwy dróg,
- nieprawidłowe informacje o drodze jedno- lub dwukierunkowej,
- drogę przebiegającą nieprawidłowo,
- zamknięte drogi,
- nieistniejące drogi,
Jeśli chcesz poprawić informacje o miejscu lub firmie, zaproponuj zmianę.
Jeśli treści z Map muszą zostać usunięte ze względów prawnych, prześlij żądanie prawne.
W przypadku krytycznych lub pilnych zgłoszeń wyślij zgłoszenie do zespołu pomocy, podając szczegółowe informacje o tym, co należy naprawić.
Niektóre funkcje po stronie klienta służą do zgłaszania powodzenia lub niepowodzenia przy obliczaniu docelowego poziomu usług.
Te informacje są wysyłane do Google na adres maps.googleapis.com/maps_api_js_slo/log
w wywołaniach, które rejestrują informacje o docelowym poziomie usług.
Te informacje obejmują stan powodzenia, czas oczekiwania i wersję/kanał interfejsu Maps JavaScript API.
Aby zwiększyć wydajność, wywołania mogą być grupowane.
Aby mieć pewność, że te połączenia nie są blokowane na poziomie przeglądarki, może być konieczne pozwolenie na maps.googleapis.com
w Content Security Policy.
Na przykład: Content-Security-Policy: default-src 'self' maps.googleapis.com;
z nagłówkami HTTP lub <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;">
z metatagami HTML.
Maps JavaScript API
- Jak długo będzie działać interfejs Maps JavaScript API po załadowaniu?
-
Musisz odświeżać stronę, która wczytuje interfejs Maps JavaScript API co najmniej raz na 5 dni.
Google Maps SDK na iOS
-
Jak usunąć błąd
kGMSPlacesRateLimitExceeded
? - Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Miejsca SDK na iOS. Pakiet SDK Miejsc na iOS w wersji 2.7.0 został wyłączony i nie jest już dostępny. Jak najszybciej zaktualizuj aplikację do najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.
- Występują awarie podczas debugowania urządzenia z iOS 8.x. Co mam zrobić?
-
Jeśli podczas debugowania na urządzeniach z systemem iOS 8.x wystąpią problemy, wykonaj te czynności, aby wyłączyć przechwytywanie klatek przez GPU w używanym schemacie XCode:
- W XCode wybierz Produkt, Schemat, Zarządzaj schematami.
- Wybierz schemat i kliknij Edytuj...
- Ustaw opcję GPU Frame Capture na Wyłączono. Pamiętaj, że w przypadku niektórych urządzeń ta opcja może nie być dostępna.
- Jaki wpływ mają zaokrąglone i szersze ekrany na pakiet SDK Map Google na iOS?
-
Od iPhone X iPhone'y mają kształt ekranu z zaokrąglonymi rogami, wycięciem u góry obudowy czujnika oraz u dołu ekranu wskaźnik umożliwiający dostęp do ekranu głównego. W pakiecie SDK iOS 11.0 firma Apple dodała interfejs Safe Area API, dzięki któremu deweloperzy mogą umieszczać elementy w obszarze, od którego nowy kształt ekranu nie zostanie przycięty.
Pakiet SDK Map Google na iOS ma wiele elementów wizualnych i elementów sterujących, takich jak selektor wewnętrzny i link do zgłaszania problemów. W wersji 2.4 nowy kształt ekranu można teraz przyciąć. W trybie poziomym selektor podłóg wewnętrznych może być przycięty przez wcięcie lub wskaźnik przycisku ekranu głównego.
W wersji 2.5 pakietu SDK Map Google na iOS te problemy z układem są automatycznie naprawiane. Jeśli używasz aplikacji na iPhonie X lub nowszym, dopełnienie w GMSMapView i GMSPanoramaView jest zwiększane, aby elementy wizualne nie były przycinane.
Domyślnie zawsze bierzemy pod uwagę dopełnienie. Pakiet SDK Map Google na iOS zakłada, że dopełnienie ma na celu wypełnienie bezpiecznego obszaru. Jeśli projektujesz interfejs z założeniem, że wszystkie elementy znajdują się w bezpiecznym obszarze, nie trzeba będzie robić nic więcej.
Jeśli masz interfejs, który nie działa z naszym dostosowaniem domyślnym, wprowadziliśmy w widoku GMSMapView nową właściwość o nazwie paddingAdjustBehavior. Widok GMSMapView umożliwia teraz wybór jednego z trzech typów dostosowań dopełnienia: „Zawsze” (domyślnie), „Automatycznie” i „Nigdy”.
Jeśli widok GMSMapView jest skonfigurowany tak, aby używać dopełnienia „Zawsze”, zawsze dodaje do dopełnienia bezpiecznego obszaru. Pozwala to zaprojektować interfejs z założeniem, że wszystkie miejsca docelowe będą znajdowały się od krawędzi bezpiecznego obszaru. jest to wartość domyślna
Jeśli widok GMSMapView jest skonfigurowany pod kątem używania automatycznego dopełnienia, zawsze wybiera większe dopełnienie lub wstawienie bezpiecznego obszaru. W ten sposób możesz dodać dopełnienie od krawędzi ekranu, a jednocześnie mieć pewność, że wszystkie elementy pozostaną w bezpiecznym obszarze.
Jeśli widok GMSMapView jest skonfigurowany tak, aby używać dopełnienia „Never” (Nigdy), nigdy nie dodaje do dopełnienia bezpiecznego obszaru. Tak wygląda sytuacja sprzed wersji 2.5 i może być przydatna, jeśli dopełnienie uwzględnia już bezpieczny obszar lub jeśli inne nasze działania nie działają dobrze z Twoim interfejsem. Twoim obowiązkiem jest dopilnowanie, aby logo Google i informacje o prawach autorskich były zawsze widoczne, zgodnie z Warunkami korzystania z usługi Google Maps Platform.
Natomiast GMSPanoramaView nie ma opcjonalnej właściwości dopełnienia. Oznacza to, że nie można dostosować dopełnienia, a GMSPanoramaView zawsze stosuje potrzebne dopełnienie, aby wszystkie elementy wizualne znajdowały się w bezpiecznym obszarze.
Google Maps SDK na Androida
-
Jak usunąć błąd
9005 PLACES_API_RATE_LIMIT_EXCEEDED
? - Jeśli widzisz ten błąd, być może używasz wycofanej wersji pakietu Miejsca SDK na Androida. Wersja pakietu Miejsc SDK na Androida w Usługach Google Play została wyłączona i nie jest już dostępna. Jak najszybciej zaktualizuj aplikację do najnowszej wersji. Szczegółowe informacje znajdziesz w przewodniku po migracji.
- Moja aplikacja zamiast mapy wyświetla tylko puste szare kafelki. Jak rozwiązać ten problem?
-
Częstym powodem, dla którego zamiast mapy są puste, szare kafelki, są problemy z uwierzytelnianiem. Aby rozwiązać te problemy, wykonaj czynności opisane poniżej za pomocą narzędzia adb logcat.
- Upewnij się, że masz zainstalowane narzędzie adb. Jeśli nie, postępuj zgodnie z instrukcjami z tego przewodnika.
- Zainstaluj aplikację, która pokazuje problem, na urządzeniu lub w emulatorze Androida. Jeśli używasz emulatora Androida, upewnij się, że w jego ustawieniach znajduje się Sklep Play.
- W terminalu Android Studio uruchom
adb logcat -e "Google Maps Android API"
. Spowoduje to wydrukowanie tylko tych wierszy, w których komunikat logu pasuje do „Google Maps Android API” (opcjonalnie możesz wyeksportować dziennik do pliku tekstowego, dołączając: > logcat.txt). - Odtwórz błąd na urządzeniu i sprawdź, czy nie występują typowe błędy, takie jak:
- W pliku manifestu znajduje się odwołanie do nieprawidłowego lub niezamierzonego klucza interfejsu API.
- W projekcie nie włączono płatności.
- Pakiet SDK nie jest włączony w interfejsach API projektu.
- Do ograniczeń klucza interfejsu API jest dodawany nieprawidłowy odcisk cyfrowy SHA1.
- Plik
build.gradle
nie zawiera zależności usług Google Play.
Podpisywanie URL
- Czy można podpisywać adresy URL za pomocą języka JavaScript?
-
Zdecydowanie odradzamy podpisywanie adresów URL za pomocą JavaScriptu, ponieważ spowodowałoby to ujawnienie użytkownikom tajnego klucza podpisywania URL-a. Dlatego podpisy powinny być generowane tylko przez komponenty po stronie serwera.
- Dlaczego na moje żądania usługi internetowej interfejsu API Map Google otrzymujesz odpowiedź HTTP 403 „Forbidden”?
-
Odpowiedź HTTP 403 wskazuje problem z uprawnieniami, prawdopodobnie dlatego, że nie można było zweryfikować podpisu dla tego żądania. Możliwe przyczyny:
- Podpis został określony, ale w przypadku tego żądania jest nieprawidłowy.
- Żądanie określa klucz interfejsu API abonamentu Google Maps Platform Premium, ale nie określa podpisu, a wywoływana usługa wymaga, aby żądania wysyłane z użyciem klucza interfejsu API zawierały prawidłowy podpis.
- Podpis został określony, ale nie określono powiązanego klucza interfejsu API abonamentu Google Maps Platform Premium.