Pomoc / Mapa ogrodu / Zdjęcia satelitarne Google Szukaj w pomocy

Zdjęcia satelitarne Google

Yardstick nanosi mapę ogrodu na bezpłatne zdjęcie lotnicze ze źródeł rządowych. Aby korzystać ze zdjęć Google, które zwykle są wyraźniejsze i nowsze, trzeba podać własny klucz Google. Ten poradnik prowadzi przez cały proces, w tym dwa etapy, które najczęściej sprawiają trudność.

Gdzie znaleźć Ustawienia › Obrazy mapy
To nie jest konieczne Domyślnym źródłem jest USGS/NAIP: zdjęcia całych Stanów Zjednoczonych należące do domeny publicznej, bez klucza, konta i konfiguracji. Zwykle mają rok lub dwa lata, a ich rozdzielczość wynosi około 0,6 metra na piksel. To prawdziwe zdjęcia lotnicze, nie obraz zastępczy. Google to opcjonalne ulepszenie, a wybór źródła nie wpływa na żadne inne funkcje Yardstick.

Najpierw uwaga na pułapkę

Google udostępnia obecnie bezpłatny klucz bez konieczności podawania karty kredytowej, nazwany Maps Demo Key. Jest rzeczywiście bezpłatny i rzeczywiście nie działa z Yardstick. Niemal wszyscy się na to nabierają, dlatego warto poznać przyczynę jeszcze przed rozpoczęciem konfiguracji.

Yardstick korzysta z Map Tiles API, aby wyświetlać wyraźne zdjęcia w wysokiej rozdzielczości, oraz z Maps Static API jako rozwiązania awaryjnego. Należy włączyć oba interfejsy API w projekcie i zezwolić na korzystanie z obu w ustawieniach klucza. Od wersji Yardstick 1.1.10 klucz z dostępem wyłącznie do Maps Static nadal pozwala wyświetlić zdjęcie w niższej rozdzielczości. Sam widok zdjęcia nie dowodzi więc, że kafelki są włączone. Jeśli przy powiększaniu zdjęcie staje się rozmyte, należy zgodnie z poniższymi krokami sprawdzić zarówno interfejsy API włączone w projekcie, jak i ograniczenia interfejsów API dla klucza. Rozliczenia muszą być włączone w tym samym projekcie, do którego należy klucz.

Po wklejeniu klucza demonstracyjnego do Yardstick mapa nadal będzie wyświetlać zdjęcie USGS. Yardstick poinformuje, że klucz nie zwrócił zdjęć, ale istotny jest powód odmowy po stronie Google. Rozwiązanie jest zawsze takie samo: połączyć projekt z kontem rozliczeniowym.

Instrukcja krok po kroku

  • Uzyskać klucz

    Przejść do Google Maps Platform i utworzyć klucz demonstracyjny. Na tym etapie karta nie jest potrzebna. To dobry punkt wyjścia, choć klucz jeszcze nie będzie działać.

Strona Google Maps Platform z nagłówkiem „Zacznij tworzyć bez barier” i panelem Maps Demo Key zawierającym przykładowy klucz API oraz przycisk Kopiuj klucz.
Krok 1. Strona Maps Demo Key firmy Google. Widoczny klucz to przykład udostępniony przez Google, a nie prawdziwy klucz.
  • Przeczytać drobny druk, a następnie nacisnąć Uaktualnij konto

    Google udostępnia klucz i od razu zaznacza, że służy on wyłącznie do testów. To zdanie wyjaśnia, dlaczego klucz nie pozwala wyświetlić zdjęcia ogrodu. Rozwiązaniem jest znajdujący się obok link Uaktualnij konto.

Okno Google Cloud z nagłówkiem „Oto klucz Maps Demo Key”, kluczem w polu, tekstem „Ten klucz jest przeznaczony wyłącznie do testów, ale konto można uaktualnić, gdy wszystko będzie gotowe do użytku produkcyjnego” i linkiem Uaktualnij konto.
Krok 2. „Ten klucz jest przeznaczony wyłącznie do testów”. Google samo wskazuje cały problem. Klucz widoczny na tym zdjęciu został już usunięty.
  • Uaktualnić konto

    Google wyjaśnia, co się zmieni: projekt uzyska dostęp do wszystkich interfejsów API usługi Maps, dotychczasowy klucz zachowa ważność, a opłaty będą naliczane według zużycia, z miesięcznym bezpłatnym limitem. Szczegóły znajdują się poniżej w części dotyczącej cen.

Okno Google z nagłówkiem „Gotowość do uruchomienia”, punktami „Dostęp do wszystkich interfejsów API GMP”, „Bez przerw, zachowaj obecny klucz” i „Do 10k bezpłatnych wywołań na produkt miesięcznie” oraz przyciskami Zamknij i Uaktualnij.
Krok 3. Warto zwrócić uwagę na „Zachowaj obecny klucz”. Nie trzeba zaczynać od nowa.
  • Połączyć projekt z kontem rozliczeniowym

    Jeśli konto rozliczeniowe już istnieje, wybrać je. W przeciwnym razie Google przeprowadzi przez jego tworzenie i poprosi o dane karty. Nie da się tego ominąć: Google wymaga włączenia rozliczeń w każdym projekcie korzystającym ze zdjęć potrzebnych Yardstick. Google nalicza opłaty według zużycia; szczegóły znajdują się poniżej w części dotyczącej cen.

