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.
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.
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.
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.
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.
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.
Liitä avain Yardstickiin
Avaa Asetukset, etsi Kartan kuvat, valitse lähteeksi Google, liitä avain ja paina Tallenna. Lataa sitten karttasivu 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ää.