mapkit-geotoolbox

Unify coordinates, addresses, and MapKit items into a PlaceDescriptor.

4|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill mapkit-geotoolbox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mapkit-geotoolbox
Source: https://github.com/AutisticAF/claude-code-apple-dev-plugin/tree/main/skills/mapkit-geotoolbox
Command: npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill mapkit-geotoolbox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GeoToolbox PlaceDescriptor patterns provide a portable, interoperable way to represent places across MapKit and other services, enabling easy construction from coordinates, addresses, or MapKit items, plus forward and reverse geocoding and multi-service identifiers.

Core Features & Use Cases

  • Represent a place with coordinates and/or address using PlaceDescriptor representations (coordinate, address, commonName).
  • Convert between MKMapItem and PlaceDescriptor.
  • Geocode addresses to coordinates and reverse geocode coordinates to addresses using MKGeocodingRequest and MKReverseGeocodingRequest.
  • Attach service identifiers for cross-service interop (e.g., Apple Maps, Google Maps).
  • Read properties like coordinate, address, commonName, and service identifiers.

Quick Start

Create a PlaceDescriptor from a MapItem and read its coordinate, address, and common name.

Frequently Asked Questions about mapkit-geotoolbox

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

FAQPage Schema
How do I convert an MKMapItem to a portable location object in Swift?

Convert an MKMapItem to a PlaceDescriptor to unify coordinates, addresses, and common names into a single portable representation for interoperable location data across iOS and macOS apps.

What is the best way to represent places across multiple mapping services in iOS?

A PlaceDescriptor provides a portable way to represent places across services by attaching cross-service identifiers, enabling MapKit data to interoperate with platforms like Apple Maps and Google Maps.

How do I perform forward and reverse geocoding using MapKit in Swift?

Use MKGeocodingRequest to geocode addresses into coordinates and MKReverseGeocodingRequest to reverse geocode coordinates back into addresses, wrapping results in a PlaceDescriptor for unified access.

Does PlaceDescriptor work with both iOS and macOS apps using CoreLocation?

Yes, PlaceDescriptor requires MapKit and CoreLocation APIs to unify coordinates, addresses, and MapKit items, fully supporting interoperable location data across both iOS and macOS applications.

How do I read coordinates and addresses from a unified location object?

Read properties directly from a PlaceDescriptor, which exposes coordinate, address, commonName, and service identifiers to access unified location data constructed from addresses or MapKit items.