Em dispositivos com iOS 9 e versões mais recentes, é possível usar links universais para abrir o Google Maps quando você tiver um URL do Google Maps.
Use o esquema de URL do Google Maps para iniciar o aplicativo do Google Maps para iOS e fazer pesquisas, receber solicitações de rotas e mostrar visualizações de mapas. Quando você inicia o Google Maps, o identificador de pacote é enviado automaticamente como parte da solicitação.
O uso do esquema de URL do Google Maps não exige uma chave de API do Google.
Links universais e Google Maps
O Google Maps para iOS oferece suporte a links universais em dispositivos com iOS 9 ou mais recente.
Se o URL corresponder à expressão regular abaixo e o dispositivo estiver executando o iOS 9 ou mais recente, use o método openURL: diretamente.
(http(s?)://)?
((maps\.google\.{TLD}/)|
((www\.)?google\.{TLD}/maps/)|
(goo.gl/maps/))
.*
Por exemplo,
Swift
UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)
Objective-C
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];
Visão geral
Um esquema de URL permite iniciar um aplicativo iOS nativo de outro aplicativo iOS ou de um aplicativo da Web. É possível definir opções no URL que será transmitido ao aplicativo iniciado. O app Google Maps para iOS oferece suporte aos seguintes esquemas de URL:
comgooglemaps://
ecomgooglemaps-x-callback://
: esses esquemas permitem iniciar o app Google Maps para iOS e realizar uma das várias ações:- Exibir um mapa em um local e nível de zoom especificados.
- Procurar locais ou lugares e exibi-los em um mapa.
- Solicitar rotas de um local para outro. As rotas podem ser retornadas para quatro modos de transporte: carro, caminhada, bicicleta e transporte público.
- Adicione navegação ao app.
- Até o iOS 8, emita um callback na conclusão do app usando
comgooglemaps-x-callback://
. Os callbacks são usados com frequência para retornar um usuário ao app que abriu originalmente o Google Maps para iOS. No iOS 9, o sistema fornece automaticamente um link "Voltar para" no canto esquerdo da barra de status.
comgooglemapsurl://
: esse esquema permite iniciar o app Google Maps para iOS usando um URL derivado do site do Google Maps para desktops. Isso significa que é possível oferecer aos usuários uma experiência móvel nativa em vez de simplesmente carregar o site do Google Maps.- O URL original pode ser o URL de
maps.google.com
ou degoogle.com/maps
, ou usando qualquer domínio de nível superior do país válido em vez decom
. Também é possível transmitir URLs de redirecionamentogoo.gl/maps
. - Você pode emitir um callback usando os parâmetros
x-source
ex-success
com o esquema de URLcomgooglemapsurl://
.
- O URL original pode ser o URL de
Como iniciar o app Google Maps para iOS e executar uma função específica
Para iniciar o app Google Maps para iOS e, opcionalmente, executar uma das funções compatíveis, use um esquema de URL no seguinte formato:
comgooglemaps://?parameters
ou
comgooglemaps-x-callback://?parameters
Os parâmetros são descritos em detalhes posteriormente neste documento.
Como verificar a disponibilidade do app Google Maps no dispositivo
Antes de apresentar um desses URLs a um usuário no app, verifique se o aplicativo está instalado. O app pode verificar se o esquema de URL está disponível com o seguinte código:
Swift
UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)
Objective-C
[[UIApplication sharedApplication] canOpenURL:
[NSURL URLWithString:@"comgooglemaps://"]];
Por exemplo, para exibir um mapa do Central Park em Nova York, use o seguinte código:
Swift
if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
UIApplication.shared.openURL(URL(string:
"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
print("Can't use comgooglemaps://");
}
Objective-C
if ([[UIApplication sharedApplication] canOpenURL:
[NSURL URLWithString:@"comgooglemaps://"]]) {
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
NSLog(@"Can't use comgooglemaps://");
}
Exibir um mapa
Use o esquema de URL para exibir um mapa em uma localização e com o nível de zoom especificados. Você também pode sobrepor outras visualizações em cima de seu mapa ou exibir imagens do Street View.
Parâmetros
Todos os parâmetros a seguir são opcionais. Se nenhum parâmetro for definido, o esquema de URL vai abrir o app Google Maps para iOS.
center
: é o ponto central da visualização do mapa. Formatado como uma string separada por vírgulas delatitude,longitude
.mapmode
: define o tipo de mapa mostrado. Pode ser definido como:standard
oustreetview
. Se não for especificado, as configurações atuais do aplicativo serão usadas.views
: ativa/desativa visualizações específicas. Pode ser definido como:satellite
,traffic
outransit
. Vários valores podem ser definidos usando uma vírgula como separador. Se o parâmetro for especificado sem valor, todas as visualizações serão limpadas.zoom
: especifica o nível de zoom do mapa.
Este URL de exemplo mostra o mapa centralizado em Nova York com zoom 14 e com a visualização de trânsito ativada:
comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic
Confira outros exemplos:
comgooglemaps://?center=37.788463,-122.392545&zoom=12
comgooglemaps://?center=46.414382,10.013988&mapmode=streetview
Pesquisar
Use este esquema para exibir consultas de pesquisa em um local especificado da janela de visualização.
Parâmetros
Além dos parâmetros usados para exibir um mapa, a pesquisa aceita o parâmetro q
.
q
: a string de consulta da pesquisa.
Este é um exemplo de URL para pesquisar "Pizza" perto da localização especificada:
comgooglemaps://?q=Pizza¢er=37.759748,-122.427135
Confira outros exemplos:
comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA¢er=37.782652,-122.410126&views=satellite,traffic&zoom=15
comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan¢er=35.660888,139.73073&zoom=15&views=transit
Mostrar rotas
Use este esquema para solicitar e exibir rotas entre duas localizações. Você também pode especificar o meio de transporte.
Parâmetros
saddr
: define o ponto de partida para as pesquisas de rotas. Pode ser uma latitude,uma longitude ou um endereço formatado para consulta. Se for uma string de consulta que retorna mais de um resultado, o primeiro resultado será selecionado. Se o valor estiver em branco, a localização atual do usuário será usada.daddr
: define o ponto de chegada para as pesquisas de rotas. Tem o mesmo formato e comportamento desaddr
.directionsmode
: modo de transporte. Pode ser definido como:driving
,transit
,bicycling
ouwalking
.
O URL de exemplo mostra rotas de transporte público entre a Google NYC e o aeroporto JFK:
comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit
Confira outros exemplos:
comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA¢er=37.422185,-122.083898&zoom=10
comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States¢er=37.423725,-122.0877&directionsmode=walking&zoom=17
Como especificar um URL de callback
Para especificar um URL de callback, use o
esquema de URL comgooglemaps-x-callback://
. Esse esquema é compatível com a
especificação x-callback-url. Quando você chama o app Google Maps para iOS
com esse esquema, o app exibe um botão na parte superior da
tela. O toque nesse botão emite um callback para um URL que
você especificou.
As solicitações para o comgooglemaps-x-callback://
precisam ter o seguinte formato:
comgooglemaps-x-callback://?parameters
Parâmetros
O esquema de URL x-callback aceita os mesmos parâmetros que o esquema de URL comgooglemaps://
, com os parâmetros adicionais a seguir. Os dois parâmetros são
obrigatórios.
x-source
: o nome do aplicativo que envia a solicitação x-callback. Recomendamos usar nomes curtos.x-success
: o URL a ser chamado quando concluído. Muitas vezes, é um esquema de URL para o próprio app, permitindo que os usuários retornem ao aplicativo original.
O app precisa registrar o próprio esquema de URL para poder responder ao URL de callback.
- Verifique se o aplicativo registrou um esquema de URL que pode responder à solicitação de retorno de chamada.
- Transmita o rótulo do botão de retorno de chamada no parâmetro
x-source
. - Transmita o URL de retorno de chamada no parâmetro
x-success
.
O exemplo a seguir inicia o app Google Maps para iOS e exibe um mapa centralizado em Nova York. O app também exibe um botão com o rótulo "SourceApp".
Quando o botão "SourceApp" é clicado, o app do Google Maps para iOS emite
um callback para um esquema de URL fictício, sourceapp://?resume=true
.
comgooglemaps-x-callback://?center=40.765819,-73.975866&zoom=14
&x-success=sourceapp://?resume=true
&x-source=SourceApp
Da mesma forma que no esquema de URL comgooglemaps://
, primeiro verifique se
o app do Google Maps para iOS está disponível no dispositivo e permite
o esquema de URL x-callback. O app pode verificar se o esquema de URL está disponível
com o seguinte código:
Swift
UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)
Objective-C
[[UIApplication sharedApplication] canOpenURL:
[NSURL URLWithString:@"comgooglemaps-x-callback://"]];
Este é um exemplo de URL que permite aos usuários retornar ao app depois de pesquisar sobremesa.
comgooglemaps-x-callback://?q=dessert¢er=37.759748,-122.427135
&x-success=sourceapp://?resume=true
&x-source=Nom+Nom
Como adicionar navegação ao app
A inicialização do app Google Maps para iOS com uma solicitação de rotas é uma maneira fácil de
oferecer aos usuários acesso à navegação curva a curva no app. Você pode usar
os esquemas de URL comgooglemaps://
ou comgooglemaps-x-callback://
.
Este snippet de código mostra como usar o esquema comgooglemaps-x-callback://
para
solicitar rotas e retornar ao app quando o usuário estiver pronto. O
código vai fazer o seguinte:
- Verifique se o esquema de URL
comgooglemaps-x-callback://
está disponível. - Inicia o app Google Maps para iOS e solicita rotas para o aeroporto JFK na cidade de Nova York. Deixe o endereço de partida em branco para solicitar rotas a partir da localização atual do usuário.
- Adicione um botão com o rótulo "AirApp" ao app Google Maps para iOS. O rótulo
do botão é definido pelo parâmetro
x-source
. - Chame o esquema de URL fictício,
sourceapp://
, quando o usuário clicar no botão "Voltar".
Swift
let testURL = URL(string: "comgooglemaps-x-callback://")!
if UIApplication.shared.canOpenURL(testURL) {
let directionsRequest = "comgooglemaps-x-callback://" +
"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
"&x-success=sourceapp://?resume=true&x-source=AirApp"
let directionsURL = URL(string: directionsRequest)!
UIApplication.shared.openURL(directionsURL)
} else {
NSLog("Can't use comgooglemaps-x-callback:// on this device.")
}
Objective-C
NSURL *testURL = [NSURL URLWithString:@"comgooglemaps-x-callback://"];
if ([[UIApplication sharedApplication] canOpenURL:testURL]) {
NSString *directionsRequest = @"comgooglemaps-x-callback://" +
@"?daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York" +
@"&x-success=sourceapp://?resume=true&x-source=AirApp";
NSURL *directionsURL = [NSURL URLWithString:directionsRequest];
[[UIApplication sharedApplication] openURL:directionsURL];
} else {
NSLog(@"Can't use comgooglemaps-x-callback:// on this device.");
}
Como iniciar o app Google Maps para iOS em um URL do Google Maps para desktop
Se o app tem acesso a um URL existente do Google Maps, como em uma página da Web ou em um banco de dados, use esse esquema para abrir o URL no app Google Maps para iOS, oferecendo dessa forma a melhor experiência nativa aos usuários.
- Substitua o esquema
http://
ouhttps://
porcomgooglemapsurl://
. - Se você quiser usar um callback, inclua os parâmetros
x-source
ex-success
. Esse esquema é compatível com a especificação x-callback-url.
Formatos de URL do Google Maps compatíveis
O esquema comgooglemapsurl://
aceita URLs que correspondem a esta expressão regular, em que {TLD}
se refere a qualquer domínio de país de nível superior válido. As quebras
de linha foram adicionadas para maior clareza:
(http(s?)://)?
((maps\.google\.{TLD}/)|
((www\.)?google\.{TLD}/maps/)|
(goo.gl/maps/))
.*
Verificar a disponibilidade do app Google Maps
Primeiro, verifique se o app do Google Maps para iOS está disponível no dispositivo e permite o esquema de URL:
Swift
UIApplication.shared.canOpenURL(URL(string:"comgooglemaps-x-callback://")!)
Objective-C
[[UIApplication sharedApplication] canOpenURL:
[NSURL URLWithString:@"comgooglemapsurl://"]];
Exemplos
Exemplo de um URL genérico do Google Maps:
URL original do Google Maps:
https://www.google.com/maps/preview/@42.585444,13.007813,6z
Uso do esquema de URL:
comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z
Exemplo de um URL genérico do Google Maps:
URL original do Google Maps:
https://maps.google.com/?q=@37.3161,-122.1836
Uso do esquema de URL:
comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836
Exemplo de solicitação de rotas para a Tokyo Tower com x-callback:
URL original do Google Maps:
http://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
O exemplo a seguir inicia o app Google Maps para iOS e exibe um mapa
com rotas para a Tokyo Tower, como especificado no URL original do Google Maps
(acima). O app também exibe um botão com o rótulo
"SourceApp". Quando o botão "SourceApp" é clicado, o app do Google Maps para iOS
emite um callback para um esquema de URL fictício, sourceapp://?resume=true
.
comgooglemapsurl://maps.google.com/maps?f=d&daddr=Tokyo+Tower,+Tokyo,+Japan&sll=35.6586,139.7454&sspn=0.2,0.1&nav=1
&x-source=SourceApp
&x-success=sourceapp://?resume=true