Ta strona zawiera szczegółowe informacje o kodach SKU, identyfikatorach SKU, zdarzeniach podlegających rozliczeniu i regułach rozliczeniowych dotyczących kodów SKU interfejsów Legacy Places API, Legacy Directions API i Legacy Distance Matrix API. Informacje o aktualnych wersjach tych usług znajdziesz w artykułach Szczegóły kodów SKU Miejsc (nowych) oraz Szczegóły kodów SKU tras i nawigacji. Katalog wszystkich kategorii usług znajdziesz w omówieniu szczegółów korzystania z interfejsu API.
Informacje o tabelach kodów SKU
W sekcjach poniżej znajdziesz szczegółowe informacje o każdym kodzie SKU:
| Kategoria | Czy kod SKU należy do kategorii Essentials, Pro czy Enterprise. |
| Zdarzenie podlegające rozliczeniu | Zdarzenie, za które naliczana jest opłata w przypadku danego SKU. |
| Aktywatory | które elementy kodu wywołują zdarzenia podlegające opłacie; |
| Ceny | Linki do tabeli cen dla grupy tego kodu SKU. |
Starsze kody SKU usługi Places
Najnowsze wersje znajdziesz w artykule Kody SKU usługi Miejsca (nowa wersja).
Informacje o kodach SKU danych o miejscach
3 SKU danych o miejscach to: Dane podstawowe, Dane kontaktowe i Dane o atmosferze.Co najmniej 1 kod SKU danych został aktywowany dla:
- Android: każde żądanie do
fetchPlace()lubfindCurrentPlace(). - iOS: każde wywołanie
fetchPlaceFromPlaceID:lubfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:. - Usługa internetowa: każde żądanie dotyczące miejsc w zależności od pól określonych w żądaniu.
Opłaty za kody SKU danych są zawsze naliczane oprócz podstawowego kodu SKU za żądanie, które je wywołuje. Na przykład żądanie informacji o miejscu zawierające pola danych podstawowych zostanie rozliczone zarówno w ramach kodu SKU danych podstawowych, jak i kodu SKU informacji o miejscu.
W przypadku usługi internetowej te żądania do interfejsu Places API umożliwiają określenie pól danych, które mają zostać zwrócone:
W przypadku usługi internetowej te wywołania interfejsów Places API NIE obsługują określania zwracanych pól. Te wywołania zawsze zwracają wszystkie dane o miejscach, co powoduje naliczenie opłat za 3 SKU danych o miejscach oprócz opłaty za każde żądanie do interfejsu API:
[ Essentials: Places Legacy ] |
|---|
SKU: Autocomplete – Per Request
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
7384-2DE4-D388 (globalny) 2164-BC00-53DC (Indie) |
|
| Interfejsy API | Autouzupełnianie miejsc (starsza wersja) na Androidzie, Autouzupełnianie miejsc (starsza wersja) na iOS, Autouzupełnianie miejsc (starsza wersja) w internecie |
|
| Zdarzenie podlegające rozliczeniu | Żądanie, które nie zawiera tokena sesji | |
| Aktywatory |
|
|
| Przykłady | Jeśli wyślesz żądanie z nieprawidłowej sesji autouzupełniania (np. sesji, która ponownie używa tokena sesji), zostanie naliczona opłata za SKU Autouzupełnianie – za żądanie. Żądania autouzupełniania z widżetu autouzupełniania miejsc w Maps JavaScript API mogą być rozliczane według SKU Autouzupełnianie – za żądanie, jeśli wysyłasz żądania z nieprawidłowej sesji autouzupełniania. Taka sytuacja może wystąpić, gdy użytkownik wpisuje lub kopiuje i wkleja do widżetu wiele różnych adresów i nie zawsze wybiera podpowiedź autouzupełniania. |
|
| Ceny |
Cennik (globalny) Cennik (Indie) |
SKU: Autocomplete (included with Place Details) – Per Session
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
E9C9-934B-DDB1 (cały świat) |
|
| Interfejsy API | Autouzupełnianie miejsc (starsza wersja) na Androidzie, Autouzupełnianie miejsc (starsza wersja) na iOS, Autouzupełnianie miejsc (starsza wersja) w internecie |
|
| Zdarzenie podlegające rozliczeniu | Sesja | |
| Aktywatory |
Pola w żądaniu: Aby uniknąć niepotrzebnych opłat, w żądaniu podaj pola, których potrzebujesz. W zależności od tego, jakie pola określisz, żądanie informacji o miejscu może też generować te kody SKU danych:
Jeśli w żądaniu informacji o miejscu nie określisz pól, zostaną aktywowane wszystkie kody SKU danych. Jeśli podczas sesji autouzupełniania poprosisz tylko o odświeżenie identyfikatora informacji o miejscu (Twoje żądanie określa tylko pole |
|
| Przykłady |
Żądania autouzupełniania są dostępne bezpłatnie. Ten starszy kod SKU jest rozliczany, gdy poprosisz o kolejne informacje o miejscu na podstawie standardowych cen informacji o miejscu. Ten przykład ilustruje serię żądań według platformy, które spowodują wyświetlenie tych kodów SKU na rachunku, gdy wyświetlisz rachunek według kodów SKU:
Przykładowe żądanie według platformy: Prośby z urządzeń z Androidem
Żądania z urządzeń z iOS
Zapytania o usługi internetowe
Autouzupełnianie miejsc – żądanie (dane wejściowe="par", token sesji: XYZ) |
|
| Ceny |
Cennik (globalny) Cennik (Indie) |
Sesje autouzupełniania
Sesja autouzupełniania obejmuje kilka żądań autouzupełniania (w celu pobrania sugestii dotyczących miejsca podczas wpisywania tekstu przez użytkownika) i co najwyżej 1 żądanie informacji o miejscu (w celu pobrania szczegółów miejsca wybranego przez użytkownika). Ten sam token sesji jest przekazywany do autouzupełniania i kolejnego żądania informacji o miejscu. Sesja rozpoczyna się od pierwszego żądania autouzupełniania (które zwykle występuje, gdy użytkownik zaczyna pisać). Wywołanie informacji o miejscu jest wykonywane, gdy użytkownik wybierze jedną z sugestii autouzupełniania. Jeśli użytkownik nie wybierze sugestii, wywołanie informacji o miejscu nie zostanie wykonane.
Gdy użytkownik wybierze miejsce (czyli po wywołaniu informacji o miejscu), musisz rozpocząć nową sesję, używając nowego tokena sesji.
Sesje autouzupełniania mogą być generowane przez te interfejsy API:
- usługa autouzupełniania miejsc w interfejsie Places API lub usługa autouzupełniania miejsc w interfejsie Maps JavaScript API. Musisz zaprojektować aplikację tak, aby udostępniała tokeny sesji (może być konieczna zmiana dotychczasowego kodu).
- Widżet autouzupełniania Maps JavaScript API. Płatności oparte na sesjach są automatycznie włączane w tych widżetach bez konieczności wprowadzania zmian w kodzie.
Token sesji jest ważny przez jedną sesję użytkownika i nie powinien być używany w przypadku więcej niż jednej sesji użytkownika. Jeśli użyjesz ponownie tokena sesji, sesja zostanie uznana za nieprawidłową, a żądania zostaną rozliczone tak, jakby nie podano tokena sesji.
Żądania autouzupełniania i żądania informacji o miejscu korzystające z sesji są rozliczane na podstawie różnych kodów SKU.
SKU: dane podstawowe
SKU danych, który rozlicza pola Podstawowe dane w żądaniu Szczegóły miejsca lub Znajdź miejsce.
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
75D4-C522-326B (cały świat) 5D7B-1F7B-395E (Indie) |
|
| Interfejsy API |
Informacje o miejscu (starsza wersja) z polami podstawowymi
Znajdź miejsce (starsza wersja) z polami podstawowymi |
|
| Zdarzenie podlegające rozliczeniu | Żądanie dotyczące pól danych podstawowych zostało zrealizowane | |
| Aktywatory |
Pola dotyczące pakietu Android SDK
Pola na iOS
Pola usługi internetowej
|
|
| Płatności za maskę pola |
Żądanie jest rozliczane na podstawie pól podanych w masce pola. Na przykład:
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Find Place – ID only
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
44A2-D839-A3AC (globalny) FE05-60A4-CDDF (Indie) |
|
| Interfejsy API | Znajdowanie miejsca w usłudze internetowej Places | |
| Zdarzenie podlegające rozliczeniu | Prośba o place_id została zrealizowana |
|
| Aktywatory | Znajdź miejsce bez określonych pól lub tylko z polem place_id: FindPlace(fields: place_id). |
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Place Details – ID Refresh
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
2D88-4302-6299 (cały świat) 4604-F56B-7086 (Indie) |
|
| Interfejsy API | Informacje o miejscu (starsza wersja) | |
| Zdarzenie podlegające rozliczeniu | Udane żądanie dotyczące tylko pól identyfikatora | |
| Aktywatory | Żądanie zawierające tylko pole identyfikator miejsca: getPlaceDetails(fields: place_id). |
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Autouzupełnianie zapytania – za żądanie
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
C4B1-8805-63EF (cały świat) 59E9-EB83-5CA3 (Indie) |
|
| Interfejsy API | Usługa autouzupełniania zapytania | |
| Zdarzenie podlegające rozliczeniu | Prośba została zrealizowana | |
| Aktywatory |
Ceny za sesję autouzupełniania nie są obsługiwane w przypadku autouzupełniania zapytania. Kolejne żądania informacji o miejscu są rozliczane na podstawie kodu SKU Informacje o miejscu Pro. |
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
[ Pro: Places Legacy ] |
|---|
SKU: Autouzupełnianie bez informacji o miejscu – na sesję
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
B52C-8320-6DC5 (globalny) C625-D3CE-DF37 (Indie) |
|
| Interfejsy API | Autouzupełnianie miejsc (starsza wersja) na Androidzie, Autouzupełnianie miejsc (starsza wersja) na iOS, Autouzupełnianie miejsc (starsza wersja) w internecie |
|
| Zdarzenie podlegające rozliczeniu | Sesja | |
| Aktywatory |
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Find Current Place
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
7218-264C-D1D7 (cały świat) 0862-F46E-1A1A (Indie) |
|
| Interfejsy API | Places SDK for Android, Places SDK for iOS |
|
| Zdarzenie podlegające rozliczeniu | Prośba została zrealizowana | |
| Aktywatory |
|
|
| Przykłady |
Poniższe przykłady pokazują, za które kody SKU naliczane są opłaty, gdy wysyłasz żądanie Znajdź aktualne miejsce i określasz pola z kodów SKU danych Podstawowe, Kontakt i Atmosfera. Aby zobaczyć kody SKU na rachunku, wyświetl rachunek według kodów SKU zgodnie z opisem w artykule Analizowanie wykorzystania i kosztów według kodów SKU. Wysyłasz żądanie Znajdź aktualne miejsce, podając tylko pole
Na rachunku widoczne są te kody SKU:
Wysyłasz żądanie Znajdź aktualne miejsce, podając tylko pole
Na rachunku widoczne są te kody SKU:
Wysyłasz żądanie Znajdź aktualne miejsce ze wszystkimi 3 polami typu danych:
Na rachunku widoczne są te kody SKU:
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Find Place
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
DC67-3188-2294 (cały świat) ECB4-087C-9A27 (Indie) |
|
| Interfejsy API | Find Place (starsza wersja) | |
| Zdarzenie podlegające rozliczeniu | Prośba o więcej niż tylko pole identyfikatora została zrealizowana | |
| Aktywatory | Żądanie Find Place z określonym polem ID i innymi polami. | |
| Przykłady |
Poniższe przykłady pokazują, za które kody SKU naliczane są opłaty, gdy wysyłasz żądanie Znajdź aktualne miejsce i określasz pola z kodów SKU danych Podstawowe, Kontakt i Atmosfera. Aby zobaczyć kody SKU na rachunku, wyświetl rachunek według kodów SKU zgodnie z opisem w artykule Analizowanie wykorzystania i kosztów według kodów SKU. Wysyłasz żądanie Find Place, podając tylko pole
Na rachunku widoczne są te kody SKU:
Wysyłasz żądanie Find Place, podając tylko pole
Na rachunku widoczne są te kody SKU:
Wysyłasz żądanie Find Place ze wszystkimi 3 polami typu danych:
Na rachunku widoczne są te kody SKU:
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Places – Nearby Search
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
6B23-8A17-D29D (cały świat) CC66-BE0E-2477 (Indie) |
|
| Interfejsy API | Wyszukiwanie w pobliżu (starsza wersja) | |
| Zdarzenie podlegające rozliczeniu | Prośba o funkcje Pro została zrealizowana | |
| Aktywatory |
To żądanie nie obsługuje określania, które pola mają zostać zwrócone. Odpowiedź zwraca listę miejsc i podzbiór obsługiwanych pól danych. |
|
| Przykłady |
Wysyłasz żądanie wyszukiwania w pobliżu, np.
|
|
| Ceny |
Cennik (globalny) Cennik (Indie) |
SKU: Places – Text Search
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
E95A-86C7-7F47 (cały świat) 102E-888D-5596 (Indie) |
|
| Interfejsy API | Wyszukaj tekst (starsza wersja) | |
| Zdarzenie podlegające rozliczeniu | Udane żądanie do Wyszukaj tekst (starsza wersja) | |
| Aktywatory |
Żądania wyszukiwania tekstowego zwracają listę miejsc, ale nie obsługują określania, które pola mają być zwracane. Żądania wyszukiwania tekstowego zwracają podzbiór obsługiwanych pól danych. Opłata zostanie naliczona za żądanie wyszukiwania tekstowego oraz za wszystkie kody SKU typów danych: Dane podstawowe, Dane kontaktowe i Dane o atmosferze.
SKU: Places – Wyszukaj tekst jest też wywoływany przez metodę
|
|
| Przykłady |
Jeśli wyślesz żądanie wyszukiwania tekstowego (starsza wersja), na rachunku pojawią się te kody SKU, gdy wyświetlisz rachunek według kodów SKU:
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: informacje o miejscu
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
FC5C-DF28-543F (cały świat) F7AA-FEF9-C90E (Indie) |
|
| Interfejsy API | Informacje o miejscu (starsza wersja) | |
| Zdarzenie podlegające rozliczeniu | Prośba o funkcje Pro została zrealizowana | |
| Aktywatory |
W przypadku internetowego interfejsu API i usług opłata za SKU Informacje o miejscu jest naliczana niezależnie od tego, czy podasz token sesji. |
|
| Przykłady |
|
|
| Ceny |
Cennik (globalny) Cennik (Indie) |
[ Enterprise: Places Legacy ] |
|---|
SKU: dane dotyczące atmosfery
SKU danych, który rozlicza pola danych o atmosferze w żądaniu Szczegóły miejsca lub Znajdź miejsce.
| Kategoria | Enterprise | |
|---|---|---|
| Identyfikator SKU |
D63D-5CC5-302A (cały świat) 0CE0-1963-137E (Indie) |
|
| Interfejsy API |
Informacje o miejscu (starsza wersja) z polami dotyczącymi atmosfery
Find Place (starsza wersja) z polami dotyczącymi atmosfery |
|
| Zdarzenie podlegające rozliczeniu | Udane żądanie dotyczące pól danych Atmosphere | |
| Aktywatory | ||
| Przykłady rozliczeń masek pól |
Żądanie jest rozliczane na podstawie pól podanych w masce pola. Na przykład:
|
|
| Ceny | Cennik (globalny) Cennik (Indie) |
SKU: dane kontaktowe
SKU danych, który rozlicza pola Dane kontaktowe w żądaniu Szczegóły miejsca lub Znajdź miejsce.
| Kategoria | Enterprise | |
|---|---|---|
| Identyfikator SKU |
F095-CD01-81B2 (globalny) A03F-5079-C66C (Indie) |
|
| Interfejsy API |
Informacje o miejscu (starsza wersja) z polami kontaktowymi
Find Place (starsza wersja) z polami kontaktowymi |
|
| Zdarzenie podlegające rozliczeniu | Udane żądanie dotyczące pól danych kontaktowych | |
| Aktywatory |
Pola dotyczące pakietu Android SDK
Pola pakietu SDK na iOS
Pola usługi internetowej
|
|
| Płatności za maskę pola |
Żądanie jest rozliczane na podstawie pól podanych w masce pola. Na przykład:
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Places Photo
| Kategoria | Enterprise | |
|---|---|---|
| Identyfikator SKU |
81E7-85D0-58A7 (Global) 9F4B-2E19-1B63 (Indie) |
|
| Interfejsy API | Places Photo (starsza wersja) | |
| Zdarzenie podlegające rozliczeniu | Prośba o zdjęcie została zrealizowana | |
| Aktywatory |
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
Jednostki SKU starszej wersji interfejsu Routes API
[ Essentials: Routes Legacy ] |
|---|
SKU: Directions
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
28A8-3EB4-4595 (globalny) 4714-291C-3199 (Indie) |
|
| Interfejsy API | Directions Service w Maps JavaScript API, Directions API (starsza wersja) |
|
| Zdarzenie podlegające rozliczeniu | Żądanie zakończone powodzeniem bez funkcji Pro lub Enterprise | |
| Aktywatory | Zapytania, które nie powodują wyświetlenia SKU o wyższej ocenie | |
| Ceny |
Cennik (globalny) Cennik (Indie) |
SKU: Distance Matrix
| Kategoria | Essentials | |
|---|---|---|
| Identyfikator SKU |
C1B6-FF9D-7700 (globalny) 558A-4F88-F361 (Indie) |
|
| Interfejsy API | Distance Matrix API (starsza wersja), Usługa Distance Matrix w Maps JavaScript API |
|
| Zdarzenie podlegające rozliczeniu | Każdy element, który nie zawiera funkcji Pro ani Enterprise. Każde żądanie wysłane do interfejsu Distance Matrix API generuje elementy, których liczba jest równa liczbie origins pomnożonej przez liczbę destinations. |
|
| Aktywatory | Żądania elementów, które nie powodują uruchomienia droższych kodów SKU | |
| Ceny |
Cennik (globalny)
Cennik (Indie) |
[ Pro: Routes Legacy ] |
|---|
SKU: Directions Advanced
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
9407-00C2-CF85 (cały świat) E27B-BD57-FD7D (Indie) |
|
| Interfejsy API | Directions Service w Maps JavaScript API, Directions API (starsza wersja) |
|
| Zdarzenie podlegające rozliczeniu | Prośba o dostęp do funkcji Pro została zaakceptowana | |
| Aktywatory |
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
SKU: Distance Matrix Advanced
| Kategoria | Pro | |
|---|---|---|
| Identyfikator SKU |
DFAE-763F-CF6E (cały świat) C0F4-32AE-F6D1 (Indie) |
|
| Interfejsy API | Distance Matrix API (starsza wersja), Usługa Distance Matrix w Maps JavaScript API |
|
| Zdarzenie podlegające rozliczeniu | Każdy element zwrócony z funkcjami Pro. Każde żądanie wysłane do interfejsu Distance Matrix API generuje elementy, których liczba jest równa liczbie origins pomnożonej przez liczbę destinations. |
|
| Aktywatory |
|
|
| Ceny |
Cennik (globalny)
Cennik (Indie) |
Powiązane strony z informacjami o kodach SKU
- Szczegółowe informacje o korzystaniu z interfejsu API: pełny katalog kodów SKU uporządkowany według poziomów Essentials, Pro, Enterprise i starszych.
- Szczegóły kodów SKU Map: kody SKU Maps SDK na Androida, Maps SDK na iOS, Maps JavaScript API, Maps Embed API, Maps Static API, Street View Static API, Elevation API, Aerial View API i Map Tiles API.
- Szczegóły kodów SKU tras: kody SKU interfejsów Routes API, Route Optimization API, Roads API i pakietu Navigation SDK.
- Szczegóły kodów SKU Miejsc (nowych): kody SKU Places API (nowego), Places UI Kit, Places Aggregate API, Address Validation API, Geocoding API, Geolocation API, Time Zone API i Maps Grounding Lite.
- Szczegóły kodów SKU środowiska: kody SKU interfejsów Air Quality API, Pollen API, Solar API i Weather API.
- Ceny Google Maps Platform i ceny w Indiach: miesięczne poziomy wykorzystania i stawki za zdarzenie.