API Evangelist Location API

This is a location API, providing many of the common building blocks of location for use in any application. Providing the essential location ingredients needed through a variety of applications, without having to reinvent the wheel each times it is needed. This API is still being working on, and not quite ready for prime time, but if you have any questions, visit the road map and support sections below the documentation

Getting Started

These are the steps you need to take when getting started using each service.

  1. Sign up - Where you can sign up for each service.
  2. Authentication - Where you can get details about authenticating with each service.
  3. Documentation - Where you can find documentation for each service.
  4. SDKs - Where you can find SDKs in multiple programming languages for each service.
  5. FAQ - Where you can get your common questions answered around each service.
  6. Support - Where you can get support for using each service.

If you have any questions, feel free to reach out, and I'll do my best to help.

Github

Login with your Github social coding platform account.

Twitter

Login / Sign Up with your Twitter social networking account.

LinkedIn

Login / Sign Up with your LinkedIn business social networking account.

Authentication For The APIs

This is the authentication for this API, providing you with the information you need to securely make API calls.

  • → x-api-key - Your API key.

We try to keep API authentication as simple as possible, while also ensuring the data we provide is securely accessed.

Documentation

This is the interactive API documentation for this API, and when you are authenticated, will allow you to make API calls, and see the responses for each API path.

This documentation is generated from the OpenAPI definition for this API, which you can use to publish, syndicate, and integrate with this API documentation elsewhere.

Definitions

We provide machine readable definitions for our APIs, allowing you to import into the service or tooling of your choice.

OpenAPI

Postman

Feel free to submit a pull request for these API definitions using GitHub, or submit an issue when you see something incomplete.

Code / Libraries / SDKs

These are the code samples, libraries, and SDKs we provide in a variety of programming languages, helping jumpstart your integration with the API.

  1. PHP - This is the PHP SDK for integrating with each service.
  2. Python - This is the Python SDK for integrating with each service.
  3. Ruby - This is the Ruby SDK for integrating with each service.
  4. Go - This is the Go SDK for integrating with each service.
  5. Java - This is the Java SDK for integrating with each service.
  6. C# - This is the C# SDK for integrating with each service.
  7. Node.js - This is the Node.js SDK for integrating with each service.
  8. JavaScript - This is the JavaScript SDK for integrating with each service.

If there isn't a language library you need available, make sure and let us know through one of the support channels, so we can consider for the road map.

Licensing

This is what you need to know regarding the licensing of resources that are available as part of each service, breaking down the license applied to each component.

Server Licensing

MIT

Data Licensing

ODbL

API Licensing

CC-BY

SDK Licensing

MIT

If you have any questions on licensing of code, data, or other aspect of each service, please use one of the support channels to give us more detail on your licensing query.

Plans

These are the plans for accessing each service, providing different tiers of access depending on your needs, and what is allowed for each service. Each plan should have the details you need to understand the limitations, as well as other elements provided for the service at this tier.

Starter

The default API access plan, where every new account begins, allowing the consumer to kick the tires, and see what the API is all about.

Details:

  - API Calls - The number of requests made to the API.

Elements:

  - Free
  - Self Service Support

Verified

Once you have added a credit card as part of the account billing, you become a verified API consumer, and have a higher rate limit for usage.

Details:

  - API Calls - The number of requests made to the API.

Elements:

  - Support
  - Sales
  - Security
  - SLA

Currently there are just two plans available, if you have more needs than what is here, use one of the support channels to let us know what it is that you need. There are other levels available, but this is the standard public offering for each service at this moment in time.

Support

We provide three ways in which you can receive support for this API, and have your questions answered as you are working to integrate it into your web or mobile application.

Email

GitHub Issues

Twitter

If your question is of the private nature please email us, for all other inquires please submit as GitHub issue if possible, so that others can learn from your question to.

FAQs

These are the frequently asked questions (FAQ) for each service, reflecting the questions most asked by consumers of each service.

Category One

  • Question One - This is the short, precise answer to question number one.
  • Question Two - This is the short, precise answer to question number two.

Category Two

  • Question One - This is the short, precise answer to question number one.
  • Question Two - This is the short, precise answer to question number two.

Category Three

  • Question One - This is the short, precise answer to question number one.
  • Question Two - This is the short, precise answer to question number two.

Category Four

  • Question One - This is the short, precise answer to question number one.
  • Question Two - This is the short, precise answer to question number two.

If you have a question, and you don't find the answer listed here, feel free to use one of the support channels above to get it answered.

Communication

Here are the communication channels provided to you, helping you stay in tune with what is changing with each service, and the overall platform behind it.

Blog

Twitter

Github

Workshops

These channels should provide you with a regular heartbeat of the changes being made, and what is being planned as part of this platform's operations.

Road Map

This is what we plan on doing in the near future when it comes to evolving each service, documenting the features we are planning to add to each service in future iterations.

Entries:

  • Roadmap Item (1/1/2019)- This is a description for the item.
  • Roadmap Item (1/1/2019)- This is a description for the item.
  • Roadmap Item (1/1/2019)- This is a description for the item.
  • Roadmap Item (1/1/2019)- This is a description for the item.

Suggest Road Map Item: Make Suggestion

We try to share as much information as possible about what changes will be occurring, helping you plan for your integration--make sure and share your thoughts about what you'd like to see.

Issues

These are the current issues that are outstanding for each service at the moment--letting you know that we are working hard to fix.

Entries:

  • Issue Item (1/1/2019)- This is a description for the item.
  • Issue Item (1/1/2019)- This is a description for the item.

Report An Issue: Report

We provide visibility into these issues because we want to be as transparent as possible with what is happening with the service.

Change Log

This is a detailed list of everything that has changed with this platform, providing you with the history of what has happened over time with each service.

Entries:

  • Change Log Item (1/1/2019)- This is a description for the item.
  • Change Log Item (1/1/2019)- This is a description for the item.
  • Change Log Item (1/1/2019)- This is a description for the item.
  • Change Log Item (1/1/2019)- This is a description for the item.

Showing our track record when it comes to changes being made to this platform, showing the work we've done to deliver on our road map, and satisfy all the open issue.

The Legal Department

This is the legal department for each service, with all the details you will need to comply with usage of each service.

Terms of Service

Privacy Policy

If you have any questions about the legal documents provided here, you can contact us through one of the support channels.