Tuki / Oma kartta / Googlen satelliittikuvat Hae ohjeista

Googlen satelliittikuvat

Yardstick piirtää pihasi maksuttoman viranomaisen tuottaman ilmakuvan päälle. Jos haluat käyttää Googlen kuvaa, joka on yleensä tarkempi ja tuoreempi, tarvitset oman Google-avaimen. Tämä opas käy läpi koko käyttöönoton, myös ne kaksi kohtaa, joihin moni jää jumiin.

Mistä se löytyy Asetukset › Kartan kuvat
Tämä ei ole välttämätöntä Oletuksena käytetään USGS/NAIP-kuvia: vapaasti käytettävää kuva-aineistoa koko Yhdysvalloista ilman avainta, tiliä tai käyttöönottoa. Kuvat ovat yleensä vuoden tai kaksi vanhoja, ja niiden tarkkuus on noin 0,6 metriä pikseliä kohden. Kyseessä on oikea ilmakuva, ei paikkamerkki. Google parantaa kuvanlaatua, mutta sitä ei tarvita, eikä mikään muu Yardstickin toiminto riipu valinnastasi.

Ensin yleinen kompastuskivi

Google tarjoaa nykyään ilmaisen avaimen ilman luottokorttia nimellä Maps Demo Key. Se on todella ilmainen, mutta se ei toimi Yardstickissä. Tähän kompastuu lähes jokainen, joten asia kannattaa ymmärtää ennen aloittamista.

Yardstick käyttää Map Tiles API -rajapintaa tarkkaan, suuriresoluutioiseen kuvaan ja Maps Static API -rajapintaa varavaihtoehtona. Ota molemmat käyttöön projektissa ja salli molemmat avaimellasi. Avain, jolle on sallittu vain Maps Static, näyttää silti epätarkemman kuvan Yardstick-versiosta 1.1.10 alkaen. Näkyvä kuva ei siis yksin todista, että karttatiilet ovat käytössä. Jos kuva sumenee lähennettäessä, tarkista sekä projektin käytössä olevat rajapinnat että avaimen rajapintarajoitukset alla olevien ohjeiden mukaan. Laskutuksen on oltava käytössä samassa projektissa kuin avain.

Jos liität demoavaimen Yardstickiin, kartta näyttää edelleen USGS-kuvaa. Yardstick ilmoittaa, ettei avain palauttanut kuvia, mutta olennaista on Googlen syy hylätä pyyntö. Ratkaisu on aina sama: liitä projektiin laskutustili.

Ohje vaihe vaiheelta

  • Hanki avain

    Siirry Google Maps Platformiin ja luo demoavain. Tässä vaiheessa et tarvitse maksukorttia. Tästä voi hyvin aloittaa, vaikka avain ei vielä toimi.

Google Maps Platform -sivu, jonka otsikko on Start building without barriers. Maps Demo Key -paneelissa näkyvät esimerkki API-avaimesta ja Copy key -painike.
Vaihe 1. Googlen Maps Demo Key -sivu. Tässä näkyvä avain on Googlen oma esimerkki, ei oikea avain.
  • Lue pienellä painettu teksti ja paina Upgrade account

    Google antaa avaimen ja kertoo samalla, että se on tarkoitettu vain testikäyttöön. Juuri siksi avain ei tuo pihasi kuvaa näkyviin. Vieressä oleva Upgrade account -linkki ratkaisee asian.

Google Cloud -valintaikkuna, jonka otsikko on Here's your Maps Demo Key. Siinä näkyvät avain laatikossa, teksti ”This key is limited to testing use, but you can upgrade when you are ready for production” ja Upgrade account -linkki.
Vaihe 2. ”Tämä avain on tarkoitettu vain testikäyttöön.” Siinä koko ongelma Googlen itsensä kertomana. Kuvassa näkyvä avain on sittemmin poistettu.
  • Päivitä tili

    Google kertoo, mikä muuttuu: kaikki sen Maps-rajapinnat tulevat projektisi käyttöön, nykyinen avaimesi toimii edelleen ja Google laskuttaa käytön mukaan sekä tarjoaa kuukausittaisen maksuttoman käyttömäärän. Katso hinnoittelua käsittelevä osio alta.

Googlen valintaikkuna, jonka otsikko on Ready to launch. Siinä luetellaan Access all GMP APIs, No interruption keep your current key ja Get up to 10k free calls per product per month, ja siinä on Close- ja Upgrade-painikkeet.
Vaihe 3. Huomaa kohta ”Säilytä nykyinen avaimesi”. Sinun ei tarvitse aloittaa alusta.
  • Liitä laskutustili

    Jos sinulla on jo laskutustili, valitse se. Muussa tapauksessa Google opastaa tilin luomisessa ja pyytää maksukortin tietoja. Tätä ei voi kiertää: Google edellyttää laskutuksen käyttöönottoa kaikissa projekteissa, jotka käyttävät Yardstickin tarvitsemaa kuva-aineistoa. Google laskuttaa käytön mukaan. Katso hinnoittelua käsittelevä osio alta.

