Merge pull request #16 from mapbox/cw/add-readmes

add missing READMEs

Author: chriswhong

android-location-search/README.md

@@ -0,0 +1,29 @@
+## Add Location Search to an Android app
+
+This is supporting code for the Mapbox [tutorial on adding location search to an Android app](https://docs.mapbox.com/help/tutorials/android-location-search). This demo application helps developers understand how to use [Mapbox Search SDK for Android](https://docs.mapbox.com/android/search) with the [Mapbox Maps SDK for Android](https://docs.mapbox.com/android/maps) in an Android application using Jetpack Compose.
+
+The app demonstrates basic functionality including:
+
+- Rendering a full screen map with Mapbox Standard style using Jetpack Compose
+- Implementing location search with autocomplete using Mapbox Search SDK
+- Creating a floating search interface with real-time suggestions
+- Adding markers to the map for selected search results using PointAnnotation
+- Animating the map camera to fly to selected locations with smooth transitions
+- Search suggestion handling with proper result selection callbacks
+
+### Requirements
+- A [Mapbox Account](https://console.mapbox.com) and Access Token
+- Android Studio
+
+#### Add your Access Token 
+As outlined in the [Install Guide](https://docs.mapbox.com/android/maps/guides/install/) you **must** configure your public token to make requests to Mapbox services. Find the `res/values/mapbox_access_token.xml` file and replace `YOUR_MAPBOX_ACCESS_TOKEN` with your public token. Find your token in the [Mapbox Console](https://console.mapbox.com).
+
+### Key Features
+
+**Location Search**: The app uses Mapbox's Search Engine with SearchBox API to provide real-time search suggestions as users type. The implementation includes proper callback handling for both suggestions and result selection.
+
+**Modern UI**: Built with Jetpack Compose, the app features a floating search interface that overlays the map using Box layout and zIndex for proper layering.
+
+**Map Integration**: Selected search results are displayed as custom markers on the map using PointAnnotation, with MapViewportState handling smooth camera animations to the selected location.
+
+**Comprehensive Implementation**: The code demonstrates proper integration patterns for combining Mapbox Search SDK with Maps SDK in a Compose-based Android application, including state management and UI composition best practices.

android-markers-from-geojson/README.md

@@ -0,0 +1,28 @@
+## Build an Android marker app using GeoJSON data
+
+This is supporting code for the Mapbox [tutorial on building an Android marker app using GeoJSON data](https://docs.mapbox.com/help/tutorials/android-markers-from-geojson/). This demo application helps developers understand how to use [Mapbox Maps SDK for Android](https://docs.mapbox.com/android/maps) in an Android application using Jetpack Compose with external GeoJSON data.
+
+The app demonstrates a common UX pattern for Android mapping applications including:
+
+- Rendering a full screen map with Mapbox Standard style using Jetpack Compose
+- Loading and displaying markers from external GeoJSON data
+- Adding custom markers for multiple coffee shop locations in Providence
+- Implementing tap interactions to show detailed information about each marker
+- Using ModalBottomSheet to present additional business information in a slide-in UI panel
+- Parsing GeoJSON properties to display location details (name, address, phone number)
+
+### Requirements
+- A [Mapbox Account](https://console.mapbox.com) and Access Token
+- Android Studio
+
+#### Add your Access Token 
+As outlined in the [Install Guide](https://docs.mapbox.com/android/maps/guides/install/) you **must** configure your public token to make requests to Mapbox services. Find the `res/values/mapbox_access_token.xml` file and replace `YOUR_MAPBOX_ACCESS_TOKEN` with your public token. Find your token in the [Mapbox Console](https://console.mapbox.com).
+
+### Key Features
+
+**GeoJSON Integration**: The app demonstrates how to load and parse external GeoJSON data containing point features for coffee shop locations, including custom properties for business information.
+
+**Interactive Markers**: Each coffee shop location is displayed as a custom marker on the map. Users can tap markers to reveal additional information about the business.
+
+**Modern UI with ModalBottomSheet**: Built with Jetpack Compose, the app uses Material3's ModalBottomSheet component to create a smooth slide-in interface for displaying detailed location information.
+

android-markers-from-geojson/README.txt

@@ -0,0 +1,29 @@
+## Add Location Search to an iOS app
+
+This is supporting code for the Mapbox [tutorial on adding location search to an iOS app](https://docs.mapbox.com/help/tutorials/ios-location-search). This demo application helps developers understand how to use [Mapbox Search SDK for iOS](https://docs.mapbox.com/ios/search) with the [Mapbox Maps SDK for iOS](https://docs.mapbox.com/ios/maps) in an iOS application using SwiftUI.
+
+The app demonstrates basic functionality including:
+
+- Rendering a full screen map with Mapbox Standard style
+- Implementing location search with autocomplete using Mapbox Search SDK
+- Creating a floating search interface with real-time suggestions
+- Adding markers to the map for selected search results
+- Animating the map camera to fly to selected locations with smooth transitions
+- Geographic search biasing with bounding box and proximity parameters
+
+### Requirements
+- A [Mapbox Account](https://console.mapbox.com) and Access Token
+- Xcode
+
+#### Add your Access Token 
+As outlined in the [Install Guide](https://docs.mapbox.com/ios/maps/guides/install/) you **must** configure your public token to make requests to Mapbox services. Add your access token to the `Info.plist` file and replace `YOUR_MAPBOX_ACCESS_TOKEN` with your public token. Find your token in the [Mapbox Console](https://console.mapbox.com).
+
+### Key Features
+
+**Location Search**: The app uses Mapbox's PlaceAutocomplete API to provide real-time search suggestions as users type. The search is geographically biased to the Toronto, Canada area for demonstration purposes, but can be easily modified for any region.
+
+**Interactive UI**: Built with SwiftUI, the app features a floating search interface that overlays the map, providing an intuitive user experience for location discovery.
+
+**Map Integration**: Selected search results are displayed as custom markers on the map, with smooth camera animations that fly to the selected location at an appropriate zoom level.
+
+**Comprehensive Comments**: The code includes detailed explanatory comments making it perfect for learning how to integrate Mapbox Search functionality into iOS applications.