API de Apple Maps
Apple Maps es el servicio de mapas de los dispositivos de Apple. places lee hasta 50 lugares en una sola llamada a partir de sus ID numéricos de Apple Maps y devuelve dirección, coordenadas, teléfono, web, categoría, horario semanal, servicios, fotos y valoración de cada uno.
Los ID salen de la columna apple_maps_id de los resultados de DuckDuckGo Maps o del auid de un enlace compartido de Apple Maps. Apple Maps suele mostrar valoraciones de sitios asociados, así que cada fila indica el sitio en rating_source. Una llamada cuesta lo mismo con un ID que con cincuenta.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Apple Maps, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Leer lugares de Apple Maps por IDplaces | Envía en place_ids entre 1 y 50 ID numéricos de Apple Maps y recibe una fila por lugar con name, address, lat, lng, phone, website, category, opening_hours, amenities, rating, review_count y rating_source. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Apple Maps?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
placesLeer lugares de Apple Maps por ID Envía en | place_ids | language | Entrega síncrona | — | $0.56 por 1.000 solicitudes | place_id · name · url · category · categories · address · city · state · postal_code · country_code · lat · lng · timezone · phone · website · rating · rating_scale · review_count · rating_source · price · open_state · opening_hours · amenities · image_urls · top_reviews · is_claimed · platform |
¿Qué significan los parámetros de Apple Maps places?
Envía en place_ids entre 1 y 50 ID numéricos de Apple Maps y recibe una fila por lugar con name, address, lat, lng, phone, website, category, opening_hours, amenities, rating, review_count y rating_source. Los ID desconocidos no devuelven fila y los que no son solo dígitos se rechazan antes de cobrar.
place_idsObligatorio- Lista de 1 a 50 ID numéricos de Apple Maps, como
["12971322601039101590"], tomados delapple_maps_idde las filas de DuckDuckGo Maps o delauidde un enlace de Apple Maps. La llamada cuesta lo mismo con un ID que con cincuenta; los ID que no son solo dígitos se rechazan antes de cobrar.Documentación para desarrolladores de Apple: identificar lugares únicos con Place ID — La documentación para desarrolladores de Apple indica que un Place ID identifica el mismo punto de interés durante toda su vida y sirve para obtener la información de ese lugar. La fuente solo confirma que los lugares de Apple Maps tienen identificadores únicos y estables; los `place_ids` de esta API son los ID solo numéricos (auid) que aparecen en los enlaces de Apple Maps, se escriben de otra forma que los Place ID alfanuméricos de MapKit y no se pueden intercambiar. No describe horarios, servicios ni valoraciones. · Consultada languageOpcional- Idioma de los datos del lugar, como
en-US,zh-CNoja-JP; también vale un código de dos letras comoen. Por defectoen-US.
Cómo usar la API de Apple Maps
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"apple_maps","action":"places","params":{"place_ids":"<place_ids>"}}'
Preguntas sobre la API de Apple Maps
¿Cómo llamo a la API de Apple Maps?
Envía POST /api/v1/social con platform igual a apple_maps, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Apple Maps?
Devuelve JSON estructurado. Por ejemplo, el esquema de places incluye place_id, name, category y categories. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Apple Maps?
La documentación para desarrolladores de Apple indica que un Place ID identifica el mismo punto de interés durante toda su vida y sirve para obtener la información de ese lugar. La fuente solo confirma que los lugares de Apple Maps tienen identificadores únicos y estables; los place_ids de esta API son los ID solo numéricos (auid) que aparecen en los enlaces de Apple Maps, se escriben de otra forma que los Place ID alfanuméricos de MapKit y no se pueden intercambiar. No describe horarios, servicios ni valoraciones.
¿Qué parámetros son obligatorios?
Depende de la acción. places requiere place_ids.
¿Las acciones de Apple Maps responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.