Find Cities with GeoDB Cities API

Pipedream makes it easy to connect APIs for GeoDB Cities and 2,400+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Find Cities with the GeoDB Cities API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

Create a workflow to Find Cities with the GeoDB Cities API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Find Cities action
1. Connect your GeoDB Cities account
2. Optional- Select one or more City Types
3. Optional- Configure Location
4. Optional- Configure Minimum Population
5. Optional- Configure Maximum Population
6. Optional- Select a Language Code
7. Optional- Configure Name Prefix
8. Optional- Configure Max Records
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Integrations#

Find Cities with GeoDB Cities API on New Requests from HTTP / Webhook API

HTTP / Webhook + GeoDB Cities

Try it

Find Cities with GeoDB Cities API on New Submission from Typeform API

Typeform + GeoDB Cities

Try it

Find Cities with GeoDB Cities API on New Submission (Instant) from Jotform API

Jotform + GeoDB Cities

Try it

Find Cities with GeoDB Cities API on New Custom Webhook Events from Stripe API

Stripe + GeoDB Cities

Try it

Find Cities with GeoDB Cities API on New Scheduled Tasks from Pipedream API

Pipedream + GeoDB Cities

Try it

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Find Cities on GeoDB Cities

Description:Find cities, filtering by optional criteria. If no criteria are set, you will get back all known cities with a population of at least 1000. [See the docs](https://rapidapi.com/wirefreethought/api/geodb-cities).

Version:0.0.1

Key:geodb_cities-find-cities

View on GitHub

Code#

import app from "../../geodb_cities.app.mjs";
import constants from "../../common/constants.mjs";
import utils from "../../common/utils.mjs";

export default {
  key: "geodb_cities-find-cities",
  name: "Find Cities",
  description: "Find cities, filtering by optional criteria. If no criteria are set, you will get back all known cities with a population of at least 1000. [See the docs](https://rapidapi.com/wirefreethought/api/geodb-cities).",
  type: "action",
  version: "0.0.1",
  props: {
    app,
    types: {
      type: "string[]",
      label: "City Types",
      description: "The type of city. Possible values are: `CITY` and `ADM2`.",
      optional: true,
      options: constants.CITY_TYPES,
    },
    location: {
      type: "string",
      label: "Location",
      description: "Only cities near this location. Latitude/Longitude in ISO-6709 format: `±DD.DDDD±DD.DDDD`. For example: `+51.5008-0.1247`.",
      optional: true,
    },
    minPopulation: {
      type: "integer",
      label: "Minimum Population",
      description: "Only cities having at least this population.",
      optional: true,
    },
    maxPopulation: {
      type: "integer",
      label: "Maximum Population",
      description: "Only cities having no more than this population.",
      optional: true,
    },
    languageCode: {
      propDefinition: [
        app,
        "languageCode",
      ],
    },
    namePrefix: {
      type: "string",
      label: "Name Prefix",
      description: "Only cities whose names start with this prefix. If **Language Code** is set, the prefix will be matched on the name as it appears in that language.",
      optional: true,
    },
    max: {
      type: "integer",
      label: "Max Records",
      description: "Max number of records in the whole pagination",
      optional: true,
      default: constants.DEFAULT_MAX_RECORDS,
      min: 1,
    },
  },
  methods: {
    listCities(args = {}) {
      return this.app.makeRequest({
        path: "/geo/cities",
        ...args,
      });
    },
  },
  async run({ $: step }) {
    const {
      types,
      location,
      minPopulation,
      maxPopulation,
      languageCode,
      namePrefix,
      max,
    } = this;

    const cities = await utils.streamIterator(
      this.app.getResourcesStream({
        max,
        resourceFn: this.listCities,
        resourceFnArgs: {
          step,
          params: {
            types: Array.isArray(types)
              ? types.join(",")
              : types,
            location,
            minPopulation,
            maxPopulation,
            languageCode,
            namePrefix,
          },
        },
      }),
    );

    step.export("$summary", `Successfully found ${cities.length} cities.`);

    return cities;
  },
};

Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
GeoDB Cities	`app`	`app`	This component uses the GeoDB Cities app.
City Types	`types`	`string[]`	Select a value from the drop down menu:`CITYADM2`
Location	`location`	`string`	Only cities near this location. Latitude/Longitude in ISO-6709 format: `±DD.DDDD±DD.DDDD`. For example: `+51.5008-0.1247`.
Minimum Population	`minPopulation`	`integer`	Only cities having at least this population.
Maximum Population	`maxPopulation`	`integer`	Only cities having no more than this population.
Language Code	`languageCode`	`string`	Select a value from the drop down menu:`endeesfritptruzh`
Name Prefix	`namePrefix`	`string`	Only cities whose names start with this prefix. If Language Code is set, the prefix will be matched on the name as it appears in that language.
Max Records	`max`	`integer`	Max number of records in the whole pagination