Usa le API Places e la geocodifica con stili basati sui dati per i confini

Seleziona la piattaforma: Android iOS JavaScript

Puoi utilizzare l'API Places e l'API Geocoding nell'API Maps JavaScript per cercare regioni e ottenere maggiori informazioni su luoghi. L'API Geocoding e l'API Places sono alternative efficaci e stabili per ottenere gli ID luogo. Se utilizzi già gli ID luogo, puoi riutilizzarli facilmente con gli stili basati sui dati per i confini.

Aggiungi Places e Geocoding alle tue app API Maps JavaScript nei modi seguenti:

• API Places Library, Maps JavaScript, consente alla tua app di cercare luoghi e include un widget di completamento automatico.
• L'API Places restituisce informazioni sui luoghi utilizzando richieste HTTP.
• Il servizio di geocodifica e la classe Geocoder possono eseguire la geocodifica e la geocodifica inversa in modo dinamico in base all'input dell'utente.
• L'API Geocoding ti consente di geocodificare indirizzi statici noti.

Nota: l'API Geocoding, l'API Places e l'API Places (nuova) (per la Ricerca di testo (nuova)) devono essere attivate e vengono fatturate separatamente dall'API Maps JavaScript.

Utilizzare l'API Places

Usare la ricerca di testo (novità) per trovare una regione

Puoi utilizzare la ricerca di testo (nuova) per ottenere un ID luogo che includa i dati della regione utilizzando includedType per specificare il tipo di regione da restituire. L'utilizzo dell'API Text Search (nuova) per richiedere solo ID luogo non comporta alcun costo. Scopri di più.

Questa mappa di esempio mostra come effettuare una richiesta searchByText per ottenere l'ID luogo di Trinidad, in California, e poi applicare lo stile al confine:

TypeScript

async function findBoundary() {
    const request = {
        query: 'Trinidad, CA',
        fields: ['id', 'location'],
        includedType: 'locality',
        locationBias: center,
    };

    const { Place } = await google.maps.importLibrary("places") as google.maps.PlacesLibrary;
    //@ts-ignore
    const { places } = await Place.searchByText(request);

    if (places.length) {
        const place = places[0];
        styleBoundary(place.id);
        map.setCenter(place.location);
    } else {
        console.log('No results');
    }
}

function styleBoundary(placeid) {
    // Define a style of transparent purple with opaque stroke.
    const styleFill = {
        strokeColor: '#810FCB',
        strokeOpacity: 1.0,
        strokeWeight: 3.0,
        fillColor: '#810FCB',
        fillOpacity: 0.5
    };

    // Define the feature style function.
    featureLayer.style = (params) => {
        if (params.feature.placeId == placeid) {
            return styleFill;
        }
    };
}
index.ts

Nota: leggi la guida sull'utilizzo di TypeScript e Google Maps.

JavaScript

async function findBoundary() {
  const request = {
    query: "Trinidad, CA",
    fields: ["id", "location"],
    includedType: "locality",
    locationBias: center,
  };
  const { Place } = await google.maps.importLibrary("places");
  //@ts-ignore
  const { places } = await Place.searchByText(request);

  if (places.length) {
    const place = places[0];

    styleBoundary(place.id);
    map.setCenter(place.location);
  } else {
    console.log("No results");
  }
}

function styleBoundary(placeid) {
  // Define a style of transparent purple with opaque stroke.
  const styleFill = {
    strokeColor: "#810FCB",
    strokeOpacity: 1.0,
    strokeWeight: 3.0,
    fillColor: "#810FCB",
    fillOpacity: 0.5,
  };

  // Define the feature style function.
  featureLayer.style = (params) => {
    if (params.feature.placeId == placeid) {
      return styleFill;
    }
  };
}
index.js

Visualizza il codice sorgente completo dell'esempio

TypeScript

let map;
let featureLayer;
let center;