Googlen valintaikkuna, jonka otsikko on Set the billing account for project. Siinä on Billing account -pudotusvalikko ja Set account -painike.
Vaihe 4. Laskutustilin valinta. Uuden tilin luominen tästä eteenpäin vaatii vielä muutaman näkymän läpikäymisen ja maksukortin.
  • Anna Googlen ottaa rajapinnat käyttöön puolestasi

    Kun tilin päivitys valmistuu, Google näyttää avaimesi uudelleen. Valinta Enable all Google Maps APIs for this project on jo valittuna. Jätä se valituksi. Näin sekä Maps Static API että Map Tiles API otetaan käyttöön, eikä sinun tarvitse etsiä niitä hallintakonsolista.

Googlen valintaikkuna, jonka otsikko on You're all set to develop. Siinä näkyvät päivitetty API-avain ja valittu valintaruutu Enable all Google Maps APIs for this project.
Vaihe 5. Jätä valintaruutu valituksi. Tässä näkyvä avain on sittemmin poistettu.
  • Liitä avain Yardstickiin

    Avaa Asetukset, etsi Kartan kuvat, valitse lähteeksi Google, liitä avain ja paina Tallenna. Lataa sitten karttasivu uudelleen.

Huomio vanhemmista versioista Versioon 1.0.5 asti, se mukaan lukien, Yardstick tallentaa avaimen oikein, mutta käynnissä oleva sovellus ottaa sen käyttöön vasta uudelleenkäynnistyksen jälkeen. Jos kartassa näkyy tallentamisen jälkeen edelleen USGS-kuva, käynnistä Yardstick tai tietokone uudelleen ja tarkista kuva. Yardstick-versiossa 1.1.10 riittää, että tallennat avaimen ja lataat kartan uudelleen.

Jos rajoitit avaimesi käyttöä

Avaimen käytön rajoittaminen on hyvä käytäntö. Yardstick toimii rajoitetulla avaimella, kunhan rajoitus sallii molemmat rajapinnat. Vain Maps Static API -rajapintaan rajoitettu avain näyttää epätarkemman varakuvan Yardstick-versiosta 1.1.10 alkaen.

  • Ota Map Tiles API käyttöön

    Avaa Google Cloud -hallintakonsolissa APIs & Services ja sitten Library, etsi Map Tiles API ja paina Enable. Käytä samaa projektia kuin avaimelle.

  • Lisää se avaimen sallittuihin rajapintoihin

    Siirry kohtaan APIs & Services ja sitten Credentials ja avaa avaimesi. Varmista kohdassa API restrictions, että sekä Maps Static API että Map Tiles API on valittu, ja paina Save.

  • Jätä sovellusrajoitus ennalleen

    Avaimen rajoittaminen omaan julkiseen IP-osoitteeseesi toimii: Yardstick lähettää pyynnöt Googlelle tietokoneeltasi. Verkkosivustoihin perustuva rajoitus (HTTP-viittaajat) ei toimi, vaan pyyntö hylätään aina.

  • Odota muutama minuutti ja lataa sitten Yhteenveto-sivu uudelleen

    Avaimeen tehdyn muutoksen voimaantulo Googlessa voi kestää useita minuutteja.

Tarvitset laskutustilin

Google edellyttää sitä. Sen omissa ohjeissa Yardstickin käyttämälle kuva-aineistolle asia sanotaan suoraan: ”Maps Static API -rajapinnan käyttö edellyttää, että otat laskutuksen käyttöön jokaisessa projektissasi ja sisällytät API-avaimen tai OAuth-tunnuksen kaikkiin API- tai SDK-pyyntöihin.”

Tätä vaatimusta ei voi kiertää, ei myöskään ilmaisella demoavaimella. Jos sinulla ei vielä ole laskutustiliä, se luodaan edellä kuvatussa tilin päivitysvaiheessa, ja siihen tarvitaan maksukortti.

Mitä se maksaa: käyttö ja maksuton käyttömäärä

Google laskuttaa käytön mukaan ja tarjoaa kullekin rajapinnalle kuukausittaisen maksuttoman käyttömäärän. Käyttämäsi rajapinnat ja käytön määrä ratkaisevat, syntyykö maksuja.

Aiempi mittaus koski yhtä kiinteistöä, jolla käytettiin tallennettuja ilmakuvia: 20 kuvaa 37 päivässä. Se ei ennusta Map Tiles API -rajapinnan käyttöä eikä toisen kiinteistön laskua. Yardstick säilyttää ladatut ilmakuvat tietokoneellasi ja käyttää niitä uudelleen niin kauan kuin tallennettu kopio soveltuu käyttöön. Map Tiles ja Maps Static ovat erillisiä palveluja, joten tarkista kummankin käyttö erikseen Google Cloud -projektissasi.

