Zasady dotyczące interfejsu Maps JavaScript API

W tym temacie przedstawiamy wymagania dotyczące atrybucji we wszystkich aplikacjach opracowanych przy użyciu interfejsu Maps JavaScript API, w tym funkcji autouzupełniania miejsc usługi będącej częścią tego interfejsu API. Więcej warunków dotyczących Google Maps Platform znajdziesz zapoznaj się z Warunkami korzystania z usługi Google Maps Platform.

Udostępnianie warunków korzystania z usługi i polityki prywatności

Jeśli tworzysz aplikację Maps JavaScript API, musisz udostępnić Warunki oraz Prywatność Zasady dotyczące aplikacji który jest zgodny z wytycznymi zawartymi w Umowie z Google:

  • Warunki korzystania z usługi i Polityka prywatności muszą być dostępne publicznie i dostępności informacji.
  • W Warunkach korzystania z aplikacji musisz wyraźnie określić, podczas korzystania z aplikacji, użytkownicy są zobowiązani Warunki korzystania z usług Google Usługa.
  • Musisz powiadomić użytkowników w Polityce prywatności, że korzystasz interfejsów API Map Google i uwzględniać przez odniesienie Polityka prywatności Google.

Rekomendowane miejsce, w którym znajdziesz swoje Warunki korzystania z usługi i Polityka prywatności zależy od platformy aplikacji.

Aplikacja mobilna

Jeśli tworzysz aplikację mobilną, zalecamy podanie linku do Warunki korzystania z aplikacji i Polityka prywatności na stronie stronie pobierania w odpowiednim sklepie z aplikacjami oraz w ustawieniach aplikacji. .

Aplikacje internetowe

Jeśli tworzysz aplikację internetową, zalecamy podanie linku do Warunki korzystania z usługi i Politykę prywatności, które znajdziesz w stopce witryny.

Pobieranie z wyprzedzeniem, buforowanie lub przechowywanie treści

Aplikacje korzystające z interfejsu Maps JavaScript API są objęte warunkami Umowa z Google. Zgodnie z warunkami Umowy Użytkownik nie może pobierania z wyprzedzeniem, indeksowania, przechowywania ani buforowania jakiejkolwiek Treści, z wyjątkiem określonych w warunkach.

Pamiętaj, że identyfikator miejsca, używany do jednoznacznej identyfikacji miejsca, to nieobjęte ograniczeniami dotyczącymi buforowania. Identyfikator miejsca jest zwracany w polu „place_id” w Odpowiedzi interfejsu Maps JavaScript API. Więcej informacji o zapisywaniu i odświeżaniu identyfikatorów miejsc oraz zarządzaniu nimi znajdziesz w przewodniku na temat identyfikatorów miejsc.

Wyświetlanie wyników interfejsu Maps JavaScript API

Wyniki z interfejsu Maps JavaScript API możesz wyświetlać w Mapach Google lub bez mapy. Jeśli chcesz w celu wyświetlania na mapie wyników z interfejsu Maps JavaScript API, należy je wyświetlić w Mapach Google. Nie można używać danych interfejsu Maps JavaScript API na mapie, która nie jest mapą Google.

Jeśli aplikacja wyświetla dane na mapie Google, zostanie uwzględnione i nie można go zmieniać. Aplikacje, które wyświetlają dane Google na tym samym ekranie, co Mapa Google, nie są wymagane do dalszego przypisywania autorstwa Google.

Jeśli aplikacja wyświetla dane na stronie lub w widoku, które nie wyświetla także Mapę Google, wraz z tymi danymi należy wyświetlić logo Google. Przykład: jeśli aplikacja wyświetla dane Google na jednej karcie, a na Mapie Google z tymi danymi na innej, na pierwszej musi być widoczne logo Google. Jeśli aplikacja używa z autouzupełnianiem lub bez niego, logo musi być wyświetlane w tekście.

Logo Google powinno znajdować się w lewym dolnym rogu mapy wraz z informacją o źródle widoczne w prawym dolnym rogu. Oba te elementy powinny znajdować się na mapie przedstawiane w całości, a nie pod mapą czy innym miejscem w aplikacji. Na poniższej przykładowej mapie w lewym dolnym rogu znajduje się logo Google w prawym dolnym rogu.

miejsce docelowe atrybucji zasad

Poniższy plik ZIP zawiera logo Google w odpowiednim rozmiarze na komputerach oraz w aplikacjach na Androida i iOS. Nie możesz zmienić ich rozmiaru ani zmienić ich rozmiaru logo.

Pobierz: google_logo.zip

Nie modyfikuj atrybucji. Nie usuwaj, nie zasłaniaj ani nie wycinaj informacji o autorze i informacjami o nich. Nie można używać w tekście logo Google (na przykład „Te mapy są przeznaczone z [Google_logo]”).

