Присоединяйтесь к нам на следующем Дне сообщества разработчиков платформы Google Карт в Сан-Франциско в декабре. Чтобы принять участие, подайте заявку.

Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Схема URL Google Карт для iOS

На устройствах с iOS 9 и более поздних версий можно использовать универсальные ссылки, чтобы запускать Google Карты с помощью URL.

С помощью схемы URL Google Карт можно запускать приложение "Google Карты" для iOS, выполнять поиск, запрашивать маршруты и просматривать карты. При запуске Google Карт идентификатор пакета автоматически отправляется в составе запроса.

Для использования схемы URL Google Карт ключ Google API не требуется.

Примечание. URL Карт позволяют создавать универсальные межплатформенные ссылки для запуска Google Карт. Они поддерживают поиск, просмотр маршрутов, а также разные представления карт и панорамные изображения. Для запуска Google Карт рекомендуем использовать кросс-платформенные URL Карт, поскольку эти универсальные URL позволяют обрабатывать запросы для карт независимо от платформы пользователя. Схему URL Карт для iOS следует использовать только для функций, которые могут работать только на мобильной платформе (например, пошаговая навигация).

Универсальные ссылки и Google Карты

Приложение "Google Карты" для iOS поддерживает универсальные ссылки на устройствах с iOS 9 и более поздними версиями.

Если ваш URL соответствует следующему регулярному выражению, а на устройстве установлена iOS 9 или более поздней версии, вы можете использовать метод openURL: напрямую.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Пример:

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"]];

Обзор

Схема URL позволяет запускать приложение iOS из другого приложения iOS или веб-приложения. В URL можно задать параметры, которые будут переданы запущенному приложению. Приложение "Google Карты" для iOS поддерживает следующие схемы URL:

comgooglemaps:// – эта схема позволяет запустить приложение "Google Карты" для iOS и выполнить одно из следующих действий:
- Отображать на карте определенную область с заданным масштабом.
- Находить и отображать на карте определенные места.
- Запрашивать маршруты между пунктами Маршруты можно прокладывать для четырех способов передвижения: на автомобиле, пешком, на велосипеде и на общественном транспорте.
- Добавьте навигацию в приложение.
comgooglemapsurl:// – эта схема позволяет запустить приложение "Google Карты" для iOS, используя URL, полученный с сайта Google Карт для компьютеров. Это означает, что вы можете предоставить пользователям мобильный интерфейс, а не загружать сайт Google Карт.
- Исходный URL может относиться к maps.google.com или google.com/maps, а вместо com может использоваться любой действительный национальный домен верхнего уровня. Вы также можете передавать URL переадресации goo.gl/maps.

Запустить приложение "Google Карты" для iOS и выполнить определенную функцию

Чтобы запустить приложение "Google Карты" для iOS и выполнить одну из поддерживаемых функций, используйте схему URL следующего вида:

comgooglemaps://?parameters

Более подробное описание параметров приводится далее в этом документе.

Проверьте, доступно ли приложение "Google Карты" на устройстве.

Прежде чем показывать пользователю в приложении один из этих URL, убедитесь, что приложение установлено. Чтобы проверить, доступна ли схема URL, используйте следующий код:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

Например, чтобы показать карту Центрального парка в Нью-Йорке, можно использовать следующий код:

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://");
}

Отображение карты

Используйте схему URL-адреса, чтобы отобразить карту в указанном месте с указанным масштабом. Кроме того, на карту можно добавить наложения или изображения просмотра улиц.

Параметры

Все приведенные ниже параметры являются необязательными. Если параметры не заданы, схема URL запустит приложение "Google Карты" для iOS.

center – центральная точка области просмотра карты. Форматируется как строка latitude,longitude с разделителями-запятыми.
mapmode задает тип карты. Допустимые значения: standard или streetview. Если не указано, будут использоваться текущие настройки приложения.
views – включает или отключает определенные режимы просмотра. Возможные значения: satellite, traffic или transit. Можно указать несколько значений, разделяя их запятыми. Если параметр указан без значения, будут удалены все представления.
zoom – уровень масштабирования карты.

В этом примере URL карта центрируется на Нью-Йорке с масштабом 14 и включенным режимом просмотра трафика:

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

Данные о загруженности дорог в Нью-Йорке

Вот ещё несколько примеров:

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Поиск

С помощью этой схемы можно отобразить поисковые запросы в пределах указанной области просмотра.

Параметры

Помимо параметров, используемых для отображения карты, Search поддерживает параметр q.

q – строка запроса для поиска.

Пример URL для поиска пиццерий рядом с указанным местоположением:

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

Ближайшие пиццерии

Вот ещё несколько примеров:

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

Показать маршрут

Используйте эту схему, чтобы запрашивать и отображать маршруты из одного места в другое. Также можно указать способ передвижения.

Параметры

saddr – задает начальную точку для поиска маршрутов. Это могут быть координаты широты и долготы или адрес в формате запроса. Если строка запроса возвращает несколько результатов, будет выбран первый из них. Если значение не указано, будет использоваться текущее местоположение пользователя.
daddr – задает конечную точку для поиска маршрутов. Имеет тот же формат и поведение, что и saddr.
directionsmode – способ передвижения. Допустимые значения: driving, transit, bicycling или walking.

В примере ниже показан URL маршрута на общественном транспорте между офисом Google в Нью-Йорке и аэропортом имени Джона Кеннеди:

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

Маршруты общественного транспорта

Вот ещё несколько примеров:

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=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&center=37.423725,-122.0877&directionsmode=walking&zoom=17

Запуск приложения "Google Карты" для iOS с запросом маршрута позволяет пользователям вашего приложения получить доступ к пошаговой навигации. Для этого можно использовать схему URL comgooglemaps://.

Как запустить приложение "Google Карты" для iOS, используя URL компьютерной версии Google Карт

Если у вашего приложения есть доступ к существующему URL Google Карт, например на веб-странице или в базе данных, вы можете использовать эту схему, чтобы открыть URL в приложении "Google Карты" для iOS, обеспечив пользователям максимальное удобство.

Замените схему http:// или https:// на comgooglemapsurl://.

Поддерживаемые форматы URL Google Карт

Схема comgooglemapsurl:// поддерживает URL, соответствующие этому регулярному выражению, где {TLD} – любой действительный национальный домен верхнего уровня. Для наглядности мы добавили переносы строк:

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Проверьте доступность приложения "Google Карты"

Сначала убедитесь, что на устройстве установлено приложение "Google Карты" для iOS и что оно поддерживает схему URL.

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemapsurl://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

Примеры

Пример общего URL Google Карт:

Исходный URL-адрес для Google Maps:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

Использование схемы URL-адреса:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

Пример общего URL Google Карт:

Исходный URL-адрес для Google Maps:

https://maps.google.com/?q=@37.3161,-122.1836

Использование схемы URL-адреса:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836

Схема URL Google Карт для iOS Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Универсальные ссылки и Google Карты

Swift

Objective-C

Обзор

Запустить приложение "Google Карты" для iOS и выполнить определенную функцию

Проверьте, доступно ли приложение "Google Карты" на устройстве.

Swift

Objective-C

Swift

Objective-C

Отображение карты

Поиск

Показать маршрут

Добавьте навигацию в приложение

Как запустить приложение "Google Карты" для iOS, используя URL компьютерной версии Google Карт

Поддерживаемые форматы URL Google Карт

Проверьте доступность приложения "Google Карты"

Swift

Objective-C

Примеры

Схема URL Google Карт для iOS