Okno Google z nagłówkiem „Ustaw konto rozliczeniowe dla projektu”, listą rozwijaną Konto rozliczeniowe i przyciskiem Ustaw konto.
Krok 4. Wybór konta rozliczeniowego. Utworzenie go na tym etapie wymaga przejścia przez kilka kolejnych ekranów i podania danych karty.
  • Pozwolić Google włączyć interfejsy API

    Po zakończeniu uaktualniania Google ponownie wyświetla klucz z zaznaczoną opcją Włącz wszystkie interfejsy API Google Maps dla tego projektu. Należy pozostawić ją zaznaczoną. Włącza ona zarówno Maps Static API, jak i Map Tiles API, dzięki czemu nie trzeba szukać ich w konsoli.

Okno Google z nagłówkiem „Wszystko gotowe do tworzenia”, kluczem API po uaktualnieniu konta i zaznaczonym polem „Włącz wszystkie interfejsy API Google Maps dla tego projektu”.
Krok 5. Pozostawić pole zaznaczone. Widoczny klucz został już usunięty.
  • Wkleić klucz do Yardstick

    Otworzyć Ustawienia, znaleźć Obrazy mapy, ustawić źródło na Google, wkleić klucz i nacisnąć Zapisz. Następnie odświeżyć stronę mapy.

Jedna pułapka w starszych wersjach Do wersji 1.0.5 włącznie Yardstick poprawnie zapisuje klucz, ale działający program zaczyna z niego korzystać dopiero po ponownym uruchomieniu. Jeśli po zapisaniu mapa nadal pokazuje zdjęcie USGS, należy ponownie uruchomić Yardstick lub komputer i sprawdzić jeszcze raz. W Yardstick 1.1.10 wystarczy zapisać klucz i odświeżyć mapę.

Jeśli klucz ma ograniczenia

Ograniczenie klucza to dobra praktyka. Yardstick działa z takim kluczem, o ile ograniczenia dopuszczają oba interfejsy API. Od wersji Yardstick 1.1.10 klucz ograniczony wyłącznie do Maps Static API pozwala wyświetlić zastępcze zdjęcie w niższej rozdzielczości.

  • Włączyć Map Tiles API

    W konsoli Google Cloud otworzyć Interfejsy API & usługi, następnie Biblioteka, wyszukać Map Tiles API i nacisnąć Włącz. Wybrać ten sam projekt, do którego należy klucz.

  • Dodać go do ograniczeń interfejsów API klucza

    Przejść do Interfejsy API & usługi, następnie do Dane logowania i otworzyć klucz. W sekcji Ograniczenia interfejsów API upewnić się, że zaznaczono zarówno Maps Static API, jak i Map Tiles API, a następnie nacisnąć Zapisz.

  • Pozostawić ograniczenie aplikacji bez zmian

    Klucz można ograniczyć do własnego publicznego adresu IP: Yardstick wysyła żądania do Google z komputera użytkownika. Ograniczenie do witryn internetowych (nagłówki odsyłające HTTP) nie jest odpowiednie i zawsze spowoduje odrzucenie żądania.

  • Odczekać kilka minut, a następnie odświeżyć stronę Podsumowanie

    Zastosowanie zmiany klucza po stronie Google może potrwać kilka minut.

Potrzebne będzie konto rozliczeniowe

Google wymaga takiego konta. Dokumentacja Google dotycząca zdjęć używanych przez Yardstick mówi wprost: „Aby korzystać z Maps Static API, należy włączyć rozliczenia w każdym projekcie i dołączać klucz API lub token OAuth do wszystkich żądań API lub SDK”.

Nie da się tego ominąć, również za pomocą bezpłatnego klucza demonstracyjnego. Jeśli konto rozliczeniowe jeszcze nie istnieje, można je utworzyć w opisanym powyżej kroku uaktualniania konta. Wymaga to podania danych karty.

Koszty: zużycie i bezpłatny limit

Google nalicza opłaty według zużycia, z miesięcznym bezpłatnym limitem dla każdego interfejsu API. To, czy pojawią się opłaty, zależy od zużycia i używanych interfejsów API.

Wcześniejszy pomiar dotyczył jednej posesji korzystającej z zapisanych zdjęć lotniczych: 20 zdjęć w ciągu 37 dni. Nie pozwala on przewidzieć zużycia Map Tiles API ani rachunku dla innej posesji. Yardstick przechowuje pobrane zdjęcia lotnicze na komputerze użytkownika i wykorzystuje je ponownie, dopóki zapisana kopia jest odpowiednia. Map Tiles i Maps Static to osobne usługi, dlatego podczas sprawdzania projektu Google Cloud należy osobno oceniać zużycie każdej z nich.

