Core Service Functions

1. fetchLocalitySuggestions(input: string, countries?: string[])

• Description: Retrieves real-time autocomplete suggestions based on user input.
• Parameters:
  • input – User's text input (e.g., "Ams").
  • countries – Optional ISO 3166-1 alpha-2 codes to filter suggestions (default: "nl").
• Returns: A LocalitiesAutocompleteResponse object containing matching locations.
• Used in: Checkout pages, location filters, store locators

2. fetchLocalityDetails(publicId: string)

• Description: Fetches detailed information of a selected locality using its public_id.
• Parameters:
  • publicId – Unique identifier obtained from the autocomplete response.
• Returns: A LocalitiesDetailsResponse containing data like latitude, longitude, and locality structure.
• Usage:
  • Geocoding, address validation, mapping markers, route estimations.

References

• Woosmap Scope
• Woosmap Developer API Documentation