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:

# 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 Geocoding + Distance Matrix
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

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 (Distance Matrix API, autom alebo pešo). Dopyty podľa IP vrátia null, takže Google môže pokojne stáť za IP poskytovateľmi.

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.