Vanha laskelma, joka perustui yhteen uuteen kuvaan neljän ja puolen minuutin välein, koski vain Static-kuvia. Sen perusteella ei voi päätellä, pysyykö karttatiilien käyttö maksuttoman käyttömäärän rajoissa. Tarkista molemmat rajapinnat Google Cloudissa ja huomioi myös muut samaa laskutustiliä käyttävät sovellukset.

Jos ylität maksuttoman käyttömäärän

Maksuttoman käyttömäärän ylittävät maksut riippuvat rajapinnasta ja käyttömäärän hintaluokasta. Maps Static -kuvilla ja Map Tiles -pyynnöillä on eri laskutusyksiköt ja maksuttoman käytön rajat. Tarkista molemmat Googlen hinnoittelusivulta ja seuraa sitten projektisi käyttöä. Static-kuvien hinta ei kerro koko kartan käytön hintaa.

Nämä ovat Googlen hintoja, ja Google voi muuttaa niitä. Ajantasainen hinta löytyy aina Googlen hinnastosivulta.

Jos kartalla näkyy yhä USGS

  • Käynnistä ensin Yardstick uudelleen

    Versiossa 1.0.5 ja sitä vanhemmissa tallennettu avain tulee käyttöön vasta, kun Yardstick käynnistetään uudelleen. Jos käytät yhä tuota vanhempaa versiota, kokeile ensin uudelleenkäynnistystä. Yardstick 1.1.10:ssä tallenna avain ja lataa kartta uudelleen.

  • Tarkista, että avain on liitetty laskutustiliin

    Demoavain ei toimi lainkaan. Jos et ole tehnyt Upgrade-vaihetta, syy on siinä.

  • Odota muutama minuutti

    Googlella voi kestää useita minuutteja, ennen kuin juuri käyttöön otettu rajapinta alkaa vastata pyyntöihin. Olemme nähneet saman avaimen ensin hylkäävän pyynnön ja sitten toimivan moitteettomasti kaksikymmentä minuuttia myöhemmin, vaikka välissä ei muutettu mitään.

  • Tarkista, ettei avainta ole rajattu verkkosivustoihin

    Yardstick lähettää pyynnöt Googlelle omalta tietokoneeltasi, ei verkkosivulta. HTTP-viittaajiin rajatulla avaimella tehdyt pyynnöt hylätään aina.

  • Sumeneeko kuva, kun lähennät?

    Avaimelle on sallittu Maps Static API, mutta ei Map Tiles API. Katso yllä oleva kohta Jos rajoitit avaintasi.

  • Eikö vieläkään toimi? Lähetä meille loki

    Avaa Asetukset → Tuki → Onko jokin vialla? ja paina Lähetä diagnostiikkatiedot Yardstickille. Yksi napsautus riittää. Tiedoista näemme, mistä lähteestä kuvaa pyydettiin, mikä lähde vastasi ja onko avain tallennettu. Avaintasi ei koskaan lähetetä mukana.

Tarkista, että Map Tiles API on käytössä

Kolme tapaa varmistaa asia Googlen ja Yardstickin puolelta.

  • Google Cloudissa: onko rajapinta käytössä?

    Avaa Google Cloudin hallintakonsolissa APIs & Services ja sitten Enabled APIs & services. Luettelossa pitäisi näkyä Map Tiles API rajapinnan Maps Static API rinnalla. Jos se puuttuu, ota se käyttöön Library-osiosta.

  • Google Cloudissa: saako avain käyttää rajapintaa?

    Avaa APIs & Services, sitten Credentials ja napsauta avaintasi. Jos kohdassa API restrictions on valittuna Restrict key, sekä Maps Static API että Map Tiles API on oltava valittujen luettelossa. Myös Don't restrict key toimii.

  • Yardstickissä: pysyykö Yhteenveto-sivun kuva terävänä?

    Avaa Yhteenveto-sivu ja lähennä pihaasi. Kun karttatiilet toimivat, kuva pysyy terävänä lähennettäessä ja Googlen lähdemerkintä näkyy kartan alla. Yardstick 1.1.10:stä alkaen pelkkään Static-rajapintaan oikeuttavalla avaimella näytetään yksi epätarkempi varakuva.

  • Yardstickissä: katso, mitä Google vastasi

    Avaa Asetukset ja ota kohdassa Kartan kuvat käyttöön Kartan virheenjäljitys (vain tuen pyynnöstä), paina Tallenna ja lataa Yhteenveto-sivu uudelleen. Poista toiminto käytöstä, kun olet lukenut tiedot. Se on tarkoitettu tukikäyttöön ja jättää kartan alle paneelin. Paneelissa on tiles-rivi: on tarkoittaa, että Google toimittaa karttatiiliä; merkinnän refused perässä näkyy Googlen ilmoittama syy, esimerkiksi "This API key is not authorized to use this service or API." Sama rivi sisältyy raporttiin, jonka Lähetä diagnostiikkatiedot Yardstickille lähettää.

Yardstick on riippumaton työkalu Yarbo-roboteille. Se ei ole sidoksissa Yarbo Inc. -yhtiöön eikä yhtiön suosittelema. · © 2026 Yardstick Technologies LLC.