Johdanto

Etäisyysmatriisirajapinta on palvelu, joka tarjoaa matkamatkan ja-ajan lähtö-ja matkakohteiden matriisille. API palauttaa Google Mapsin sovellusliittymän laskeman suositellun reitin lähtö-ja päätepisteiden välillä ja koostuu riveistä, jotka sisältävät duration ja distance arvot jokaiselle parille.

huomautus: Tämä palvelu ei palauta yksityiskohtaisia reittitietoja. Reittitietoja voi saada välittämällä haluamansa yhden lähtö-ja määränpään Suuntarajapintaan.

ennen kuin aloitat

Tämä asiakirja on tarkoitettu kehittäjille, jotka haluavat laskea Google Mapsin sovellusliittymän tarjoamien karttojen pisteiden välisen matkan ja ajan. Se tarjoaa johdannon API: n ja vertailumateriaalin käyttöön käytettävissä olevilla parametreilla.

ennen kuin alat kehittää Distance Matrix API: a, tarkista todennusvaatimukset (tarvitset API-avaimen) sekä API: n käyttö-ja laskutustiedot (sinun on otettava laskutus käyttöön projektissasi).

Etäisyysmatriisipyynnöt

Etäisyysmatriisin API-pyyntö tapahtuu seuraavassa muodossa:

missä outputFormat voi olla jompikumpi seuraavista arvoista:

• json (suositeltu), osoittaa tuloste JavaScript-objektin notaatiossa (JSON); tai
• xml, ilmaisee tulosteen xml: nä.

Huomautus: URL-osoitteiden on oltava oikein koodattuja, jotta ne ovat päteviä, ja niiden enimmäispituus on 8192 merkkiä kaikissa verkkopalveluissa. Ole tietoinen tästä rajasta, kun rakennat URL-osoitteitasi. Huomaa, että eri selaimilla, välityspalvelimilla ja palvelimilla voi olla myös erilaisia URL-merkkirajoja.

HTTPS tai HTTP

turvallisuus on tärkeää, ja HTTPS: tä suositellaan aina kun se on mahdollista, erityisesti sovelluksille, jotka sisältävät pyynnöissä arkaluonteisia käyttäjätietoja, kuten käyttäjän sijainnin. HTTPS-salauksen käyttäminen tekee sovelluksestasi turvallisemman ja vastustuskykyisemmän urkkimiselle tai peukaloimiselle.

Jos HTTPS ei ole mahdollinen, voit käyttää Etäisyysmatriisin API: ta HTTP: n yli käyttämällä:

Pyyntöparametrit

tietyt parametrit vaaditaan, kun taas toiset ovat valinnaisia. Kuten URL-osoitteissa on tapana, kaikki parametrit erotetaan toisistaan Ampersand-merkillä (&). Kaikkien varattujen merkkien (esimerkiksi plusmerkki”+”) on oltava URL-koodattuja.Seuraavassa luetellaan parametrit ja niiden mahdolliset arvot.

vaaditut parametrit

