Esquema de URL do Apple Maps: referência completa para desenvolvedores

  • Referência para desenvolvedores
  • iOS · macOS · web
  • Atualizado em setembro de 2026

Resposta curta

O Apple Maps tem dois formatos de URL. O legado, maps.apple.com/?q=…&ll=…, funciona em todo lugar e é o que a maioria das ferramentas gera, inclusive a nossa. As URLs unificadas da Apple (/place, /search, /directions) exigem iOS 18.4, macOS 15.4 ou posterior. Converta um link do Google Maps.

Os dois formatos

  • Legado Funciona em todo lugar

    maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945&z=16

    • q: nome do lugar
    • ll: latitude,longitude
    • z: zoom

    É o que nosso conversor e a maioria das ferramentas geram. Abre o Apple Maps em dispositivos Apple e um mapa web nos demais.

  • Unificado iOS 18.4+ · macOS 15.4+

    maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower

    • caminho: a ação
    • coordinate
    • nome

    O formato mais novo da Apple, também no watchOS 11.4+. Um caminho por ação: lugar, busca, rotas e mais.

Converta um link agora

Cole qualquer link do Google Maps — lugar, alfinete, link curto ou rotas.

Uma lista inteira? Use o conversor de arquivos.

Parâmetros legados

Adicione-os depois de https://maps.apple.com/?, unidos com &.

ParâmetroO que fazExemplo
qNome do lugar ou texto de buscaq=Eiffel+Tower
llLatitude,longitude do alfinetell=48.8584,2.2945
zNível de zoomz=16
tTipo de mapa: m padrão, k satélite, h híbridot=k
saddrRotas: partidasaddr=Louvre+Museum
daddrRotas: destinodaddr=Eiffel+Tower
dirflgMeio de transporte: d carro, w a pé, r transporte públicodirflg=w

URLs unificadas do Apple Maps

Adicione um caminho e seus parâmetros a https://maps.apple.com/. Links curtos maps.apple redirecionam para estas URLs. Fonte: documentação da Apple.

CaminhoMostraParâmetros
/placeUm cartão de lugarcoordinate, name, address, place-id
/searchResultados da buscaquery, center, span
/directionsRotassource, destination, waypoint, mode (driving, walking, transit, cycling: carro, a pé, transporte público, bicicleta), avoid (tolls, highways: pedágios, rodovias)
/frameUma área do mapacenter, span
/look-aroundOlhe ao Redorcoordinate
/guidesGuias—

Exemplos para copiar e colar

# Legacy: works everywhere
https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945
https://maps.apple.com/?ll=48.8584,2.2945&t=k&z=17
https://maps.apple.com/?saddr=Louvre+Museum&daddr=Eiffel+Tower&dirflg=w

# Unified: iOS 18.4+, macOS 15.4+
https://maps.apple.com/place?coordinate=48.8584,2.2945&name=Eiffel%20Tower
https://maps.apple.com/search?query=coffee&center=48.8584,2.2945
https://maps.apple.com/directions?source=Louvre%20Museum&destination=Eiffel%20Tower&mode=walking

Em um app Swift, abra a URL. No iPhone e no iPad, ela abre o Apple Maps:

import UIKit

if let url = URL(string: "https://maps.apple.com/?q=Eiffel+Tower&ll=48.8584,2.2945") {
    UIApplication.shared.open(url)
}
URLs do Google Maps vs. URLs do Apple Maps
  • Coordenadas: o Google as coloca no caminho (/@48.8584,2.2945,15z); a Apple usa um parâmetro (ll=48.8584,2.2945, ou coordinate= nas URLs unificadas).
  • IDs de lugar: os do Google têm a forma ChIJ…; as URLs unificadas da Apple usam o próprio place-id. Um não se traduz no outro, então converter significa levar o nome e as coordenadas.

Veja formatos de URL do Google Maps para o lado do Google.

Abrir o Apple Maps a partir de um app sem URL

Em um app iOS ou macOS, o MKMapItem do MapKit pode abrir um lugar diretamente no Apple Maps com openInMaps(launchOptions:). Para sites, e-mails e tudo o que for multiplataforma, um link maps.apple.com é mais simples.

Perguntas frequentes

As URLs do Apple Maps funcionam no Android?

Sim. No Android, um link maps.apple.com abre o Apple Maps na web, no navegador — não há app.

Posso usar URLs do Apple Maps em e-mails?

Sim. Links maps.apple.com funcionam em qualquer cliente de e-mail. Em dispositivos Apple, eles abrem o Apple Maps diretamente.

Devo usar o formato legado ou o unificado?

Use o formato legado ?q=…&ll=… quando seus leitores puderem estar em sistemas mais antigos; é o que a maioria das ferramentas gera. Use URLs unificadas, como /place e /directions, quando puder contar com iOS 18.4, macOS 15.4 ou posterior.

Como transformo um link do Google Maps em uma URL do Apple Maps?

Cole-o no conversor desta página. Ele expande links curtos, lê o nome do lugar e as coordenadas e cria um link maps.apple.com no formato legado.

Guias relacionados