Dodaj mapę ze znacznikiem

Ten samouczek pokazuje, jak dodać do aplikacji na iOS prostą mapę Google ze znacznikiem. Jest przeznaczona dla osób o początkowej lub średniozaawansowanej wiedzy w zakresie języka Swift lub Objective-C oraz ogólnej wiedzy o Xcode. Zaawansowany przewodnik tworzenia map znajdziesz w przewodniku dla programistów.

Za pomocą tego samouczka utworzysz następującą mapę. Znacznik znajduje się w Sydney.

Pobierz kod

Skopiuj lub pobierz repozytorium przykładowych Map Google na iOS z GitHuba.

Możesz też kliknąć następujący przycisk, aby pobrać kod źródłowy:

Podaj mi kod

Swift

/*
 * Copyright 2020 Google Inc. All rights reserved.
 *
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 * file except in compliance with the License. You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 * ANY KIND, either express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.
        let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}

      

Objective-C

/*
* Copyright 2020 Google Inc. All rights reserved.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
* file except in compliance with the License. You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under
* the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
* ANY KIND, either express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end

      

Rozpocznij

Menedżer pakietów Swift

Pakiet Maps SDK na iOS można zainstalować za pomocą menedżera pakietów Swift.

1. Upewnij się, że wszystkie zależności od pakietu Maps SDK na iOS zostały usunięte.
2. Otwórz okno terminala i przejdź do katalogu tutorials/map-with-marker.
3. Zamknij obszar roboczy Xcode i uruchom te polecenia:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all
   rm Podfile
   rm map-with-marker.xcworkspace

4. Otwórz projekt Xcode i usuń plik podfile.
5. Kliknij Plik > Dodaj zależności pakietu.
6. Jako URL wpisz https://github.com/googlemaps/ios-maps-sdk, naciśnij Enter, aby pobrać pakiet, i kliknij Dodaj pakiet.
7. Może być konieczne zresetowanie pamięci podręcznej pakietów. W tym celu kliknij Plik > Pakiety > Zresetuj pamięć podręczną pakietów.

Używaj CocoaPods

1. Pobierz i zainstaluj Xcode w wersji 15.0 lub nowszej.
2. Jeśli nie masz jeszcze aplikacji CocoaPods, zainstaluj ją w systemie macOS, uruchamiając w terminalu to polecenie:

   sudo gem install cocoapods

3. Przejdź do katalogu tutorials/map-with-marker.
4. Uruchom polecenie pod install. Spowoduje to zainstalowanie pakietu Maps SDK określonego w tabeli Podfile wraz z wszystkimi zależnościami.
5. Uruchom pod outdated, aby porównać wersję zainstalowanego poda z wszystkimi nowymi aktualizacjami. Po wykryciu nowej wersji uruchom polecenie pod update, aby zaktualizować Podfile i zainstalować najnowszy pakiet SDK. Więcej informacji znajdziesz w przewodniku CocoaPods.
6. Otwórz (kliknij dwukrotnie) plik map-with-marker.xcworkspace projektu, aby otworzyć go w Xcode. Aby otworzyć projekt, musisz użyć pliku .xcworkspace.

Uzyskiwanie klucza interfejsu API i włączanie niezbędnych interfejsów API

Aby ukończyć ten samouczek, potrzebujesz klucza interfejsu API Google z uprawnieniami do korzystania z pakietu SDK Maps na iOS. Aby uzyskać klucz i aktywować interfejs API, kliknij przycisk poniżej.

Rozpocznij

Więcej informacji znajdziesz w artykule na temat uzyskiwania klucza interfejsu API.

Dodawanie klucza interfejsu API do aplikacji

Dodaj klucz interfejsu API do AppDelegate.swift w ten sposób:

1. Pamiętaj, że do pliku dodano tę instrukcję importu:

   import GoogleMaps

2. Zmień ten wiersz w metodzie application(_:didFinishLaunchingWithOptions:), zastępując YOUR_API_KEY swoim kluczem interfejsu API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Uwaga: przykładowy kod ukończonego samouczka jest skonfigurowany do uruchamiania jako projekt Swift Xcode, ale zawiera przykłady w języku Swift i Objective-C.

Tworzenie i uruchamianie aplikacji

1. Podłącz urządzenie z iOS do komputera lub wybierz symulator z menu schematu Xcode.
2. Jeśli używasz urządzenia, upewnij się, że są włączone usługi lokalizacyjne. Jeśli używasz symulatora, wybierz lokalizację z menu Funkcje.
3. W Xcode kliknij opcję menu Product/Run (Produkt/Uruchom) (lub ikonę przycisku odtwarzania).
• Xcode tworzy aplikację, a następnie uruchamia ją na urządzeniu lub w symulatorze.
• Powinna wyświetlić się mapa ze znacznikiem wyśrodkowana na Sydney na wschodnim wybrzeżu Australii, podobnie jak na tej stronie.

Rozwiązywanie problemów:

• Jeśli nie widzisz mapy, sprawdź, czy udało Ci się uzyskać klucz interfejsu API i dodać go do aplikacji w sposób opisany powyżej. Sprawdź, czy w konsoli debugowania Xcode są komunikaty o błędach dotyczące klucza interfejsu API.
• Jeśli klucz interfejsu API został ograniczony przez identyfikator pakietu na iOS, edytuj klucz, aby dodać identyfikator pakietu aplikacji: com.google.examples.map-with-marker.
• Upewnij się, że masz dobre połączenie z siecią Wi-Fi lub GPS.
• Użyj narzędzi do debugowania Xcode, aby wyświetlać logi i debugować aplikację.

Zrozumienie kodu

1. Utwórz mapę i ustaw ją jako widok w usłudze viewDidLoad().

   Swift

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
   let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
   view = mapView
         

   Objective-C

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                           longitude:151.20
                                                                zoom:6.0];
   GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
   self.view = mapView;
         

2. Dodaj znacznik do mapy w usłudze viewDidLoad().

   Swift

   // Creates a marker in the center of the map.
   let marker = GMSMarker()
   marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
   marker.title = "Sydney"
   marker.snippet = "Australia"
   marker.map = mapView
         

   Objective-C

   // Creates a marker in the center of the map.
   GMSMarker *marker = [[GMSMarker alloc] init];
   marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
   marker.title = @"Sydney";
   marker.snippet = @"Australia";
   marker.map = mapView;
         

Domyślnie pakiet Maps SDK na iOS wyświetla zawartość okna informacyjnego, gdy użytkownik kliknie znacznik. Jeśli chcesz korzystać z działania domyślnego, nie musisz dodawać detektora kliknięć znacznika.

Gratulacje! Masz aplikację na iOS, która wyświetla mapę Google ze znacznikiem wskazującym konkretną lokalizację. Wiesz już, jak korzystać z pakietu SDK Maps na iOS.

Dalsze kroki

Dowiedz się więcej o obiekcie mapy i o tym, co możesz zrobić ze znacznikami.