Feature #3946
closedFeature #3945: User Story: Integrate Places API for Lead Location
User Story 1: Backend – Integrate Places API for New Jersey - #3945
0%
Description
As a Backend Developer
I want to integrate with a Places API (e.g., Google Places API, Mapbox) restricted to New Jersey
So that the frontend can fetch validated location suggestions for leads.
Acceptance Criteria
Create an API endpoint:
GET /api/places/search?query=<text>
Calls the external Places API.
Restrict results to New Jersey (USA) only.
Returns formatted address, city, state, zipcode, latitude, longitude.
Handle API failures gracefully:
Return an error response if external API fails.
Provide fallback message to frontend.
Performance & Security:
Use server-side API key securely (not exposed to frontend).
Add request throttling or caching to avoid exceeding API limits.
Test Scenarios
Hitting /api/places/search?query=Newark returns valid New Jersey locations.
Response includes formatted address + lat/long.
Requests outside NJ return no results.
Invalid query or API error returns meaningful error message.
Subtasks
Related issues