Open source
Google Places for Laravel
composer require roundly-consulting/google-places-for-laravelPrehľ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
Inštalácia cez Composer, pridanie Google API kľúča, voliteľné publikovanie konfigurácie a overenie nastavenia jedným príkazom.
Konfigurácia
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
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
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)
Návrhy miest počas písania — typy, regióny, preferovaná či obmedzená oblasť a billing session, ktoré znižujú náklady.
Detail miesta
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
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
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
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í
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
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
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í
Voliteľná cache idempotentných dopytov znižuje latenciu aj náklady na Google — bezpečné kľúče a zapamätá si aj neexistujúce miesto.
Udalosti a logovanie
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)
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á
Hotové pravidlá Laravelu, ktoré pred volaním Google overia správny tvar place id alebo dvojice zemepisnej šírky a dĺžky.
Geolokačný driver
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
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
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
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 kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
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.