--- title: "Google Places for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Google Places for Laravel: našepkávanie, detail miesta, vyhľadávanie, geokódovanie, matica vzdialeností, fotografie, cache a testy." url: https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Google Places for Laravel Inštalácia `composer require roundly-consulting/google-places-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/google-places-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/google-places-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Typovaný Laravel klient pre Google Places API (New), Routes API a Geocoding API. Našepkávanie adries, vyhľadávanie miest a ich detail, geokódovanie oboma smermi, vzdialenosti, časy presunu aj celé matice a fotografie miest — všetko cez jednu fasádu, ktorá namiesto surového JSON vracia čisté dátové objekty. Postavené na vlastnom HTTP klientovi Laravelu bez Google SDK, pod licenciou MIT; jediné ďalšie závislosti sú štyri malé balíky Roundly. Plnohodnotný GooglePlaces::fake() udrží vaše testy mimo plateného API. ### Čo získate #### Places API (New) Našepkávanie, detail miesta, textové a okolité vyhľadávanie aj find place nad aktuálnou generáciou Places API — vrátane autentifikácie v hlavičke a field masiek. #### Geokódovanie oboma smermi Preveďte súradnice na adresu alebo adresu na súradnice a čítajte ulicu, mesto, PSČ a krajinu cez typované metódy. #### Vzdialenosť, čas a matica Vzdialenosť a čas presunu s ohľadom na dopravu cez Routes API, samostatná cesta z jedného štartu do každého cieľa a plné matice štartov × cieľov. #### Fotografie bez úniku kľúča Stiahnite bajty fotografie miesta, uložte ich na ľubovoľný Laravel disk alebo prehliadaču odovzdajte URL bez API kľúča. #### Šetrné k nákladom a odolné Upraviteľné field masky, billing session, voliteľná cache, strop stránkovania, rate limiting pre každé API, timeouty a opakovania spojenia. #### Fasáda alebo vložený klient Volajte GooglePlaces::… alebo si vložte kontrakt PlacesClient — GooglePlaces::fake() zaznamená každé volanie z oboch, bez plateného API. #### Pozorovateľné Udalosti životného cyklu pre každú požiadavku, voliteľné logovanie a kontrola stavu API v kóde aj ako kontrolný príkaz. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/instalacia.md) Inštalácia cez Composer, pridanie Google API kľúča, voliteľné publikovanie konfigurácie a overenie nastavenia jedným príkazom. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/konfiguracia.md) Všetky konfiguračné kľúče a env premenné — API kľúč, hosty, field masky, timeouty, cache, stránkovanie, logovanie a rate limity. #### [Fasáda GooglePlaces](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/klient-a-fasada.md) Všetky dopyty, handles a kontrola stavu na jednej fasáde — skalárne skratky alebo nemenné query objekty a GooglePlaces::fake() na testy. #### [Bez fasády](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/bez-fasady.md) Vložte si kontrakt PlacesClient a získate to isté API bez statických volaní — google-places nemá triedy akcií, prípady použitia sú metódy klienta. #### [Našepkávanie (autocomplete)](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/nasepkavanie.md) Návrhy miest počas písania — typy, regióny, preferovaná či obmedzená oblasť a billing session, ktoré znižujú náklady. #### [Detail miesta](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/detail-miesta.md) Načítajte miesto podľa id — názov, adresu, súradnice, typy, otváracie hodiny a fotografie — s field maskou pre jednu požiadavku. #### [Vyhľadávanie a find place](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/vyhladavanie.md) Textové a okolité vyhľadávanie a find place — s filtrami, preferovanou oblasťou, page tokenmi a lenivým stránkovaním so stropom. #### [Geokódovanie](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/geokodovanie.md) Preveďte súradnice na adresu a adresu na súradnice a čítajte ulicu, mesto, PSČ a krajinu cez typované metódy. #### [Vzdialenosť a čas presunu](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/vzdialenost.md) Vzdialenosť a čas presunu cez Routes API — štyri spôsoby dopravy, jazda s ohľadom na premávku a samostatná cesta z jedného štartu do každého cieľa. #### [Matica vzdialeností](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/matica-vzdialenosti.md) Vypočítajte mnoho štartov voči mnohým cieľom jedným volaním a čítajte ľubovoľnú dvojicu, riadok či stĺpec výsledku. #### [Fotografie](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/fotografie.md) Zostavte URL fotografií alebo ich stiahnite na serveri, uložte na ľubovoľný disk a prehliadaču dajte URL bez API kľúča. #### [Spracovanie chýb](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/spracovanie-chyb.md) Jedna PlacesException s typovanými kontrolami pre rate limit, zamietnutý kľúč, neplatnú požiadavku a nedostupné API — kľúč sa v správach začierni. #### [Cache odpovedí](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/cache-odpovedi.md) Voliteľná cache idempotentných dopytov šetrí latenciu aj náklady na Google — bezpečné kľúče, zapamätané neexistujúce miesta a obnovenie cez fresh. #### [Udalosti a logovanie](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/udalosti-a-logovanie.md) Jedna udalosť životného cyklu na každú požiadavku do Google a voliteľné logovanie — pre metriky, upozornenia a audit, bez odhalenia kľúča. #### [Limity požiadaviek (rate limiting)](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/limity-poziadaviek.md) Každé odchádzajúce volanie sa riadi limitom svojho Google API — prispôsobí sa odpovediam 429, ladí sa cez env a vie rýchlo zlyhať. #### [Validačné pravidlá](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/validacne-pravidla.md) Hotové pravidlá Laravelu, ktoré pred volaním Google overia tvar place id alebo dvojice zemepisnej šírky a dĺžky — s hláškami v angličtine aj slovenčine. #### [Geolokačný driver](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/geolokacny-driver.md) Používajte Google Places ako driver google\_places v geolocation-for-laravel na vyhľadávanie adries a súradníc — chyby prepadnú ďalej, nič nezastavia. #### [Artisan príkazy](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/prikazy.md) Kontrolný príkaz, ktorý s vaším kľúčom otestuje každé Google API — aj ako GooglePlaces::check() — a sekcia balíka v php artisan about. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/testovanie.md) GooglePlaces::fake() zaznamená každé volanie a odpovie pripravenými výsledkami — overte, na čo sa váš kód pýtal Google, bez plateného API. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/google-places-for-laravel/poziadavky.md) PHP 8.4+, Laravel 12 alebo 13 a kľúč Google Maps Platform s povolenými Places, Routes a Geocoding API. ## Prejavte lásku k open source Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať. [Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md) Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md). [Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly) ## Chcete to zabudovať do svojho produktu? Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín. [Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source.md)