Dawne obliczenie, oparte na jednym nowym zdjęciu co cztery i pół minuty, dotyczyło wyłącznie zdjęć Static. Nie pozwala ono stwierdzić, czy wykorzystanie kafelków mieści się w bezpłatnym limicie. Należy sprawdzić oba interfejsy API w Google Cloud, uwzględniając także inne aplikacje korzystające z tego samego konta rozliczeniowego.

Po przekroczeniu bezpłatnego limitu

Opłaty po przekroczeniu limitu zależą od interfejsu API i progu zużycia. Zdjęcia Maps Static i żądania Map Tiles mają różne jednostki rozliczeniowe oraz bezpłatne limity. Należy sprawdzić obie usługi na stronie cenowej Google, a następnie monitorować zużycie w projekcie, zamiast traktować cenę zdjęć Static jako cenę całej mapy.

Są to ceny Google i to Google je zmienia. Aktualna stawka jest zawsze podana na stronie z cennikiem.

Jeśli mapa nadal wyświetla zdjęcia USGS

  • Najpierw uruchomić ponownie Yardstick

    W wersji 1.0.5 i wcześniejszych zapisany klucz jest używany dopiero po ponownym uruchomieniu Yardstick. W przypadku korzystania ze starszej wersji warto zacząć od ponownego uruchomienia. W Yardstick 1.1.10 wystarczy zapisać klucz i odświeżyć mapę.

  • Sprawdzić, czy klucz jest powiązany z kontem rozliczeniowym

    Klucz demonstracyjny nie zadziała. Jeśli pominięto krok Upgrade, to właśnie jest przyczyna.

  • Odczekać kilka minut

    Google może potrzebować kilku minut, aby zacząć obsługiwać nowo włączone API. Widzieliśmy, jak żądanie z tym samym kluczem było najpierw odrzucane, a dwadzieścia minut później obsługiwane bez problemu, choć w międzyczasie niczego nie zmieniono.

  • Sprawdzić, czy klucz nie ma ograniczenia do witryn internetowych

    Yardstick wysyła żądania do Google z komputera użytkownika, a nie ze strony internetowej. Klucz z ograniczeniem do odsyłających adresów HTTP będzie zawsze odrzucany.

  • Zdjęcie jest rozmyte po powiększeniu?

    Klucz ma dostęp do Maps Static API, ale nie do Map Tiles API. Więcej informacji w sekcji Jeśli nałożono ograniczenia na klucz powyżej.

  • Problem nadal występuje? Warto przesłać nam dziennik

    W Ustawienia → Pomoc techniczna → Coś nie działa? nacisnąć Wyślij dane diagnostyczne do Yardstick. Wystarczy jedno kliknięcie. Dzięki temu dowiemy się, do którego źródła wysłano zapytanie, które odpowiedziało i czy zapisano klucz. Sam klucz nigdy nie jest dołączany.

Sprawdzić, czy Map Tiles API jest włączone

Trzy sposoby, by to potwierdzić, zarówno po stronie Google, jak i Yardstick.

  • W Google Cloud: czy API jest włączone?

    W konsoli Google Cloud otworzyć APIs & Services, a następnie Enabled APIs & services. Na liście powinno znajdować się Map Tiles API, obok Maps Static API. Jeśli go brakuje, włączyć je w Library.

  • W Google Cloud: czy klucz ma do niego dostęp?

    Otworzyć APIs & Services, następnie Credentials i kliknąć swój klucz. Jeśli w API restrictions wybrano Restrict key, na liście wybranych API muszą znajdować się zarówno Maps Static API, jak i Map Tiles API. Opcja Don't restrict key również działa.

  • W Yardstick: czy zdjęcie na stronie Podsumowanie pozostaje ostre?

    Otworzyć stronę Podsumowanie i przybliżyć ogród. Gdy kafelki działają, zdjęcie pozostaje ostre podczas powiększania, a pod mapą widnieje informacja o źródle Google. Od wersji Yardstick 1.1.10 klucz z dostępem tylko do Maps Static API wyświetla w zastępstwie jedno mniej ostre zdjęcie.

  • W Yardstick: sprawdzić odpowiedź Google

    W Ustawieniach, w sekcji Obrazy mapy, włączyć Debugowanie mapy (tylko na prośbę pomocy technicznej), nacisnąć Zapisz i odświeżyć stronę Podsumowanie. Po odczytaniu informacji wyłączyć tę opcję: jest przeznaczona dla pomocy technicznej i wyświetla panel pod mapą. Panel pod mapą zawiera wiersz tiles: on oznacza, że Google dostarcza kafelki; po refused podany jest powód odmowy wskazany przez Google, na przykład "This API key is not authorized to use this service or API." Ten sam wiersz znajduje się w raporcie wysyłanym przyciskiem Wyślij dane diagnostyczne do Yardstick.

Yardstick to niezależne narzędzie do robotów Yarbo. Nie jest powiązane z Yarbo Inc. ani przez tę firmę rekomendowane. · © 2026 Yardstick Technologies LLC.