async function initMap() {
    const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;

    center = {lat: 41.059, lng: -124.151}; // Trinidad, CA

    map = new Map(document.getElementById('map') as HTMLElement, {
        center: center,
        zoom: 15,
        // In the cloud console, configure this Map ID with a style that enables the
        // "Locality" Data Driven Styling type.
        mapId: 'a3efe1c035bad51b', // <YOUR_MAP_ID_HERE>,
    });

    featureLayer = map.getFeatureLayer('LOCALITY');

    findBoundary();
}
async function findBoundary() {
    const request = {
        query: 'Trinidad, CA',
        fields: ['id', 'location'],
        includedType: 'locality',
        locationBias: center,
    };

    const { Place } = await google.maps.importLibrary("places") as google.maps.PlacesLibrary;
    //@ts-ignore
    const { places } = await Place.searchByText(request);

    if (places.length) {
        const place = places[0];
        styleBoundary(place.id);
        map.setCenter(place.location);
    } else {
        console.log('No results');
    }
}

function styleBoundary(placeid) {
    // Define a style of transparent purple with opaque stroke.
    const styleFill = {
        strokeColor: '#810FCB',
        strokeOpacity: 1.0,
        strokeWeight: 3.0,
        fillColor: '#810FCB',
        fillOpacity: 0.5
    };

    // Define the feature style function.
    featureLayer.style = (params) => {
        if (params.feature.placeId == placeid) {
            return styleFill;
        }
    };
}
initMap();
index.ts

Nota: leggi la guida sull'utilizzo di TypeScript e Google Maps.

JavaScript

let map;
let featureLayer;
let center;

async function initMap() {
  const { Map } = await google.maps.importLibrary("maps");

  center = { lat: 41.059, lng: -124.151 }; // Trinidad, CA
  map = new Map(document.getElementById("map"), {
    center: center,
    zoom: 15,
    // In the cloud console, configure this Map ID with a style that enables the
    // "Locality" Data Driven Styling type.
    mapId: "a3efe1c035bad51b", // <YOUR_MAP_ID_HERE>,
  });
  featureLayer = map.getFeatureLayer("LOCALITY");
  findBoundary();
}

async function findBoundary() {
  const request = {
    query: "Trinidad, CA",
    fields: ["id", "location"],
    includedType: "locality",
    locationBias: center,
  };
  const { Place } = await google.maps.importLibrary("places");
  //@ts-ignore
  const { places } = await Place.searchByText(request);

  if (places.length) {
    const place = places[0];

    styleBoundary(place.id);
    map.setCenter(place.location);
  } else {
    console.log("No results");
  }
}

function styleBoundary(placeid) {
  // Define a style of transparent purple with opaque stroke.
  const styleFill = {
    strokeColor: "#810FCB",
    strokeOpacity: 1.0,
    strokeWeight: 3.0,
    fillColor: "#810FCB",
    fillOpacity: 0.5,
  };

  // Define the feature style function.
  featureLayer.style = (params) => {
    if (params.feature.placeId == placeid) {
      return styleFill;
    }
  };
}

initMap();
index.js

Nota: durante la release di anteprima, puoi eseguire un massimo di 10 query al secondo per progetto. Scopri di più.

Utilizzare il completamento automatico di Places per trovare le regioni

Il widget di completamento automatico di Places offre un modo pratico per consentire agli utenti di cercare regioni. Per configurare il widget di completamento automatico dei luoghi in modo che restituisca solo le regioni, imposta types su (regions), come mostrato nel seguente snippet:

// Set up the Autocomplete widget to return only region results.
const autocompleteOptions = {
  fields: ["place_id", "type"],
  strictBounds: false,
  types: ["(regions)"],
};

Visualizzare i dettagli di un luogo per una regione

I dati dei dettagli dei luoghi per una regione possono essere molto utili. Ad esempio, puoi:

• Cerca gli ID dei luoghi di confine in base ai nomi dei luoghi.
• Ottieni l'area visibile per lo zoom fino a un confine.
• Recupera il tipo di elemento per il confine (ad esempio locality).
• Ricevi l'indirizzo formattato, che si risolve in "Nome del luogo, Stato, Paese" nella regione degli Stati Uniti (ad esempio, "Ottumwa, IA, USA").
• Ricevi altri dati utili, come le foto.

La seguente funzione di esempio trova il confine di Trinidad, in California, e centra la mappa sul risultato:

