O2 Location Text Assistant

Description

Every location is different, but researching and writing each one takes time.

O2 Location Text Assistant helps editors create location-aware drafts from selected buildings, points, and areas on the map. The plugin adds a map-based content generation interface to the WordPress editor. Editors can select a building polygon, draw a polygon, or draw a point, fetch Environmental Data and Map Data, and generate location-aware text for posts and pages.

O2 Location Text Assistant is designed for building-level and area-level writing workflows, including real estate descriptions, local marketing copy, tourism and area guides, education pages, environmental context writing, geo-aware advertising text, and location-based editorial content.

O2 Location Text Assistant is designed for global use and can work with large-scale building footprint data, including datasets with more than two billion building features worldwide.

External services are disabled by default. A site manager must enable External Services in the plugin settings before the plugin contacts the O2 API, loads external map tiles, performs place search, starts checkout, retrieves remote data, or generates text.

After External Services are enabled, the plugin connects to the O2 API operated by Otani & Co., Inc. to retrieve building polygons, geospatial summaries, environmental summaries, account status, credit information, checkout sessions, and generated text.

Main Features

• Interactive MapLibre map inside the WordPress editor
• Place search and base map style switching
• Building polygon loading and selection
• Custom polygon and point drawing
• Right-side editor panel with selected feature information
• Environmental Data and Map Data fetching
• AI-assisted generated content panel
• Copy and insert buttons
• Account status and credit display
• Stripe checkout support for upgrades and extra credits
• Configurable polygon and drawing styles
• Frontend shortcode map rendering

External Services

This plugin connects to external services to provide location-aware content generation, map display, place search, account status, checkout, and data retrieval. External services are disabled by default and must be enabled by a site manager in the plugin settings before these remote requests are made.

Otani & Co., Inc. O2 API

This plugin connects to the O2 API operated by Otani & Co., Inc. to retrieve building polygons, environmental summaries, map-data summaries, account status, credit usage, checkout sessions, and generated text.

Data sent to Otani & Co., Inc. may include the site host, site URL, plugin origin, plugin version, site API token, WordPress administrator email address, installer email address when available, selected geographic coordinates, selected feature geometry and properties, selected map area or bounding box, editor form inputs, account request information, and credit-related request information.

After External Services are enabled, the plugin contacts the O2 API when a site manager connects the site, verifies account status, retrieves building/map/environmental data, starts checkout, or generates text. The plugin does not contact the Otani & Co., Inc. public configuration endpoint before External Services are enabled and the site has been connected.

Service provider: Otani & Co., Inc.
Plugin page: https://otani.co/o2-location-text-assistant/
O2 API endpoint: https://otani.co/o2.api
Public configuration endpoint, used after site connection: https://otani.co/o2-location-text-assistant-config.json
Terms of Service: https://otani.co/en/terms-of-service/
Privacy Policy: https://otani.co/en/privacy-policy/

OpenStreetMap tile servers

After External Services are enabled, this plugin loads map tiles from OpenStreetMap tile servers to display maps in the editor and in frontend shortcode output.

When a map is displayed, the user’s browser may send the user’s IP address, browser metadata, and map tile coordinates to OpenStreetMap tile servers.

Service provider: OpenStreetMap Foundation and related tile infrastructure.
Tile Usage Policy: https://operations.osmfoundation.org/policies/tiles/
Privacy Policy: https://osmfoundation.org/wiki/Privacy_Policy

Nominatim / OpenStreetMap search

After External Services are enabled, this plugin uses Nominatim search to search for places in the editor map.

When a user performs a place search, the user’s browser sends the search query, IP address, and browser metadata to Nominatim.

Service provider: OpenStreetMap Foundation / Nominatim.
Nominatim Usage Policy: https://operations.osmfoundation.org/policies/nominatim/
Privacy Policy: https://osmfoundation.org/wiki/Privacy_Policy

Stripe

When a site manager starts an upgrade or credit purchase flow, the plugin requests a Stripe Checkout session through the O2 API operated by Otani & Co., Inc. and opens Stripe Checkout in a new browser window.

Stripe may process payment-related data according to Stripe’s own terms and privacy policy.

Service provider: Stripe, Inc.
Terms of Service: https://stripe.com/legal
Privacy Policy: https://stripe.com/privacy

Setup

The plugin does not connect to external services automatically during activation. External Services are disabled by default.

To enable remote maps, place search, O2 API requests, account connection, checkout, data retrieval, and text generation, open the O2 Location Text Assistant settings page, review the External Services disclosure, check Enable external services, and save settings.

To use O2 API services after enabling External Services, click Connect O2 Location Text Assistant. The connection process sends site information to Otani & Co., Inc., creates a site API token, stores the token in WordPress plugin settings, sends a verification email, and activates API access after email verification.

If the verification email does not arrive, check the spam or junk folder.

The API token is stored locally in WordPress. Otani & Co., Inc. stores only the token hash.

Usage

Selecting a feature

1. Open a post or page editor.
2. Search for a location on the map.
3. Zoom in until building polygons are displayed.
4. Click a building polygon, or draw a polygon or point.
5. The right-side panel updates with selected feature information.

Fetching data

Inside the right-side editor panel:

• Click the fetch button in Environmental Data to retrieve an environmental summary.
• Click the fetch button in Map Data to retrieve a map-data summary.

Generating content

1. Select a feature.
2. Set template, industry, tone, language, length, and details.
3. Click Generate Text.
4. Copy or insert the generated content.

Privacy

O2 Location Text Assistant sends selected geographic data and form inputs to Otani & Co., Inc. for processing.

Data may include site domain, site URL, API token, selected geometry, selected feature properties, coordinates, bbox, text generation settings, user-entered notes, and account or credit status request data.

The plugin does not send WordPress post content unless the user explicitly includes it in form fields or generated content workflows.

Browser-side map display and place search may contact third-party map and search services as described in the External Services section, but only after External Services have been enabled by a site manager.

When External Services are enabled, the editor map loads raster map tiles from the selected map tile provider. The built-in default map style uses OpenStreetMap tiles from https://tile.openstreetmap.org/.

OpenStreetMap data is open, but the public OpenStreetMap tile servers are shared infrastructure with usage limits and tile usage policies. Site owners are responsible for ensuring that their selected tile provider is appropriate for their traffic volume and use case.

The plugin also allows administrators to configure custom map tile URLs or MapLibre style URLs. Only configure tile providers that you are allowed to use.

License

This plugin is licensed under the GPLv2 or later.

Third-party library license information is provided in third-party-licenses.txt.

O2 Location Text Assistant is developed by Otani & Co., Inc.