Skip to content

Commit f25a7f5

Browse files
mtmailwilldurand
authored andcommitted
provider list converted into a markdown table
1 parent 1f749c1 commit f25a7f5

File tree

1 file changed

+42
-29
lines changed

1 file changed

+42
-29
lines changed

README.md

Lines changed: 42 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -27,35 +27,48 @@ _Providers_ contain the logic to extract useful information.
2727

2828
Currently, there are many providers for the following APIs:
2929

30-
* [FreeGeoIp](http://freegeoip.net/static/index.html) as IP-Based geocoding provider;
31-
* [HostIp](http://www.hostip.info/) as IP-Based geocoding provider;
32-
* [IpInfoDB](http://www.ipinfodb.com/) as IP-Based geocoding provider (city precision);
33-
* [Google Maps](http://code.google.com/apis/maps/documentation/geocoding/) as Address-Based geocoding and reverse geocoding provider;
34-
* [Google Maps for Business](https://developers.google.com/maps/documentation/business/webservices) as Address-Based geocoding and reverse geocoding provider;
35-
* [Bing Maps](http://msdn.microsoft.com/en-us/library/ff701715.aspx) as Address-Based geocoding and reverse geocoding provider;
36-
* [OpenStreetMap](http://nominatim.openstreetmap.org/) as Address-Based geocoding and reverse geocoding provider (based on the Nominatim provider);
37-
* [Nominatim](http://wiki.openstreetmap.org/wiki/Nominatim) as Address-Based geocoding and reverse geocoding provider;
38-
* [Geoip](http://php.net/manual/book.geoip.php), the PHP extension, as IP-Based geocoding provider;
39-
* ChainProvider is a special provider that takes a list of providers and iterates
40-
over this list to get information;
41-
* [MapQuest](http://open.mapquestapi.com/) as Address-Based geocoding and reverse geocoding provider;
42-
* [OpenCage](http://geocoder.opencagedata.com/) as Address-Based geocoding and reverse geocoding provider;
43-
* [OIORest](http://geo.oiorest.dk/) as very accurate Address-Based geocoding and reverse geocoding provider (exclusively in Denmark);
44-
* [GeoCoder.ca](http://geocoder.ca/) as Address-Based geocoding and reverse geocoding provider (exclusively in USA & Canada);
45-
* [GeoCoder.us](http://geocoder.us/) as Address-Based geocoding provider (exclusively in USA);
46-
* [IGN OpenLS](http://www.ign.fr/) as Address-Based geocoding provider (exclusively in France);
47-
* [DataScienceToolkit](http://www.datasciencetoolkit.org/) as IP-Based geocoding provider or an Address-Based provider (exclusively in USA & Canada);
48-
* [Yandex](http://api.yandex.com.tr/maps/doc/geocoder/desc/concepts/About.xml) as Address-Based geocoding and reverse geocoding provider;
49-
* [GeoPlugin](http://www.geoplugin.com/webservices) as IP-Based geocoding provider;
50-
* [GeoIPs](http://www.geoips.com/developer/geoips-api) as IP-Based geocoding provider;
51-
* [MaxMind web service](http://dev.maxmind.com/geoip/legacy/web-services) as IP-Based geocoding provider (City/ISP/Org and Omni services);
52-
* [MaxMind binary file](http://dev.maxmind.com/geoip/legacy/downloadable) as IP-Based geocoding provider;
53-
* [MaxMind GeoIP2](http://www.maxmind.com/en/city) as IP-Based geocoding provider;
54-
* [Geonames](http://www.geonames.org/) as Place-Based geocoding and reverse geocoding provider;
55-
* [IpGeoBase](http://ipgeobase.ru/) as IP-Based geocoding provider (very accurate in Russia);
56-
* [Baidu](http://developer.baidu.com/map/geocoding-api.htm) as Address-Based geocoding and reverse geocoding provider (exclusively in China);
57-
* [TomTom](http://developer.tomtom.com/docs/read/Geocoding) as Address-Based geocoding and reverse geocoding provider;
58-
* [ArcGIS Online](http://resources.arcgis.com/en/help/arcgis-online-geocoding-rest-api/) as Address-Based geocoding and reverse geocoding provider.
30+
Address-based geocoding
31+
32+
33+
provider | reverse | SSL | coverage | terms
34+
:------------- |:--------- |:--------- |:--------- |:-----
35+
[Google Maps](https://developers.google.com/maps/documentation/geocoding/) | yes | no | worldwide | requires API key. Limit 2500 requests per day
36+
[Google Maps for Business](https://developers.google.com/maps/documentation/business/) | yes | no | worldwide | requires API key. Limit 100,000 requests per day
37+
[Bing Maps](http://msdn.microsoft.com/en-us/library/ff701713.aspx) | yes | no | worldwide | requires API key. Limit 10,000 requests per month.
38+
[OpenStreetMap](http://wiki.openstreetmap.org/wiki/Nominatim) | yes | no | worldwide | heavy users (>1q/s) get banned
39+
Nominatim | yes | supported | worldwide | requires a domain name (e.g. local installation)
40+
[MapQuest](http://developer.mapquest.com/web/products/dev-services/geocoding-ws) | yes | no | worldwide | both open and [commercial service](http://platform.mapquest.com/geocoding/) require API key
41+
[OpenCage](http://geocoder.opencagedata.com/) | yes | supported | worldwide | requires API key. 2500 requests/day free
42+
[OIORest](http://geo.oiorest.dk/) | yes | | Denmark
43+
[GeoCoder.ca](http://geocoder.ca/) | yes | supported | USA, Canada | requires API key. $1 CAD for 400 lookups
44+
[GeoCoder.us](http://geocoder.us/) | no | no | USA | free throttled service. $50 USD for 20000 requests for paid service
45+
[IGN OpenLS](http://api.ign.fr/accueil) | no | no | France | requires API key
46+
[DataScienceToolkit](http://www.datasciencetoolkit.org/) | no | no | USA, Canada
47+
[Yandex](http://api.yandex.com/maps/) | yes | no | worldwide
48+
[Geonames](http://www.geonames.org/commercial-webservices.html) | yes |no | worldwide | requires registration, no free tier
49+
[Baidu](http://developer.baidu.com/map/geocoding-api.htm) | yes | no | China | requires API key
50+
[TomTom](https://geocoder.tomtom.com/app/view/index) | yes | required | worldwide | requires API key. First 2500 requests or 30 days free
51+
[ArcGIS Online](https://developers.arcgis.com/en/features/geocoding/) | yes | supported | worldwide | requires API key. 1250 requests free
52+
ChainProvider | | | | meta provider which iterates over a list of providers
53+
54+
55+
56+
57+
IP-based geocoding
58+
59+
provider | IPv6 | terms | notes
60+
:------------- |:--------- |:--------- |:---------
61+
[DataScienceToolkit](http://www.datasciencetoolkit.org/) | no
62+
[FreeGeoIp](http://freegeoip.net/) | yes
63+
[HostIp](http://www.hostip.info/use.html) | no
64+
[IpGeoBase](http://ipgeobase.ru/) | no | | very accurate in Russia
65+
[IpInfoDB](http://ipinfodb.com/) | no | city precision
66+
Geoip| ? | | wrapper around the [PHP extension](http://php.net/manual/en/book.geoip.php)
67+
[GeoPlugin](http://www.geoplugin.com/) | yes
68+
[GeoIPs](http://www.geoips.com/en/) | no | requires API key
69+
[MaxMind](https://www.maxmind.com/) web service | yes | requires Omni API key | City/ISP/Org and Omni services, IPv6 on country level
70+
MaxMind binary file | yes | | needs locally installed database files
71+
MaxMind [GeoIP2](https://www.maxmind.com/en/geoip2-databases) | yes |
5972

6073
The [Geocoder Extra](https://github.com/geocoder-php/geocoder-extra) library contains even more providers!
6174

0 commit comments

Comments
 (0)