• origins — lähtöpiste matkamatkan ja-ajan laskemiseksi. Voit antaa yhden tai useamman piippumerkillä erotetun paikan (|) paikkatunnisteen, osoitteen tai leveys – /pituuskoordinaattien muodossa:
  • Jos annat paikkatunnisteen, se on etuliitettävä merkinnällä place_id:. Voit määrittää paikkatunnuksen vain, jos pyyntö sisältää API-avaimen tai Google Maps Platform Premium Plan client ID: n. Voit hakea paikkatunnuksia geokoodaus API: sta ja Places API: sta (mukaan lukien Place Autocomplete). Esimerkki, jossa käytetään Paikkatunnuksia Place Autocomplete-ohjelmasta, on kohdassa paikka Automaattitäydennys ja ajo-ohjeet. Lisätietoja paikkatunnuksista on place ID-yleiskatsauksessa.
  • Jos ohitat osoitteen, palvelu geokoodaa merkkijonon ja muuntaa sen leveys – / pituuskoordinaatiksi etäisyyden laskemiseksi. Tämä koordinaatti voi olla erilainen kuin Geokoodirajapinnan palauttama, esimerkiksi rakennuksen sisäänkäynti sen keskustan sijaan.

    origins=Bobcaygeon+ON|24+Sussex+Drive+Ottawa+ON

    Huom: paikkatunnusten käyttö on suositeltavampaa kuin osoitteiden tai leveys – /pituuskoordinaattien käyttö. Koordinaattien käyttäminen johtaa aina siihen, että piste napsahtaa lähimmälle tielle, joka ei välttämättä ole kulkupiste kiinteistöön tai edes tie, joka johtaa nopeasti tai turvallisesti määränpäähän.
  • Jos ohitat leveys – / pituuskoordinaatit, ne napsahtavat lähimmälle tielle. Paikkatunnuksen läpäiseminen on suositeltavaa. Jos ohitat koordinaatit, varmista, että leveys-ja pituusarvojen välillä ei ole tilaa.

    origins=41.43206,-81.38992|-33.86748,151.20699

    origins=place_id:ChIJ3S-JXmauEmsRUcIaWtf4MzE

  • Plus-koodit on muotoiltava yleiskoodiksi tai yhdistelmäkoodiksi. Format plus-koodit kuten tässä on esitetty (plus-merkit ovat url-karannut %2B ja välilyönnit url-karannut %20):
    • yleinen koodi on 4-merkkinen suuntanumero ja 6-merkkinen tai pidempi paikallinen koodi (849VCWC8+R9 on 849VCWC8%2BR9).
    • yhdistelmäkoodi on 6-merkkinen tai pidempi paikallinen koodi, jolla on eksplisiittinen sijainti (CWC8+R9 Mountain View, CA, USA on CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Vaihtoehtoisesti voit toimittaa koodatun koordinaattijoukon koodatun Polyliinialgoritmin avulla. Tämä on erityisen hyödyllistä, jos sinulla on suuri määrä alkuperäpisteitä, koska URL on huomattavasti lyhyempi käytettäessä koodattua polylinjaa.
    • koodattujen polyliinien etuliitteenä on oltava enc: ja sen jälkeen kaksoispiste (:).Esimerkiksi: origins=enc:gfo}EtohhU:
    • voi sisältää myös useita koodattuja polyliineja, jotka on erotettu toisistaan piippumerkillä (|). Esimerkiksi: origins=enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:|enc:udymA{~bxM:

destinations — yksi tai useampi paikka, jota käytetään päätepisteenä matkamatkan ja-ajan laskemisessa. destinations parametri on sama kuin origins parametri, joka on kuvattu edellä.

• key — sovelluksesi API-avain. Tämä avain tunnistaa hakemuksesi kiintiöiden hallinnointia varten. Opettele hankkimaan avain.

  Huomautus: Google Maps Platform Premium Plan-asiakkaat voivat käyttää ETÄMATRIISIPYYNNÖISSÄSI joko API-avainta tai voimassa olevaa asiakastunnusta ja digitaalista allekirjoitusta. Saat lisätietoja Premium Plan-asiakkaiden todennusparametreista.

seuraavassa esimerkissä käytetään leveys – / pituuskoordinaatteja määräkoordinaattien määrittämiseen:

seuraavassa esimerkissä käytetään plus-koodeja määräkoordinaattien määrittämiseen:

seuraavassa esimerkissä esitetään sama pyyntö koodatulla polylinjalla:

valinnaiset parametrit

• mode (oletusarvo driving) — määrittää matkan laskemisessa käytettävän kuljetusmuodon. Voimassa olevat arvot ja muut pyyntöä koskevat tiedot on määritelty tämän asiakirjan matkustustavat-osiossa.
• language — kieli, jolla tulokset palautetaan.
  • Katso luettelo tuetuista kielistä. Google päivittää usein tuettuja kieliä, joten lista ei välttämättä ole tyhjentävä.
  • Jos language ei ole toimitettu, API yrittää käyttää Accept-Language – otsikossa määriteltyä ensisijaista kieltä tai sen verkkotunnuksen äidinkieltä, jolta pyyntö lähetetään.
  • API tekee parhaansa tarjotakseen katuosoitteen, joka on luettavissa sekä käyttäjälle että paikallisille. Tämän tavoitteen saavuttamiseksi se palauttaa paikallisella kielellä katuosoitteet, jotka translitteroidaan tarvittaessa käyttäjän luettavaksi skriptiksi, käyttäen haluamaansa kieltä. Kaikki muut osoitteet palautetaan halutulla kielellä. Osoitekomponentit palautetaan samalla kielellä, joka valitaan ensimmäisestä komponentista.
  • Jos nimeä ei ole saatavilla halutulla kielellä, API käyttää lähintä vastaavuutta.
  • ensisijaisella kielellä on pieni vaikutus siihen, millaisen tuloksen API valitsee palautettavaksi, ja missä järjestyksessä ne palautetaan. Geokooderi tulkitsee lyhenteitä eri tavoin kielestä riippuen, kuten katutyyppien lyhenteitä tai synonyymejä, jotka voivat olla voimassa yhdellä kielellä mutta eivät toisella. Esimerkiksi utca ja tér ovat unkarin kielen kadun synonyymejä.
• region — aluekoodi, määritelty ccTLD: n (country code top-level domain) kaksimerkkiseksi arvoksi. Useimmat ccTLD-koodit ovat samoja kuin ISO 3166-1-koodit joitakin poikkeuksia lukuun ottamatta. Tämä parametri vaikuttaa vain, ei täysin rajoittaa, tulokset geokooderin. Jos merkityksellisempiä tuloksia on olemassa määritellyn alueen ulkopuolella, ne voidaan ottaa mukaan.
• avoid — esittelee rajoituksia reitille. Voimassa olevat arvot on määritelty tämän asiakirjan Rajoitusosiossa. Vain yksi rajoitus voidaan määritellä.
• units — määrittää yksikköjärjestelmän, jota käytetään ilmaistaessa etäisyyttä tekstinä. Katso lisätietoja tämän asiakirjan Yksikköjärjestelmät-osiosta.
• arrival_time — määrittää kauttakulkupyyntöjen halutun saapumisajan sekunneissa keskiyöstä 1.tammikuuta 1970 UTC. Voit määrittää joko departure_time tai arrival_time, mutta ei molempia. Huomaa, että arrival_time on määriteltävä kokonaislukuna.
• departure_time — haluttu lähtöaika. Voit määrittää ajan kokonaislukuna sekunneissa keskiyöstä lähtien, 1. tammikuuta 1970 UTC. Jos departure_time myöhemmin kuin 9999-12-31T23:59:59.999999999 Z on määritelty, API laskee takaisin departure_time 9999-12-31T23:59:59.9999999 Z. Vaihtoehtoisesti voit määrittää arvon of now, joka asettaa lähtöajan kulloiseenkin aikaan (oikein lähimpään sekuntiin). Lähtöaika voidaan määrittää kahdessa tapauksessa:
  • pyynnöille, joissa matkustustapa on transit: Valinnaisesti voidaan määritellä jokin departure_time tai arrival_time. Jos kumpaakaan aikaa ei ole määritelty, departure_time default to now (eli lähtöaika default to the current time).
  • pyynnöissä, joissa matkustustila on ajettu: voit määrittää departure_time saadaksesi reitin ja matkan keston (vastauskenttä: duration_in_traffic), jotka ottavat huomioon liikenneolosuhteet. Tämä asetus on käytettävissä vain, jos pyyntö sisältää voimassa olevan API-avaimen tai Google Maps Platform Premium Plan client-tunnuksen ja allekirjoituksen. departure_time on asetettava nykyiselle tai jollekin tulevalle ajalle. Se ei voi olla menneisyyttä.

    Huomautus: Jos lähtöaikaa ei ole määritelty, reitin valinta ja kesto perustuvat tieverkostoon ja keskimääräisiin ajasta riippumattomiin liikenneolosuhteisiin. Tietyn pyynnön tulokset voivat vaihdella ajan mittaan tieverkon muutosten, päivitettyjen keskimääräisten liikenneolosuhteiden ja palvelun hajautetun luonteen vuoksi. Tulokset voivat myös vaihdella lähes samanarvoisten reittien välillä milloin tahansa tai milloin tahansa.

    Huom: Etäisyysmatriisipyynnöt, joissa departure_time kun mode=driving on rajoitettu enintään 100 alkioon per pyyntö. Alkuperien määrä kertaa kohteiden määrä määrittelee elementtien määrän.

• traffic_model (oletusarvo best_guess) — määrittää oletukset, joita käytetään laskettaessa aikaa liikenteessä. Tämä asetus vaikuttaa palautettuun arvoon duration_in_traffic – kentässä vastauksessa, joka sisältää ennustetun ajan liikenteessä historiallisten keskiarvojen perusteella. traffic_model parametri voidaan määrittää vain pyynnöille, joissa matkustustapa ondriving, ja jos pyyntö sisältäädeparture_time, ja vain, jos pyyntö sisältää API-avaimen tai Google Maps Platform Premium Plan-asiakastunnuksen. Tämän parametrin käytettävissä olevat arvot ovat:
  • best_guess (oletusarvo) osoittaa, että palautetun duration_in_traffic pitäisi olla paras arvio matka-ajasta ottaen huomioon, mitä tiedetään sekä historiallisista liikenneolosuhteista että elävästä liikenteestä. Live-liikenteen merkitys korostuu, mitä lähempänä departure_time on nyt.
  • pessimistic tarkoittaa, että palautetun duration_in_traffic pitäisi olla useimpina päivinä todellista matka-aikaa pidempi, joskin satunnaiset päivät, joilla on erityisen huonot liikenneolosuhteet, saattavat ylittää tämän arvon.
  • optimistic tarkoittaa, että palautetun duration_in_traffic pitäisi olla useimpina päivinä lyhyempi kuin todellinen matka-aika, joskin satunnaiset päivät, joilla on erityisen hyvät liikenneolosuhteet, saattavat olla tätä arvoa nopeampia.
• transit_mode — määrittää yhden tai useamman suositellun kauttakulkumuodon. Tämä parametri voidaan määrittää vain pyynnöille, joissa mode on transit. Parametri tukee seuraavia argumentteja:
  • bus kertoo, että lasketun reitin tulisi suosia linja-autolla matkustamista.
  • subway kertoo, että lasketun reitin tulisi suosia metromatkustamista.
  • train kertoo, että lasketun reitin tulisi suosia junalla matkustamista.
  • tram kertoo, että lasketun reitin tulisi suosia matkustamista raitiovaunulla ja kevytraiteilla.
  • rail kertoo, että lasketun reitin tulisi suosia matkustamista junalla, raitiovaunulla, kevytraiteilla ja metrolla. Tämä vastaa transit_mode=train|tram|subway.
• transit_routing_preference — määrittää kauttakulkupyyntöjen etuudet. Käyttämällä tätä parametria, voit vinouttaa palautettuja vaihtoehtoja, sen sijaan, että hyväksyisit API: n valitseman oletetun parhaan reitin. Tämä parametri voidaan määrittää vain pyynnöille, joissa mode on transit. Parametri tukee seuraavia argumentteja:
  • less_walking osoittaa, että lasketun reitin tulisi suosia rajoitettua kävelyä.
  • fewer_transfers tarkoittaa, että lasketun reitin tulisi suosia rajoitettua määrää siirtoja.

matkustustavat

etäisyyksien laskemiseksi voidaan määritellä kuljetustapa modekäytettäväksi. Oletuksena etäisyydet lasketaan ajotilalle. Seuraavat matkustustavat ovat tuettuja:

• driving (oletusarvo) ilmoittaa etäisyyslaskennan tieverkon avulla.
• walking pyytää laskemaan matkan jalankulkuväylillä kävellessä & jalkakäytävät (jos saatavilla).
• bicycling pyytää etäisyyslaskentaa pyörätiellä pyöräilyyn & suositellut kadut (jos saatavilla).
• transit pyytää matkan laskemista julkisen liikenteen reiteillä (jos saatavilla). Tämä arvo voidaan määrittää vain, jos pyyntö sisältää API-avaimen tai Google Maps Platform Premium Plan client ID: n. Jos asetat moodin transit, voit vaihtoehtoisesti määrittää joko departure_time tai arrival_time. Jos kumpaakaan aikaa ei ole määritelty, departure_time default to now (eli lähtöaika default to the current time). Voit myös vaihtoehtoisesti sisällyttää transit_mode ja/tai transit_routing_preference.

liikennetietoja

liikennetietoja käytetään, kun kaikki seuraavat ovat voimassa (nämä ovat ne ehdot, jotka vaaditaan duration_in_traffic kenttä Etäisyysmatriisivasteessa):

• matka mode parametri on driving, tai ei ole määritelty (driving on oletusmatkatila).
• pyyntö sisältää voimassa olevan departure_time parametrin. departure_time voidaan asettaa nykyiselle ajalle tai joskus tulevaisuudessa. Se ei voi olla menneisyyttä.

Vaihtoehtoisesti voit sisällyttää traffic_model – parametrin pyyntöösi määrittää oletukset, joita käytetään laskettaessa aikaa liikenteessä.

seuraava URL käynnistää Etäisyysmatriisipyynnön Bostonin, MA: n tai Charlestownin, MA: n ja Lexingtonin, MA: n ja Concordin, MA: n välisille ajoetäisyyksille. Pyyntö sisältää lähtöajan, joka täyttää kaikki vaatimukset duration_in_traffic kentän palauttamiselle Etäisyysmatriisivasteessa.

rajoitukset

voidaan laskea etäisyydet, jotka noudattavat tiettyjä rajoituksia. Rajoitukset ilmoitetaan käyttämällä avoid – parametria, ja parametrille argumenttia, joka osoittaa rajoituksen välttää. Seuraavia rajoituksia tuetaan:

• avoid=tolls

avoid=highwaysavoid=ferriesavoid=indoor

* huomaa: rajoitusten lisääminen ei sulje pois reittejä, joissa on rajoitettu ominaisuus, vaan se vääristää tuloksen suotuisammille reiteille.

Yksikköjärjestelmät

Etäisyysmatriisin tulokset sisältävät text sisällä distance kentät, jotka ilmaisevat lasketun reitin etäisyyden. Käytettävä yksikköjärjestelmä voidaan määritellä:

• units=metric (oletusarvo) palauttaa etäisyydet kilometreinä ja metreinä.
• units=imperial palauttaa etäisyydet maileina ja jalkoina.

* huomautus: Tämä yksikköjärjestelmän asetus vaikuttaa vain text näkyy distance kenttiin. distance kentät sisältävät myös values, jotka ilmoitetaan aina metreinä.

Etäisyysmatriisivastaukset

vastaukset Etäisyysmatriisirajapinnan kyselyihin palautetaan output – lipun osoittamassa muodossa URL-pyynnön polun sisällä.

alla on kaksi HTTP-ESIMERKKIPYYNTÖÄ, joissa pyydetään etäisyyttä ja kestoa Vancouverista, BC: stä, Kanadasta ja Seattlesta, WA: sta, Yhdysvalloista, San Franciscoon, CA: sta, USA: sta ja Victoriaan, BC: stä, Kanadasta.

Tämä pyyntö osoittaa käyttävänsä JSON output lippua:

Tämä pyyntö osoittaa käyttämällä XML: ää output lippu:

Tämä pyyntö palauttaa neljä elementtiä – kaksi alkuperää kertaa kaksi määränpäätä:

/td>

tulokset palautetaan riveinä siten, että jokainen rivi sisältää yhden alkuperän pareittain kuhunkin kohteeseen.

voit testata tätä syöttämällä URL-osoitteen selaimeesi (muista korvata YOUR_API_KEY varsinaisella API-avaimella).

valitse alla olevat välilehdet nähdäksesi otoksen JSON-ja XML-vastaukset.

tämän dokumentaation loppuosa käyttää JSON-syntaksia.

Etäisyysmatriisivasteelementit

Etäisyysmatriisivasteet sisältävät seuraavat juurielementit:

• status sisältää pyynnöstä metatiedot. Katso tilakoodit alta.
• origin_addresses sisältää joukon osoitteita, jotka API on palauttanut alkuperäisestä pyynnöstäsi. Nämä formatoidaan geokooderin avulla ja lokalisoidaan language – parametrin mukaan, joka kulkee pyynnön mukana.
• destination_addresses sisältää joukon osoitteita, jotka API on palauttanut alkuperäisestä pyynnöstäsi. Kuten origin_addresses, nämä paikantuvat tarvittaessa.
• rows sisältää joukon elements, jotka puolestaan kukin sisältävät statusduration, ja distance Elementti.

tilakoodit

status vastausobjektin kentät sisältävät pyynnön tilan ja voivat sisältää hyödyllisiä virheenkorjaustietoja. Etäisyysmatriisirajapinta palauttaa ylätason tilakentän, jossa on tietoja pyynnöstä yleensä, sekä tilakentän jokaiselle elementtikentälle, jossa on tietoa kyseisestä Origo-kohde-pariliitoksesta.

ylätason tilakoodit

• OK kertoo vastauksen sisältävän kelvollisen result.
• INVALID_REQUEST osoittaa, että annettu pyyntö oli virheellinen.
• MAX_ELEMENTS_EXCEEDED tarkoittaa, että alkuperien ja määräpaikkojen tuote ylittää kyselykohtaisen rajan.
• MAX_DIMENSIONS_EXCEEDED tarkoittaa, että alkuperien tai määräpaikkojen määrä ylittää kyselykohtaisen rajan.
• OVER_DAILY_LIMIT viittaa johonkin seuraavista:
  • API-avain puuttuu tai on virheellinen.
  • laskutus ei ole ollut käytössä tililläsi.
  • omaehtoinen käyttökatto on ylittynyt.
  • annettu maksutapa ei ole enää voimassa (esimerkiksi luottokortti on vanhentunut).

  Katso karttojen UKK: sta, miten tämä korjataan.

• OVER_QUERY_LIMIT ilmoittaa, että palvelu on saanut sallitussa ajassa liikaa pyyntöjä hakemuksestasi.
• REQUEST_DENIED tarkoittaa, että palvelu kielsi etämatriisipalvelun käytön sovelluksellasi.
• UNKNOWN_ERROR osoittaa, että Etäisyysmatriisipyyntöä ei voitu käsitellä palvelinvirheen vuoksi. Pyyntö voi onnistua, jos yrität uudelleen.

Elementtitason tilakoodit

• OK kertoo vastauksen sisältävän kelvollisen result.
• NOT_FOUND osoittaa, että tämän pariutumisen alkuperää ja / tai määränpäätä ei voitu geokoodata.
• ZERO_RESULTS osoittaa, ettei lähtöpaikan ja määränpään välistä löytynyt reittiä.
• MAX_ROUTE_LENGTH_EXCEEDED ilmoittaa, että pyydetty reitti on liian pitkä eikä sitä voida käsitellä.

Virheilmoitukset

kun ylätason tilakoodi on muu kuin OK, voi Etäisyysmatriisin vastausobjektin sisällä olla vieläerror_message kenttä. Tämä kenttä sisältää yksityiskohtaisempaa tietoa annetun tilakoodin syistä.

huomautus: tätä kenttää ei voida taata aina, ja sen sisältö voi muuttua.

rivit

kun Etäisyysmatriisin API palauttaa tulokset, se asettaa ne JSON rows array. Vaikka tuloksia ei palauteta (kuten kun alkuperää ja/tai kohteita ei ole), se palauttaa silti tyhjä array. XML-vasteet koostuvat nollasta tai useammasta <row> elementeistä.

rivit on järjestetty origin pyynnön parametrin arvojen mukaan. Jokainen rivi vastaa origoa, ja jokainen element kyseisen rivin sisällä vastaa Origon paritusta destination arvolla.

jokainen row array sisältää yhden tai useamman element merkinnät, jotka puolestaan sisältävät tiedon yhdestä alkuperä-kohde-parista.

alkuaineet

tiedot kustakin alkuperä-kohde-pariliitoksesta palautetaan element – merkinnässä. An element sisältää seuraavat kentät:

• status: Katso tilakoodit luettelo mahdollisista tilakoodeista.
• duration: tämän reitin kulkemiseen kuluva aika sekunteina (value kenttä) ja text. Tekstiesitys on lokalisoitu kyselyn language parametrin mukaan.

• duration_in_traffic: tällä reitillä kuluva aika, joka perustuu nykyisiin ja historiallisiin liikenneolosuhteisiin. Katso traffic_model request parametri valinnoille, joiden avulla voit pyytää, että palautettu arvo on optimistinen, pessimistinen tai parhaan arvauksen estimaatti. Kesto ilmoitetaan sekunteina (value kenttä) ja text. Tekstiesitys on lokalisoitu kyselyn language parametrin mukaan. Kesto liikenteessä palautetaan vain, jos kaikki seuraavat pitävät paikkansa:

  • pyyntö sisältää departure_time parametri.
  • pyyntö sisältää voimassa olevan API-avaimen tai Google Maps Platform Premium Plan client-tunnuksen ja allekirjoituksen.
  • liikenneolosuhteet ovat käytettävissä pyydetylle reitille.
  • mode parametriksi on asetettu driving.
• distance: tämän reitin kokonaismatka metreinä (value) ja text. Tekstiarvo käyttää unit – parametrilla määriteltyä yksikköjärjestelmää alkuperäisen pyynnön eli Origon alueen suhteen.
• fare: jos läsnä, sisältää koko lipun hinnan (eli lippujen kokonaiskustannukset) tällä reitillä. Tämä ominaisuus palautetaan vain kauttakulkupyyntöjä varten ja vain kauttakulkupalvelujen tarjoajille, jos hintatiedot ovat saatavilla. Tieto sisältää:
  • currency: ISO 4217-valuuttakoodi, joka ilmaisee valuutan, jossa määrä ilmaistaan.
  • value: lipun kokonaissumma edellä mainitussa valuutassa.
  • text: kokonaishinta pyydetyllä kielellä muotoiltuna.

alla on esimerkki element, joka sisältää hintatiedot:

tunnistinparametri

Google Mapsin sovellusliittymä edellytti aiemmin, että sinun tulee sisällyttää sensorparametri, joka kertoo, käyttikö sovelluksesi asensoria käyttäjän sijainnin määrittämiseen. Tämä parametri ei ole pitempivaatimus.