GEOCITIES | The fairest Geo API

The Project

Providing you with an API independent of the web giants, at a fair and controlled price.

Our need: Geocities API was born out of a technical need to be able to find geolocatable data at any time and at low cost. After researching similar services, we found that all the offerings, while qualitative, included tools that didn't meet our needs, at higher costs.
Our strategy: We want to offer a more targeted API, for services with basic geolocation needs. In this way, we can offer a product that's easy to implement and maintain, and with an affordable, controlled budget.
Our goal: Our desire to avoid the web giants was a major factor in the creation of Geocities API. It would indeed have been simpler just to use Google Maps API, but we prefer to make our own contribution to a decentralized web that doesn't imprison its users in abstract business models.

Features

List cities and zipcodes: Retrieve a list of cities or zipcodes based on multiple criteria, like name, population or distance.
Find nearest cities and zipcodes: Based on coordinates and a distance, we provide the list of data around.
Get details: Display data about the cities and zipcodes retrieved on your own products.

InternalController.php

view.html


<?php declare(strict_types=1);

use Symfony\Component\HttpClient\HttpClient;

namespace App\Controller;

class IndexController extends AbstractController
{
  public function __construct(private readonly HttpClientInterface $client) {}

  #[Route('/getMetaDescription', name: 'getMetaDescription')]
  public function fetchCityGeolocation(string $theme,string $countryCode, ?string $keyword, ?string $text ): Response
  {
    $queryParams = ['keyword' => $keyword, 'theme' => $theme, 'lang' => $countryCode,'text'=> $text];

   $response = $this->client->request('GET', 'https://ai.webexmachina.fr/api/generate/meta-description', ['query' => $queryParams]);

   return $this->json($response);
    }
}

Resources

Find resources about our API below.

Documentation

Find routes and settings to implement our API
Support

You found an issue, or need something that does not exist? Let us know on Github or by email!

Get the free plan

Enter your email address and quickly start to use the API

No credit card needed

Contact

A question? Get in touch!

Let us know if you have any questions or specific needs we can build in this API.

About Us

Who are we? A small team of professionals

We're a French communications agency, called Web ex Machina. We specialize in the development of web applications, APIs and custom interfaces for all sectors of activity.

Wherever possible, we develop generic solutions, using open-source technologies that can be reused in all our projects.

Here are a few examples:

INSERT HERE SOME EXAMPLES OF PROJECTS

Our expertise lies in our versatility and our ability to adapt to your business! We master all existing technologies, from Symfony to Wordpress, via Prestashop or Contao.

We attach great importance to Internet privacy and the GDPR. The Internet is a wonderful tool and should not be dependent on the goodwill of certain people. We strive to maintain this philosophy regardless of the circumstances or governments in place.

Where to find us?

FAQ

Here's a small selection of questions everyone ask us.

Features

Nothing is set in stone, but we're thinking of adding logical features such as address formatting and geocoding/forward geocoding/reverse geocoding.

Providing maps, tilesets, routing is not planned though. There are a lot of services online providing this kind of services and we prefer to focus on the quality of the data and on the reliability of the services we provide.

To use our API, you have to login with the appropriate request. Once you are authenticated, you can proceed to request our APIs though the system you want.

All results are returned in JSON. If you need a specific format, please get in touch and we will see what we can do about it.

Available commands are listed in our swagger.

You have to respect our services restrictions and quotas. If your quota is exceeded, the API will return an error with an explicit message.

Most of the time, your project does not require all the trouble Google asks. You have to setup a billing account to pay what knows at the end of the month. Policy changes every now and then and you never know where your data went.

Sure, Google provide good results, but we want to provide an alternative. By making a simpler system, using open-source geodata and respecting your privacy, we can offer you a specific tool for your specific need, at an affordable budget.

Our website and API are running on Infomaniak servers. We are working with Infomaniak since a few years now, for our other projects, websites, webapps and are satisfied with their services.

We also attach great importance to the ecological aspect of the services we offer. That's why we think Infomaniak is the best choice.

Read more about Infomaniak on their website: infomaniak.com

Log in to your account using this page and then you can update your data through this page.

Account & Billing

There are no constraints or deadlines for cancelling your subscription. Please note that we do not refund any costs incurred. Your subscription will end at the end of the current month or year, depending on the type of payment chosen.

As long as the constraints imposed by the free account are respected, we have no plans to remove this free access from the platform.

We want the free account to be free-for-life, as long as the associated restrictions are respected by our community.

The API works the same as the paid account, so you can try our services for free and then pick a subscription to go live.

As the product is still new, we will try our best to target a 100% uptime. We have 10 years of experience, hosting web related products. We are confident we will be able to maintain this product the same way we provide hosting solutions for our long-term customers.

We also plan to publish annual performances reports and monitor potential issues.

At last Geolocation
made easy!

The Project

Features

Resources

Documentation

Support