---
title: "Poskytovatelia — Geolocation for Laravel | Roundly"
description: "Nastavenie IPinfo, IP2Location, Google a záložnej polohy — prístupové údaje, čo ktorý poskytovateľ určí a ktoré polia Location vyplní."
url: https://roundly-consulting.com/sk/open-source/navody/geolocation-for-laravel/poskytovatelia
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Geolocation for Laravel](https://roundly-consulting.com/sk/open-source/navody/geolocation-for-laravel.md)

# Poskytovatelia

Každý HTTP poskytovateľ komunikuje so svojím API cez vlastného HTTP klienta Laravelu — bez SDK dodávateľov — so spoločným timeoutom, vlastným nastavením opakovaní a vlastným limitom požiadaviek. Prístupové údaje, ktoré máte, pridajte do .env:

```bash
# IPinfo — the token is optional; the anonymous tier works without one
IPINFO_TOKEN=your-ipinfo-token

# IP2Location.io
IP2LOCATION_API_KEY=your-ip2location-key

# Google — the key needs the Geocoding API and the Routes API enabled
GOOGLE_MAPS_API_KEY=your-google-maps-key

# Static location returned by the "default" provider
GEOLOCATION_DEFAULT_HUMAN_READABLE="Springfield, US"
GEOLOCATION_DEFAULT_STREET="Main Street 1"
GEOLOCATION_DEFAULT_CITY=Springfield
GEOLOCATION_DEFAULT_COUNTRY_ISO_CODE=US
GEOLOCATION_DEFAULT_LATITUDE=39.7817
GEOLOCATION_DEFAULT_LONGITUDE=-89.6501
```

## Čo ktorý poskytovateľ vracia

| Poskytovateľ | Prístupové údaje | Vypĺňa | type |
| --- | --- | --- | --- |
| `ipinfo` | Voliteľný token (IPINFO\_TOKEN) | city, region, countryIsoCode, postalCode, timezone, latitude/longitude | `Ip` |
| `ip2location` | API kľúč (IP2LOCATION\_API\_KEY) | city, region, countryIsoCode, postalCode, timezone, latitude/longitude | `Ip` |
| `maxmind_*` | Pozri MaxMind | city, region (prvá subdivízia), countryIsoCode, postalCode, timezone, latitude/longitude — anglické názvy | `Ip` |
| `google` | API kľúč (GOOGLE\_MAPS\_API\_KEY) | humanReadable (naformátovaná adresa), street, city, region, postalCode, countryIsoCode, latitude/longitude — bez timezone | `Geolocation` |
| `default` | Žiadne | Nastavené hodnoty default.\*; region, postalCode a timezone zostanú prázdne. Kým nič nenastavíte, odpovie null | `Default` |

## IPinfo

Volá /{ip}/json na ipinfo.io. Token je voliteľný: anonymný režim funguje aj bez neho a hlavička bearer sa posiela, len keď je token nastavený. Neplatné IP a dopyty bez IP vrátia null bez požiadavky.

## IP2Location.io

Volá API ip2location.io s vaším kľúčom a IP adresou; bez IP2LOCATION\_API\_KEY odíde požiadavka neautentifikovaná. Odpoveď s chybou, stav mimo 2xx alebo neplatná IP skončí ako null, rovnako ako celkom prázdna odpoveď pre súkromnú či rezervovanú IP.

## Google

Jediný pribalený poskytovateľ, ktorý spracuje súradnice aj adresy: spätné geokódovanie pre súradnice a priame geokódovanie pre adresy, oboje cez Geocoding API. Je aj jediným pribaleným DistanceProvider: vzdialenosti a matice počíta computeRouteMatrix z Routes API, autom (bez ohľadu na premávku) alebo pešo. Dopyty podľa IP vrátia null, takže Google môže pokojne stáť za IP poskytovateľmi.

Na kľúči v GOOGLE\_MAPS\_API\_KEY povoľte Geocoding API aj Routes API. Geocoding API ho dostane ako parameter key v query, Routes API v hlavičke X-Goog-Api-Key; obe adresy nastavíte cez services.google.url a services.google.routes\_url. Keď Google požiadavku odmietne ako celok — kľúč bez povoleného API (REQUEST\_DENIED, PERMISSION\_DENIED), vyčerpaná kvóta, neplatná požiadavka —, poskytovateľ namiesto odpovede null vyhodí ProviderUnavailableException bez prístupových údajov a so stavom od Google, takže pipeline pokračuje ďalej a udalosť o zlyhaní uvedie dôvod.

## Default

Vráti statickú polohu z default.\* s typom Default — no až keď ju nastavíte; kým sú všetky hodnoty default.\* prázdne alebo nulové (ako po inštalácii), odpovie null. Nastavte ju, ak má mať aplikácia vždy s čím pracovať — napríklad s vaším sídlom alebo krajinou, ktorú obsluhujete najčastejšie. Záložná poloha sa nikdy necachuje.

Dvaja poskytovatelia MaxMind majú vlastnú časť — pozrite MaxMind.

## 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/navody/geolocation-for-laravel.md)