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 — 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

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.