No longer maintained: I don't have time to update the scanner every time an API update happens, feel free to send PR's to update this yourself.
The fastest Pokémon Go map available.
Running on a beta implementation of the 0.53 api
Heavily using pgoapi. Shout-out to the Unknown6 team!
Note: If you are upgrading from the last version, you will have to update and/or reinstall the requirements.
- Clone the repository
git clone https://github.com/PokeHunterProject/pogom-updated.git
- Install the dependencies
pip install -r requirements.txt(if you have problems during this step, check these issues for help)
- Start the server by running
Pro-Tip: Use the
-P flag to specify host and port. E.g.
-H "127.0.0.1" -P 5001 will tell the webserver to listen to localhost requests on port 5001. You can then head over and take a look at the map at
http://127.0.0.1:5001/. If you want the server to listen on all public IPs use the host
0.0.0.0. This will allow you to access your server from other machines.
Everything else is configured through the Web UI!
Optional: You can tell PoGoMap to use MySQL or PostgreSQL. You will need to install a python interface for the database system of your choice (i.e.
pip install mysqlclient for MySQL or
pip install psycopg2 for PostgreSQL). You will also need to specify the
--db flag when starting
runserver.py and pass it a valid database url string as specified in the Peewee docs.
- Run the scanner with the argument -k for the hashing key (ex. python runserver.py -k abcd)
- On the first run you will be redirected to a configuration page
- Enter your Google Maps Api Key
- Enter all accounts and passwords to be used for scanning
- Optionally protect the configuration with a password (only authenticated users can access the config and change scan locations)
- Go back to
http://<ip>:<port>/to view the map
- Add scan locations simply by clicking on the map
- Extremely fast (using multiple accounts)
- Multiple locations (not recommended anymore)
- Perfect coverage (using a perfect hexagonal grid of radius 70m)
- Everything configurable from the browser (bye bye command-line flags)
- Hide common Pokemon
- Server status in the Web-GUI
- Stats about seen Pokemon
- Mobile friendly
- Browser Notifications
- Telegram notification with pogomBOT
- Latest hashing by using hashing keys (-k your_key_here)
- Webhooks/Pushbullet notifications
- Show/Hide Pokestops
The scan is too slow!
Due to Niantic's throttling we can only do one scan every 10 seconds from each account. Each scan only gives us the Pokemon in a 70 meter radius around the center. This means, to scan a radius of one kilometer, we actually need to scan about 250 individual locations. If you are using only five accounts, this will take about 500 seconds (
250/5*10s = 500s). With 100 accounts it will be finished in 25 seconds. So the solution is to add more accounts.
How many accounts should I use?
More = Better. But at about 200 accounts you will get diminishing returns because you're bottlenecked by other things (networking, parsing responses, DB). This is of course dependent on your system's performance, so your mileage may vary.
It should scan multiple locations in parallel!
The tool does scan all locations, but successively. Your actual problem is that you either have too few accounts or a too large area (see the calculation in the first question). Even if we change the order, the total runtime would stay the same.
I'm getting the error
Received valid response but without any data. Possibly rate-limited?
Niantic sometimes blocks accounts/IPs when they issue too many requests. In this case the server returns a perfectly valid response, but it contains no map data. The exact details of this are unknown! In rural areas you might get this error without being blocked, if there just aren't any map objects (pokemon, pokestops, spawnpoints) in the scanned area.
You can try to experiment with different settings (scanned area, no. of accounts) to get better results. We have an issue thread on the topic, check it out for more information.
I'm getting errors such as
Server seems to be busy or offline!,
Unexpected error during request: ...,
Received empty map_object response. Logging out and retrying.,
Request throttled by server... slow down man
A certain number of failing requests is to be expected, as the Niantic servers are still somewhat unstable. The program handles the errors gracefully and tries again for a few times until it succeeds. It prints the error messages for debugging purposes. Unless it is a fatal crash and not all the requests fail, everything is fine. Also check if the servers are maybe completely unavailable for you, before opening an issue.
I'm getting the error
Seems your IP Address is banned or something else went badly wrong
Niantic blocked the IPs of several popular cloud providers such as Amazon, Digital Ocean, Google, etc. Try it on a different server.