geotoolbox

Creates portable location representations and handles forward/reverse geocoding with MapKit.

603|51|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/rshankras/claude-code-apple-skills --skill geotoolbox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geotoolbox
Source: https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/mapkit/geotoolbox
Command: npx skills add https://github.com/rshankras/claude-code-apple-skills --skill geotoolbox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies working with location data in Apple platforms by providing patterns for representing places, performing geocoding, and handling multi-service identifiers.

Core Features & Use Cases

  • Place Representation: Create and manage location data using PlaceDescriptor and PlaceRepresentation.
  • Geocoding: Convert addresses to coordinates (forward geocoding) and coordinates to addresses (reverse geocoding) using MKGeocodingRequest.
  • Service Identifiers: Store and retrieve identifiers for different mapping services (e.g., Apple Maps, Google Maps).
  • Use Case: You need to display a user's selected location on a map, store it with a unique identifier for Google Maps, and later retrieve its address.

Quick Start

Use the geotoolbox skill to convert the address 'One Apple Park Way, Cupertino, CA' into coordinates.

Frequently Asked Questions about geotoolbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert an address to coordinates using MapKit forward geocoding?

Forward geocoding in MapKit converts a street address into geographic coordinates using MKGeocodingRequest. GeoToolbox provides patterns to construct place representations from address strings, returning precise latitude and longitude for mapping applications.

What is the best way to store cross-platform location identifiers for Apple Maps and Google Maps?

Storing cross-platform location identifiers requires multi-service place identifiers. GeoToolbox handles this by mapping service-specific identifiers for Apple Maps and Google Maps to a unified PlaceDescriptor, enabling seamless retrieval across different mapping platforms.

How does reverse geocoding work for coordinates to addresses on Apple platforms?

Reverse geocoding translates geographic coordinates back into human-readable addresses using MKGeocodingRequest. GeoToolbox simplifies this by converting raw latitude and longitude points into structured PlaceDescriptor objects containing street, city, and region data.

Can I use PlaceDescriptor for portable location representation in Swift?

Yes, PlaceDescriptor enables portable location representation in Swift. GeoToolbox constructs PlaceDescriptor instances from coordinates, addresses, or MapKit items, providing a consistent data model for handling location across different Apple platform services.

Do I need external dependencies to perform geocoding with GeoToolbox?

No external dependencies are required. GeoToolbox relies solely on Apple's native MapKit framework and its built-in MKGeocodingRequest APIs to perform forward and reverse geocoding tasks on Apple platforms without third-party libraries.

When do I need to use a PlaceDescriptor instead of raw coordinates?

Use PlaceDescriptor instead of raw coordinates when you need to display a user's selected location on a map, store multi-service identifiers, or retrieve associated address data. It provides a richer, portable location context than simple latitude and longitude.