Zadbaj o to, aby informacje o atrybucji były jak najbardziej trafne. Jeśli używasz zrzutów ekranu ze zdjęciami Google poza umieszczanie bezpośrednie, należy dołączyć standardowe źródło w takiej postaci, w jakiej jest widoczne na obrazie. W razie potrzeby: możesz dostosować styl i położenie tekstu źródła, o ile znajdować się w pobliżu treści i być czytelne dla przeciętnego widza lub czytelnika. Nie można przenosić informacji o pochodzeniu danych poza treść, na przykład na koniec książki, informacje o autorach plików lub programu albo stopkę witryny.

Uwzględnij zewnętrznych dostawców danych. Niektóre dane i zdjęcia na mapach produkty pochodzą od dostawców innych niż Google. W przypadku korzystania z takich zdjęć tekst źródło danych musi zawierać nazwę „Google” oraz odpowiednich dostawców danych, takich jak „Dane map: Google, Maxar Technologies”. Gdy są cytowani zewnętrzni dostawcy danych ze zdjęciami, w tym tylko nazwa „Google” lub logo Google nie jest prawidłowym oznaczeniem.

Jeśli korzystasz z Google Maps Platform na urządzeniu, na którym wyświetlanie atrybucji nie jest praktyczne, skontaktuj się z zespołem sprzedaży Google, aby omówić licencje odpowiednie do Twojego zastosowania.

Inne wymagania dotyczące atrybucji

Wykonaj te instrukcje, aby pobrać dane o atrybucji od firm zewnętrznych i wyświetlić atrybucje w Twojej aplikacji.

Pobieranie informacji o autorze utworu

Jeśli Twoja aplikacja wyświetla opinie uzyskane za pomocą połączenia Place.fetchFields, aplikacja musi też wyświetlać informacje o zewnętrznych źródłach informacji o uzyskanych informacjach o miejscu.

Interfejs API zwraca Place. obiektu. Aby pobrać atrybucje z obiektu Place, użyj funkcji Place.attributions. , która jest zwracana w każdym żądaniu (nie trzeba jej określać za pomocą pól). właściwość zwraca List z String obiektów lub null, jeśli jest nie ma żadnych atrybucji do wyświetlenia. Poniższy przykładowy kod pokazuje dotarcie do miejsca oraz listę atrybucje.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

Wyświetl opinię

Obiekt Place może zawierać do 5 opinii, z których każda jest oznaczona symbolem Review obiekt. Opcjonalnie możesz wyświetlać te opinie w swojej aplikacji.

Przy wyświetlaniu opinii przesłanych przez użytkowników Google należy umieścić nazwisko autora w pobliżu w pobliżu. Jeśli jest to możliwe w polu atrybucji autora obiektu Review, zalecamy dołączenie zdjęcia autora i link do jego profilu. Następujący obraz Oto przykład opinii o parku:

Wyświetlanie informacji o autorze

Poniższy przykład pokazuje, jak znaleźć miejsce, sprawdzić opinie i wyświetlić dane z pierwsza opinia:

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen, Boston MA
  });

  // Call fetchFields, passing "reviews" and other needed fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }
  

Wyświetlanie informacji o autorze zdjęcia

Jeśli w aplikacji wyświetlają się zdjęcia, musisz podać informacje o autorze każdego zdjęcia, które je zawiera. Szczegółowe informacje o zdjęciu w obiekcie Place odpowiedzi znajdują się w kolekcji tablica photos. Aby dodać tablicę photos do odpowiedzi, dołącz do odpowiedzi photos pole danych w żądaniu.

Każdy element tablicy photos jest instancją Photo, która zawiera Tablica authorAttributions typu AuthorAttribution. Pola Obiekty AuthorAttribution są ciągami znaków zawierającymi displayName, uri i photoUri atrybucji lub pusty ciąg, jeśli nie ma żadnych atrybutów atrybucje do wyświetlenia.

Wytyczne dotyczące stylu na potrzeby atrybucji Google

Poniżej znajdziesz wskazówki dotyczące stylu atrybucji Google w CSS i HTML, jeśli nie możesz za pomocą dostępne do pobrania logo Google.

Pusty obszar

Wielkość pustego obszaru wokół logo powinna być równa wysokości lub większa. litery „G” w Google.

Odległość między tekstem informacji o źródle a logo Google powinna być o połowę szerokości literę „G”.

Czytelność

Podpis powinien zawsze być wyraźny i czytelny oraz pojawiać się w odpowiedniej wersji kolorystycznej danego kontekstu. Zawsze zadbaj o odpowiedni kontrast dla odmiany wybierz opcję.

Kolor

Użyj tekstu Google Material Gray 700 na białym lub jasnym tle o zakresie 0–40% maksymalny odcień czerni.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Na ciemniejszych tłach oraz na fotografiach i wzorach braku aktywności użyj białego tekstu do umieszczenia informacji o autorze o pochodzeniu danych.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Czcionka

Użyj instrukcji Czcionka Roboto.

Przykładowy arkusz CSS

Poniższy kod CSS zastosowany do tekstu „Google” wyrenderowałaby „Google” z odpowiednim czcionkę, kolor i odstępy na białym lub jasnym tle;

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;