Create Distance Targeting Geometry

Why Create Distance Targeting Geometry?

Occasionally, you may wish to create very specific targeting for a flight using a predetermined distance from a street address. For example, if you want to target a certain locale where ads will be served within a narrow area, you can pinpoint an exact distance for your targeting by creating a distance targeting geometry object using Latitude, Longitude, and StreetAddress body parameters. The Kevel API enables you to create this object, which can then be used in your geo-targeting.

API Syntax

When using the Create Distance Targeting Geometry API endpoint, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:

POST https://api.kevel.co/v1/flight/{FlightID}/distance

Where:

  • POST - the type of API request being made.
  • https://api.kevel.co - the URL for the request.
  • v1 - the API version.
  • flight - the API endpoint being called.
  • FlightID - the ID associated with the flight.
  • distance - the distance targeting geometry object that contains the Distance, Latitude, Longitude, and StreetAddress body parameters used for distance targeting.
Path Params
int32
required

The ID of the flight

Body Params
float

The radius of the Distance geometry in kilometers. Min: 0.01, Max: 500. Optional on networks with user-specified radius features enabled; omit for user-specified radius.

float

The latitude of the Distance point. Saved up to 7 decimal places. Cannot be used with StreetAddress.

float

The longitude of the Distance point. Saved up to 7 decimal places. Cannot be used with StreetAddress.

string

The street address of the Distance point. This will be resolved to latitude and longitude. Cannot be used with Latitude and Longitude params.

Responses

Language
Credentials
Request
Choose an example:
application/json