La funzione di esempio seguente chiama fetchFields() per ottenere i dettagli dei luoghi, tra cui place.geometry.viewport, quindi chiama map.fitBounds() per centrare la mappa sul poligono di confine selezionato.

    async function getPlaceDetails(placeId) {
        // Use place ID to create a new Place instance.
        const place = new google.maps.places.Place({
            id: placeId,
        });

        // Call fetchFields, passing the desired data fields.
        await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'geometry', 'type'] });

        // Zoom to the boundary polygon.
        let viewport = place.geometry.viewport;
        map.fitBounds(viewport, 155);

        // Print some place details to the console.
        const types = place.types;
        console.log("Feature type: " + types[0]);
        console.log("Formatted address: " + place.formattedAddress);
    }

Utilizzare l'API Geocoding

L'API Geocoding ti consente di convertire gli indirizzi in coordinate geografiche e viceversa. I seguenti utilizzi si combinano bene con gli stili basati sui dati per i confini:

• Utilizza la geocodifica per ottenere l'area visibile di una regione.
• Applica il filtro dei componenti alla chiamata di geocodifica per ottenere gli ID luogo per le aree amministrative 1-4, la località o il codice postale.
• Utilizza la geocodifica inversa per trovare gli ID luogo in base alle coordinate di latitudine/longitudine o persino per restituire gli ID luogo di tutti i componenti in una determinata località.

Ottenere l'area visibile per una regione

Il servizio di geocodifica può accettare un ID luogo e restituire un'area visibile, che puoi passare alla funzione map.fitBounds() per eseguire lo zoom su un poligono di confine sulla mappa. L'esempio seguente mostra come utilizzare il servizio di geocodifica per ottenere un viewport e poi chiamare map.fitBounds():

// Set up the geocoder.
geocoder = new google.maps.Geocoder();

...

// Call Geocoding API and zoom to the resulting bounds.
function zoomToPolygon(placeid) {
    geocoder
        .geocode({ placeId: placeid })
        .then(({ results }) => {
            map.fitBounds(results[0].geometry.viewport, 155);
        })
        .catch((e) => {
            console.log('Geocoder failed due to: ' + e)
        });
}

Utilizzare la geocodifica inversa

La geocodifica inversa può essere utilizzata per trovare gli ID luogo. L'esempio seguente della funzione servizio di geocodifica restituisce gli ID luogo per tutti i componenti dell'indirizzo alle coordinate di latitudine/longitudine specificate:

// Set up the geocoder.
geocoder = new google.maps.Geocoder();

...

// Call Geocoding API.
function getPlaceIds(latLng) {
    geocoder
        .geocode({ latLng })
        .then(({ results }) => {
            console.log('Geocoding result:');
            console.log(results[0]);
            console.log(results[0].place_id);
            console.log(results[0].address_components);
        })
        .catch((e) => {
            console.log('Geocoder failed due to: ' + e)
        });
}

Questa è la chiamata al servizio web di geocodifica inversa equivalente:

https://maps.googleapis.com/maps/api/geocode/json?key="YOUR_API_KEY"&latlng=41.864182,-87.676930

Per utilizzare il geocodifica inversa con il filtro dei componenti per ottenere il componente dell'indirizzo per uno o più dei seguenti tipi nella località specificata:

• administrativeArea
• country
• locality
• postalCode

La funzione di esempio seguente mostra l'utilizzo del servizio di geocodifica, l'aggiunta di limitazioni dei componenti con il geocodifica inversa per ottenere tutti i componenti dell'indirizzo nella località specificata solo per il tipo locality:

// Set up the geocoder.
geocoder = new google.maps.Geocoder();

...

function getPlaceIdWithRestrictions(latLng) {
    geocoder
        .geocode({ latLng,
            componentRestrictions: {
              country: "US",
              locality: "chicago",
            },
        })
        .then(({ results }) => {
            console.log('Geocoding result with restriction:');
            console.log(results[0]);
            console.log(results[0].place_id);
            console.log(results[0].address_components);
            console.log(results[0].address_components[1].types[0]);
            console.log(results[0].address_components[1].long_name);
        })
        .catch((e) => {
            console.log('getPlaceId Geocoder failed due to: ' + e)
        });
}

Questa è la chiamata al servizio web di geocodifica inversa equivalente:

https://maps.googleapis.com/maps/api/geocode/json?key="YOUR_API_KEY"&latlng=41.864182,-87.676930&result_type=locality