Integrating Your ArcGIS Online Layers with PHapp

Share a live ArcGIS feature layer (public, or private via a group invite to phapp‑integration@wehealth.org) and send PHapp its REST URL. We fetch GeoJSON automatically—no recurring file exports needed.

Integrating Your ArcGIS Online Layers with PHapp

Why share your ArcGIS data with PHapp?

PHapp lets you surface the maps you already maintain in ArcGIS Online—community boundaries, vaccination sites, emergency shelters, evacuation zones—directly inside the PHapp mobile and web experience.
By sharing a live feature layer once, you eliminate recurring CSV/GeoJSON exports and ensure the public always sees the freshest data.

At‑a‑Glance

Once shared, PHapp pulls your layer via the standard ArcGIS REST API (f=geojson) on an hourly or daily schedule. Updates you make in ArcGIS appear in PHapp automatically—no further action needed.

Step‑by‑Step Instructions

1  Locate your feature layer

1. Sign in to ArcGIS Online with an account that owns or can share the layer.

2. Open Content → My Content and click the layer name to open its Item Details page.

2  Set export permissions (one‑time)

1. On the Item Details page click Settings.

2. Scroll to Export Data and check “Allow others to export to different formats.”

3. Click Save.

3  Choose a sharing method

A. Public layer (simplest)

1. Back on the Item Details page, click Share.

2. Select Everyone (public) and click Save.

B. Private layer via group

1. If you don’t already have a secure sharing group, create one:

   • Navigate to Groups → Create Group.

   • Give it a clear name, e.g. “PHapp Integration.”

   • Leave Who can view this group? set to Only group members.

2. Add PHapp’s viewer account to the group:

   • On the group page click Invite members.

   • Enter phapp‑integration@wehealth.org and send the invite.

3. Share your layer to the group:

   • On the layer’s Item Details page click Share.

   • Check the PHapp Integration group and click Save.

4  Send PHapp the layer URL

1. On the Item Details page click View in API Resources (right panel).

2. Copy the Feature Layer (REST) URL that ends with /FeatureServer/0 (or another layer index if you have multiple).

3. Email or paste that URL in your PHapp onboarding form.

Example URL
https://services.arcgis.com/ABCD1234EFGH5678/ArcGIS/rest/services/County_COVID_Testing_Sites/FeatureServer/0

PHapp’s backend uses the URL to query your geometry and attributes as GeoJSON.

How PHapp accesses your data

• Authentication

  • Public layers: no login needed.

  • Private layers: PHapp logs in with phapp‑integration@wehealth.org (Viewer user‑type) and requests a short‑lived token.

• Query pattern

  …/FeatureServer/0/query
    ?where=1=1
    &outFields=*
    &outSR=4326
    &f=geojson

• Refresh cadence
  Default: every 24 hours. During emergencies we may temporarily pull every hour.
  Contact support if you need a custom schedule.

Common Questions

Does the Viewer account use my organization’s credits?

Viewer queries consume minimal service credits—usually less than 1 credit per 10,000 features per month. Most agencies never notice the usage.

Can PHapp edit or delete my data?

No. The Viewer user‑type is read‑only. It cannot create, update, or delete features or layers.

What if I need to revoke access?

Simply un‑share the layer or remove the Viewer account from the group. PHapp will stop receiving updates at the next refresh.

Can I share a hosted tile layer or map service instead?

PHapp currently requires feature layers to ingest data attributes alongside geometry. If you only have tiles, please publish a view layer or contact support.

My layer has more than 1,000 features—will it work?

Yes. PHapp paginates queries (resultOffset/resultRecordCount) until all features are retrieved.

Need help?

Contact Support Thank you for keeping your community’s data accessible and up‑to‑date! 🚀